Datenmodell in Schemata
In dieser Lektion modellieren Sie die Daten von Luma in Schemata. Dies ist eine der längsten Lektionen im Tutorial, also hol dir ein Glas Wasser und schnalle dich an!
Standardisierung und Interoperabilität sind Schlüsselkonzepte von Adobe Experience Platform. Das Experience-Datenmodell (XDM) ermöglicht die Standardisierung von Kundenerlebnisdaten und die Definition von Schemas für das Customer Experience Management.
XDM ist eine öffentlich dokumentierte Spezifikation, die die Leistungsfähigkeit digitaler Erlebnisse verbessern soll. Es stellt allgemeine Strukturen und Definitionen für jede Anwendung bereit, die für die Kommunikation mit Platform-Services verwendet werden soll. Durch die Einhaltung von XDM-Standards können alle Kundenerlebnisdaten in ein gemeinsames System integriert werden, wodurch Erkenntnisse schneller und besser integriert verfügbar werden. Sie können wertvolle Einblicke durch Kundenaktionen gewinnen, Zielgruppen mithilfe von Segmenten definieren und Kundenattribute zur Personalisierung verwenden.
XDM ist das zugrunde liegende System, auf Basis dessen Adobe Experience Cloud als Teil von Experience Platform die richtige Botschaft der richtigen Person zur richtigen Zeit auf dem passenden Kanal präsentieren kann. Die Methodik, auf der Experience Platform basiert (-System, nutzt Experience-Datenmodellschemata zur Verwendung durch Platform-Services.
Datenarchitekten müssen außerhalb dieses Tutorials Schemata erstellen, aber Dateningenieure arbeiten eng mit den Schemata zusammen, die vom Datenarchitekten erstellt wurden.
Bevor Sie mit den Übungen beginnen, sehen Sie sich dieses kurze Video an, um mehr über Schemata und das Experience-Datenmodell (XDM) zu erfahren:
Erforderliche Berechtigungen
In der Lektion Berechtigungen konfigurieren richten Sie alle Zugriffssteuerungen ein, die zum Abschließen dieser Lektion erforderlich sind.
Erstellen eines Treueschemas über die Benutzeroberfläche
In dieser Übung erstellen wir ein Schema für die Treuedaten von Luma.
-
Wechseln Sie zur Platform-Benutzeroberfläche und stellen Sie sicher, dass Ihre Sandbox ausgewählt ist.
-
Navigieren Sie linken Navigationsbereich zu Schemata“.
-
Klicken Sie oben rechts auf Schaltfläche Schema erstellen .
-
Wählen Sie im Workflow Schema erstellen Individuelles Profil als Basisklasse für Ihr Schema aus, da wir Attribute eines einzelnen Kunden modellieren werden (Punkte, Status usw.).
-
Klicken Sie auf Weiter.
-
Geben Sie
Luma Loyalty Schema
in das Textfeld Anzeigename des Schemas ein. Auf der Arbeitsfläche unten können Sie auch die Struktur des Basisschemas überprüfen und überprüfen, das von der ausgewählten Klasse bereitgestellt wird. -
Wählen Sie Beenden aus, um Ihr Schema zu erstellen.
Hinzufügen von Standardfeldgruppen
Nachdem das Schema erstellt wurde, werden Sie zum Schema-Editor weitergeleitet, in dem Sie dem Schema Felder hinzufügen können. Sie können einzelne Felder direkt zum Schema hinzufügen oder Feldergruppen verwenden. Beachten Sie, dass alle einzelnen Felder weiterhin mit einer Klasse oder Feldergruppe verknüpft sind. Sie können aus einer Vielzahl von Feldergruppen nach Branchenstandard wählen, die von Adobe bereitgestellt werden, oder eigene erstellen. Wenn Sie mit der Modellierung Ihrer eigenen Daten in Experience Platform beginnen, sollten Sie sich mit den von Adobe bereitgestellten branchenüblichen Feldergruppen vertraut machen. Wann immer möglich, ist es eine Best Practice, diese zu verwenden, da sie manchmal nachgelagerte Services unterstützen, z. B. Kunden-KI, Attributions-KI und Adobe Analytics.
Wenn Sie mit Ihren eigenen Daten arbeiten, besteht ein wichtiger Schritt darin zu bestimmen, welche Ihrer eigenen Daten in Platform erfasst und wie sie modelliert werden sollen. Dieses große Thema wird in der Wiedergabeliste (Modellieren Kundenerlebnisdaten mit XDM) ausführlicher. In diesem Tutorial werde ich Sie einfach durch die Implementierung einiger vordefinierter Schemata führen.
Hinzufügen von Feldergruppen:
-
Wählen Hinzufügen unter der Überschrift Feldergruppen aus.
-
Wählen im Modal " hinzufügen“ die folgenden Feldergruppen aus:
- Demografische Details für grundlegende Kundendaten wie Name und Geburtsdatum
- Persönliche Kontaktdaten für grundlegende Kontaktdaten wie E-Mail-Adresse und Telefonnummer
-
Sie können eine Vorschau der in der Feldergruppe bereitgestellten Felder anzeigen, indem Sie auf das Symbol rechts in der Zeile klicken.
-
Aktivieren Sie Kontrollkästchen Branche > Einzelhandel, um branchenspezifische Feldergruppen anzuzeigen.
-
Wählen Sie Treuedetails aus, um die Felder für das Treueprogramm hinzuzufügen.
-
Wählen Sie Feldergruppen hinzufügen aus, um alle drei Feldergruppen zum Schema hinzuzufügen.
Nehmen Sie sich nun etwas Zeit, um den aktuellen Status des Schemas zu untersuchen. Die Feldergruppen haben Standardfelder hinzugefügt, die sich auf eine Person, ihre Kontaktdaten und den Status des Treueprogramms beziehen. Diese beiden Feldergruppen sind möglicherweise nützlich, wenn Sie Schemata für die Daten Ihres eigenen Unternehmens erstellen. Wählen Sie eine bestimmte Feldergruppenzeile aus oder aktivieren Sie das Kontrollkästchen neben dem Namen der Feldergruppe, um zu sehen, wie sich die Visualisierung ändert.
Um das Schema zu speichern, klicken Sie auf Speichern.
Hinzufügen einer benutzerdefinierten Feldergruppe
Erstellen wir nun eine benutzerdefinierte Feldergruppe.
Während die Feldergruppe „Treueprogramm“ ein loyaltyID
enthält, möchte Luma alle Systemkennungen in einer einzigen Gruppe verwalten, um die Konsistenz ihrer Schemata sicherzustellen.
Feldergruppen müssen im Schema-Workflow erstellt werden. Sie haben folgende Möglichkeiten:
- Zuerst ein neues benutzerdefiniertes Feld zu Ihrem Schema hinzufügen und dann eine benutzerdefinierte Feldergruppe erstellen oder
- Erstellen Sie zunächst eine benutzerdefinierte Feldergruppe und fügen Sie ihr dann Felder hinzu.
In diesem Tutorial beginnen wir mit dem Erstellen einer benutzerdefinierten Feldergruppe.
So erstellen Sie die Feldergruppe:
- Wählen Hinzufügen unter der Überschrift Schemafeldgruppen aus
- Wählen Sie Neue Feldergruppe erstellen
- Verwenden Sie
Luma Identity profile field group
als Anzeigename - Verwenden von
system identifiers for XDM Individual Profile class
als Beschreibung - Wählen Sie Feldergruppen hinzufügen
Die neue, leere Feldergruppe wird Ihrem Schema hinzugefügt. Mit den Schaltflächen + können Sie neue Felder an einer beliebigen Stelle in der Hierarchie hinzufügen. In unserem Fall möchten wir Felder auf der Stammebene hinzufügen:
-
Klicken Sie auf + neben dem Namen des Schemas. Dadurch wird ein neues Feld unter dem Namespace Ihre Mandanten-ID hinzugefügt, um Konflikte zwischen Ihren benutzerdefinierten Feldern und Standardfeldern zu handhaben.
-
Fügen Sie in Seitenleiste Feldeigenschaften“ die Details des neuen Felds hinzu:
-
Feldname:
systemIdentifier
-
Anzeigename:
System Identifier
-
type: object
-
Wählen Sie im Feldergruppe die Feldergruppe Luma-Identitätsprofil aus, die wir erstellt haben.
-
Wählen Sie Übernehmen
-
Fügen Sie nun zwei Felder unter dem systemIdentifier
hinzu:
-
Erstes Feld
- Feldname:
loyaltyId
- Anzeigename:
Loyalty Id
- type: String
- Feldname:
-
Zweites Feld
- Feldname:
crmId
- Anzeigename:
CRM Id
- type: String
- Feldname:
Ihre neue Feldergruppe sollte wie folgt aussehen. Klicken Sie auf Speichern, um Ihr Schema zu speichern. Lassen Sie das Schema jedoch für die nächste Übung geöffnet.
Erstellen eines Datentyps
Feldergruppen, wie z. B. Ihre neue Luma Identity profile field group
, können in anderen Schemata wiederverwendet werden, sodass Sie Standarddatendefinitionen auf mehreren Systemen durchsetzen können. Sie können jedoch nur in Schemata , die eine gemeinsame Klasse, in diesem Fall die Klasse „XDM Individual Profile“, wiederverwendet werden.
Der Datentyp ist ein weiteres Konstrukt mit mehreren Feldern, das in Schemata (über Klassen hinweg) wiederverwendet kann. Konvertieren wir unser neues systemIdentifier
-Objekt in einen Datentyp:
Wählen Sie bei weiterhin geöffnetem Luma Loyalty Schema
das systemIdentifier
Objekt und dann In neuen Datentyp konvertieren
Wenn Sie Schema und zur Registerkarte Datentypen navigieren, sehen Sie den neu erstellten Datentyp. Wir werden diesen Datentyp später in der Lektion verwenden.
CRM-Schema über API erstellen
Jetzt erstellen wir ein Schema mit der -API.
- Verwenden der Klasse Individuelles Profil
- Benennen Sie ihn
Luma CRM Schema
- Verwenden Sie die folgenden Feldergruppen: Demografische Details, Persönliche Kontaktdaten und Luma-Identitätsprofilgruppe
Zunächst erstellen wir das leere Schema:
-
Postman öffnen
-
Wenn Sie kein Zugriffs-Token haben, öffnen Sie die Anfrage-OAuth: Request Access Token und wählen Sie Senden aus, um ein neues Zugriffs-Token anzufordern.
-
Öffnen Sie Ihre Umgebungsvariablen und ändern Sie den Wert von CONTAINER_ID von
global
intenant
. Denken Sie daran, dass Sietenant
immer dann verwenden müssen, wenn Sie mit Ihren eigenen benutzerdefinierten Elementen in Platform interagieren möchten, z. B. beim Erstellen eines Schemas. -
Wählen Sie Speichern
-
Schema Registry API > Schemas > Create a new custom schema. öffnen
-
Öffnen Sie die Registerkarte Hauptteil und fügen Sie den folgenden Code ein und wählen Sie Senden, um den API-Aufruf durchzuführen. Dieser Aufruf erstellt ein neues Schema mit derselben
XDM Individual Profile
-Basisklasse:code language-json { "type": "object", "title": "Luma CRM Schema", "description": "Schema for CRM data of Luma Retail ", "allOf": [{ "$ref": "https://ns.adobe.com/xdm/context/profile" }] }
note note NOTE Die Namespace-Verweise in diesem und in nachfolgenden Code-Beispielen (z. B. https://ns.adobe.com/xdm/context/profile
) können mithilfe von Listen-API-Aufrufen abgerufen werden, wobei die CONTAINER_ID und der Accept-Header auf die richtigen Werte festgelegt sind. Einige sind auch in der Benutzeroberfläche leicht zugänglich. -
Sie sollten eine
201 Created
Antwort erhalten -
Kopieren Sie
meta:altId
aus dem Antworttext. Wir werden es später in einer anderen Übung verwenden.
-
Das neue Schema sollte in der Benutzeroberfläche sichtbar sein, jedoch ohne Feldergruppen
meta:altId
- oder Schema-ID können Sie auch abrufen, indem Sie die API-Anfrage Schema Registry API > Schemas > Retrieve a list of schemas within the specified container., wobei CONTAINER_ID auf tenant
gesetzt ist, und eine Accept-Kopfzeile application/vnd.adobe.xdm+json
.- Kein Authentifizierungs-Token: Führen Sie die Anfrage OAuth: Zugriffs-Token anfordern aus, um ein neues Token zu generieren
401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/
: Aktualisieren der CONTAINER_ID Umgebungsvariable vonglobal
auftenant
403: PALM Access Denied. POST access is denied for this resource from access control
: Überprüfen Sie Ihre Benutzerberechtigungen in der Admin Console
Hinzufügen von Standardfeldgruppen
Jetzt ist es an der Zeit, die Feldergruppen zum Schema hinzuzufügen:
-
Öffnen Sie in Postman die Anfrage Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.
-
Fügen auf der Registerkarte den
meta:altId
Wert aus der vorherigen Antwort alsSCHEMA_ID
ein -
Öffnen Sie die Registerkarte Text und fügen Sie den folgenden Code ein. Wählen Sie Senden, um den API-Aufruf durchzuführen. Dieser Aufruf fügt die Standardfeldgruppen zu Ihrem
Luma CRM Schema
hinzu:code language-json [{ "op": "add", "path": "/allOf/-", "value": { "$ref": "https://ns.adobe.com/xdm/context/profile-personal-details" } }, { "op": "add", "path": "/allOf/-", "value": { "$ref": "https://ns.adobe.com/xdm/context/profile-person-details" } } ]
-
Sie sollten für die Antwort einen Status „OK“ von 200 erhalten und die Feldergruppen sollten als Teil Ihres Schemas in der Benutzeroberfläche sichtbar sein
Hinzufügen einer benutzerdefinierten Feldergruppe
Fügen wir nun unsere Luma Identity profile field group
zum Schema hinzu. Zunächst müssen wir die ID unserer neuen Feldergruppe mithilfe einer Listen-API finden:
-
Schema Registry API > Field groups > Retrieve a list of field groups within the specified container. öffnen
-
Wählen Sie die Senden, um eine Liste aller benutzerdefinierten Feldergruppen in Ihrem Konto abzurufen
-
Rufen Sie den
$id
desLuma Identity profile field group
auf (Ihr Wert unterscheidet sich vom Wert in diesem Screenshot)
-
Öffnen Sie die Anfrage Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. erneut
-
Die params sollte weiterhin die
$id
Ihres Schemas enthalten -
Öffnen Sie die body und fügen Sie den folgenden Code ein. Ersetzen Sie dabei den
$ref
Wert durch den$id
Ihrer eigenenLuma Identity profile field group
:code language-json [{ "op": "add", "path": "/allOf/-", "value": { "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID" } }]
-
Wählen Sie Senden aus
Überprüfen Sie, ob die Feldergruppe zum Schema hinzugefügt wurde, indem Sie sowohl die API-Antwort als auch die der Benutzeroberfläche überprüfen.
Offline-Kaufereignis-Schema erstellen
Erstellen wir nun ein Schema basierend auf der Klasse Erlebnisereignis für die Offline-Kaufdaten von Luma. Da Sie sich nun mit der Benutzeroberfläche des Schema-Editors vertraut machen, werde ich die Anzahl der Screenshots in den Anweisungen reduzieren:
- Erstellen Sie ein Schema mit der Klasse Erlebnisereignis.
- Benennen Sie Ihr Schema
Luma Offline Purchase Events Schema
. - Fügen Sie die Standardfeldergruppe Commerce Details hinzu, um allgemeine Bestelldetails zu erfassen. Verbringen Sie ein paar Minuten damit, die Objekte darin zu erkunden.
- Suchen Sie nach
Luma Identity profile field group
. Es ist nicht verfügbar! Denken Sie daran, dass Feldergruppen an eine Klasse gebunden sind. Da wir eine andere Klasse für dieses Schema verwenden, können wir sie nicht verwenden. Wir müssen eine neue Feldergruppe für die XDM ExperienceEvent-Klasse hinzufügen, die die Identitätsfelder enthält. Unser Datentyp macht das wirklich einfach! - Wählen Sie das Neue Feldergruppe erstellen aus
- Geben Sie den Anzeigenamen als
Luma Identity ExperienceEvent field group
ein und wählen Sie die Schaltfläche Feldergruppen hinzufügen aus - Klicken Sie auf + neben dem Namen des Schemas.
- Geben Sie als Feldname "
systemIdentifier
" ein. - Geben Sie als Anzeigename
System Identifier
ein. - Wählen Sie als Typ die Option Systemkennung aus. Dies ist der benutzerdefinierte Datentyp, den Sie zuvor erstellt haben.
- Wählen Sie als Feldergruppe die Feldergruppe Luma Identity ExperienceEvent.
- Klicken Sie auf die Apply-Schaltfläche.
- Klicken Sie auf Speichern.
Beachten Sie, wie der Datentyp alle Felder hinzugefügt hat!
Wählen Sie außerdem XDM ExperienceEvent unter der Überschrift Klasse aus und überprüfen Sie einige der Felder, die von dieser Klasse bereitgestellt werden. Beachten Sie, dass die Felder _id und Zeitstempel bei der Verwendung der XDM ExperienceEvent-Klasse erforderlich sind. Diese Felder müssen für jeden Datensatz ausgefüllt werden, den Sie bei Verwendung dieses Schemas aufnehmen:
Erstellen eines Web-Ereignisschemas
Jetzt erstellen wir ein weiteres Schema für die Website-Daten von Luma. An dieser Stelle sollten Sie ein Experte in der Erstellung von Schemata sein! Das folgende Schema mit diesen Eigenschaften erstellen
Wählen Sie die Feldergruppe Consumer Experience Event aus. Diese Feldergruppe enthält die Commerce- und ProductListItems-Objekte, die sich auch in Commerce-Details befanden. Tatsächlich Consumer Experience Event eine Kombination aus mehreren anderen Standardfeldgruppen, die auch separat verfügbar sind. AEP Web SDK ExperienceEvent-Feldergruppe enthält auch andere Feldergruppen, einschließlich einiger derselben in Consumer Experience Event. Glücklicherweise fügen sie sich nahtlos ineinander.
Beachten Sie, dass wir die Luma Identity ExperienceEvent field group
nicht zu diesem Schema hinzugefügt haben. Dies liegt daran, dass Web SDK eine andere Art der Identitätserfassung hat. Wenn Sie die Klasse XDM ExperienceEvent im Abschnitt Komposition des Schema-Editors auswählen, werden Sie feststellen, dass eines der standardmäßig hinzugefügten Felder IdentityMap heißt. IdentityMap wird von verschiedenen Adobe-Programmen verwendet, um eine Verbindung zu Platform herzustellen. In der Lektion zur Streaming-Aufnahme erfahren Sie, wie Identitäten über identityMap an Platform gesendet werden.
Erstellen eines Produktkatalogschemas
Mithilfe der Feldergruppen Commerce und Consumer Experience Event meldet Luma einige Details zu produktbezogenen Ereignissen über den standardmäßigen Datentyp productListItems . Sie verfügen jedoch auch über zusätzliche Produktdetailfelder, die sie an Platform senden möchten. Anstatt all diese Felder in ihren Point-of-Sale- und E-Commerce-Systemen zu erfassen, würde Luma es vorziehen, diese Felder direkt aus ihrem Produktkatalogsystem aufzunehmen. Mit einer „Schemabeziehung“ können Sie eine Beziehung zwischen zwei Schemata definieren, um Klassifizierungen oder Suchen durchzuführen. Luma verwendet eine Beziehung, um ihre Produktdetails zu klassifizieren. Wir beginnen den Prozess jetzt und schließen ihn am Ende der nächsten Lektion ab.
Zunächst müssen wir ein Schema für den Produktkatalog von Luma mithilfe einer benutzerdefinierten Klasse erstellen:
-
Klicken Sie auf Schaltfläche Schema erstellen“.
-
Wählen Sie im Workflow Schema erstellen die Option Sonstige aus.
-
Klicken Sie auf Schaltfläche Klasse erstellen“
-
Benennen Sie ihn
Luma Product Catalog Class
-
Belassen Sie Verhalten als Eintrag
-
Klicken Sie auf Schaltfläche Erstellen“.
-
Die Luma-Produktkatalogklasse die Sie erstellt haben, wird in der unten stehenden Tabelle „Klassen“ angezeigt. Stellen Sie sicher, dass die Klasse ausgewählt ist, und klicken Sie dann auf Weiter.
-
Benennen Sie das Schema
Luma Product Catalog Schema
. -
Erstellen Sie eine neue Feldergruppe namens
Luma Product Catalog field group
mit den folgenden Feldern:- productName: Produktname: Zeichenfolge
- productCategory: Produktkategorie: Zeichenfolge
- productColor: Produktfarbe: Zeichenfolge
- productSKU: Produkt-SKU: Zeichenfolge | Erforderlich
- productSize: Produktgröße: Zeichenfolge
- productPrice: Produktpreis: Doppelt
-
Speichern des Schemas
Ihr neues Schema sollte wie folgt aussehen. Beachten Sie, wie das productSku
Feld im Abschnitt Erforderliche Felder aufgeführt wird:
Der nächste Schritt besteht darin, die Beziehung zwischen den beiden ExperienceEvent-Schemas und dem Luma Product Catalog Schema
zu definieren. Es gibt jedoch einige zusätzliche Schritte, die wir in der nächsten Lektion ausführen müssen, bevor wir dies tun können.
Weitere Ressourcen
Nachdem Sie nun über Ihre Schemata verfügen, können Sie Identitäten zuordnen!