In dieser Lektion modellieren Sie Lumas Daten in Schemata. Dies ist eine der längsten Lektionen im Tutorial, also lassen Sie sich ein Glas Wasser schnappen!
Standardisierung und Interoperabilität sind Schlüsselkonzepte von Adobe Experience Platform. Das Experience-Datenmodell (XDM) ist ein Versuch, Kundenerlebnisdaten zu standardisieren und Schemas für das Customer Experience Management zu definieren.
XDM ist eine öffentlich dokumentierte Spezifikation, die die Leistungsfähigkeit digitaler Erlebnisse verbessern soll. Es bietet allgemeine Strukturen und Definitionen für Anwendungen, die zur Kommunikation mit Platform-Diensten verwendet werden. 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 Methode, auf der die Experience Platform beruht, XDM-System implementiert Experience-Datenmodell-Schemas für die Verwendung durch Platform-Dienste.
Datenarchitekten müssen außerhalb dieses Tutorials Schemas erstellen, jedoch Dateningenieure arbeitet eng mit den Schemas zusammen, die vom Data Architect erstellt wurden.
Bevor Sie mit den Übungen beginnen, sehen Sie sich dieses kurze Video an, um mehr über Schemas und das Experience-Datenmodell (XDM) zu erfahren:
Für einen tieferen Einblick in die Datenmodellierung in Experience Platform empfehlen wir, diesen Kurs zu absolvieren Modellieren Ihrer Kundenerlebnisdaten mit XDM, kostenlos auf Experience League!
Im Berechtigungen konfigurieren Lektion erstellen Sie alle Zugriffssteuerungen, die zum Abschluss dieser Lektion erforderlich sind.
In dieser Übung erstellen wir ein Schema für die Treuedaten von Luma.
Als Nächstes werden Sie aufgefordert, dem Schema Feldergruppen hinzuzufügen. Alle Felder müssen mithilfe von Gruppen zu Schemas hinzugefügt werden. Sie können aus einem großen Satz von Feldergruppen mit Industriestandard wählen, die von Adobe bereitgestellt werden, oder eine eigene erstellen. Wenn Sie mit der Modellierung Ihrer eigenen Daten in Experience Platform beginnen, sollten Sie sich mit den branchenüblichen Feldergruppen vertraut machen, die von Adobe bereitgestellt werden. Wenn möglich, empfiehlt es sich, sie zu verwenden, da sie manchmal nachgelagerte Dienste wie Customer AI, Attribution AI und Adobe Analytics betreiben.
Beim Arbeiten mit Ihren eigenen Daten besteht ein großer Schritt darin, zu bestimmen, welche Ihrer eigenen Daten in Platform erfasst und wie sie modelliert werden sollen. Dieses große Thema wird im Laufe des Kurses eingehender diskutiert Modellieren Ihrer Kundenerlebnisdaten mit XDM. In diesem Tutorial werde ich Sie lediglich durch die Implementierung einiger vorab festgelegter Schemas führen.
So fügen Sie Feldergruppen hinzu:
Im Feldergruppen hinzufügen modal, wählen Sie die folgenden Feldergruppen aus:
Sie können eine Vorschau der in der Feldergruppe hinzugefügten Felder anzeigen, indem Sie auf das Symbol rechts in der Zeile klicken.
Überprüfen Sie die Branche > Einzelhandel zum Anzeigen branchenspezifischer Feldergruppen.
Auswählen Treue , um die Felder des Treueprogramms hinzuzufügen.
Wählen Sie Feldergruppe hinzufügen aus, um alle drei Feldergruppen zum Schema hinzuzufügen.
Nehmen Sie sich Zeit, um den aktuellen Status des Schemas zu untersuchen. Die Feldergruppen haben Standardfelder für eine Person, ihre Kontaktdaten und den Status des Treueprogramms hinzugefügt. Diese beiden Feldergruppen können bei der Erstellung von Schemata für die Daten Ihres Unternehmens hilfreich sein. Wählen Sie eine bestimmte Feldergruppenzeile aus oder aktivieren Sie das Kontrollkästchen neben dem Feldergruppennamen, um zu sehen, wie sich die Visualisierung ändert.
So speichern Sie das Schema:
Luma Loyalty Schema
als Anzeigename.Es ist in Ordnung, wenn eine Feldergruppe ein Feld für einen Datenpunkt hinzufügt, den Sie nicht erfassen. Beispielsweise könnte "faxPhone"ein Feld sein, für das Luma keine Daten erfasst. Das ist in Ordnung. Nur weil ein Feld im Schema definiert ist, bedeutet dies nicht, dass die Daten dafür verwendet werden must später erfasst werden.
Erstellen wir nun eine benutzerdefinierte Feldergruppe.
Während die Gruppe "Treuefeld"eine loyaltyID
-Feld, möchte Luma alle Systemkennungen in einer Gruppe verwalten, um die Konsistenz ihrer Schemas zu gewährleisten.
Feldergruppen müssen im Schema-Workflow erstellt werden. So erstellen Sie die Feldergruppe:
Luma Identity profile field group
als Anzeigenamesystem identifiers for XDM Individual Profile class
als BeschreibungDie neue, leere Feldergruppe wird Ihrem Schema hinzugefügt. Die + -Schaltflächen können verwendet werden, um neue Felder an einer beliebigen Stelle in der Hierarchie hinzuzufü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 Ihrem Mandanten-ID-Namespace hinzugefügt, um Konflikte zwischen Ihren benutzerdefinierten Feldern und beliebigen Standardfeldern zu verwalten.
Im Feldeigenschaften Seitenleiste fügen Sie die Details des neuen Felds hinzu:
systemIdentifier
System Identifier
Fügen Sie nun zwei Felder unter dem systemIdentifier
-Objekt:
loyaltyId
Loyalty Id
crmId
CRM Id
Ihre neue Feldergruppe sollte wie folgt aussehen: Wählen Sie die Speichern -Schaltfläche, um Ihr Schema zu speichern, aber das Schema für die nächste Übung offen lassen.
Feldergruppen, z. B. Ihre neue Luma Identity profile field group
kann in anderen Schemas wiederverwendet werden, sodass Sie Standarddatendefinitionen über mehrere Systeme hinweg erzwingen können. Aber sie können nur wiederverwendet werden in Schemas, die eine Klasse gemeinsam haben, in diesem Fall die Klasse "XDM Individual Profile".
Der Datentyp ist ein weiteres Konstrukt mit mehreren Feldern, das in Schemas wiederverwendet werden kann über mehrere Klassen hinweg. Konvertieren wir unsere neue systemIdentifier
Objekt in einen Datentyp ein:
Mit dem Luma Loyalty Schema
weiterhin geöffnet sein, wählen Sie die systemIdentifier
Objekt und auswählen In neuen Datentyp konvertieren
Wenn Sie Abbrechen aus dem Schema und navigieren Sie zum Datentypen angezeigt, wird der neu erstellte Datentyp angezeigt. Wir werden diesen Datentyp später in der Lektion verwenden.
Jetzt erstellen wir ein Schema mit der API.
Wenn Sie die API-Übung lieber überspringen möchten, können Sie das folgende Schema mithilfe der Methode der Benutzeroberfläche erstellen:
Luma CRM Schema
Zuerst erstellen wir ein leeres Schema:
Öffnen Postman
Wenn Sie kein Zugriffstoken haben, öffnen Sie die Anfrage OAuth: Request Access Token und wählen Sie Senden , um ein neues Zugriffstoken anzufordern.
Öffnen Sie Ihre Umgebungsvariablen und ändern Sie den Wert von CONTAINER_ID von global
nach tenant
. Denken Sie daran, dass Sie tenant
wann immer Sie mit Ihren eigenen benutzerdefinierten Elementen in Platform interagieren möchten, z. B. beim Erstellen eines Schemas.
Wählen Sie Speichern aus
Anfrage öffnen Schema Registry API > Schemas > Create a new custom schema.
Öffnen Sie die body und fügen Sie den folgenden Code ein und wählen Sie Senden , um den API-Aufruf durchzuführen. Mit diesem Aufruf wird ein neues Schema mit demselben XDM Individual Profile
base-Klasse:
{
"type": "object",
"title": "Luma CRM Schema",
"description": "Schema for CRM data of Luma Retail ",
"allOf": [{
"$ref": "https://ns.adobe.com/xdm/context/profile"
}]
}
Der Namespace verweist in diesem und den nachfolgenden Codebeispielen (z. B. https://ns.adobe.com/xdm/context/profile
), kann mithilfe von Listen-API-Aufrufen mit der CONTAINER_ID und akzeptieren Kopfzeilen, die auf die richtigen Werte gesetzt sind. Einige sind auch über die Benutzeroberfläche leicht zugänglich.
Sie sollten eine 201 Created
response
Kopieren 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
Die meta:altId
oder eine Schema-ID auch abgerufen werden kann, indem die API-Anfrage gesendet wird Schema Registry API > Schemas > Retrieve a list of schemas within the specified container. mit dem CONTAINER_ID auf tenant
und eine Überschrift "accept" application/vnd.adobe.xdm+json
.
Häufige Probleme mit diesem Aufruf und mögliche Fehlerbehebungen:
401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/
: Aktualisieren Sie die CONTAINER_ID Umgebungsvariable aus global
nach tenant
403: PALM Access Denied. POST access is denied for this resource from access control
: Benutzerberechtigungen in der Admin Console überprüfenJetzt ist es an der Zeit, die Feldergruppen zum Schema hinzuzufügen:
In Postman, die Anforderung öffnen Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.
Im Parameter Registerkarte, fügen Sie die meta:altId
Wert aus der vorherigen Antwort als SCHEMA_ID
Öffnen Sie die Registerkarte "Hauptteil", fügen Sie den folgenden Code ein und wählen Sie Senden , um den API-Aufruf durchzuführen. Durch diesen Aufruf werden die Standardfeldgruppen zu Ihrem Luma CRM Schema
:
[{
"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 den Status "200 OK"für die Antwort erhalten und die Feldergruppen sollten als Teil Ihres Schemas in der Benutzeroberfläche sichtbar sein
Fügen wir nun unsere Luma Identity profile field group
zum Schema. Zunächst müssen wir die ID unserer neuen Feldergruppe mithilfe einer Listen-API finden:
Anfrage öffnen Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.
Wählen Sie die Senden -Schaltfläche zum Abrufen einer Liste aller benutzerdefinierten Feldergruppen in Ihrem Konto
Grab die $id
Wert der Luma Identity profile field group
(Ihr unterscheidet sich vom Wert in diesem Screenshot)
Anfrage öffnen Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. repeat
Die Parameter -Registerkarte sollte weiterhin enthalten sein. $id
Ihres Schemas
Öffnen Sie die body und fügen Sie den folgenden Code ein, ersetzen Sie die $ref
-Wert durch $id
Ihres eigenen Luma Identity profile field group
:
[{
"op": "add",
"path": "/allOf/-",
"value": {
"$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
}
}]
Auswählen Senden
Überprüfen Sie, ob die Feldergruppe zum Schema hinzugefügt wurde, indem Sie sowohl die API-Antwort als auch die Benutzeroberfläche überprüfen.
Erstellen wir nun ein Schema basierend auf der XDM ExperienceEvent -Klasse für die Offline-Kaufdaten von Luma. Da Sie sich jetzt mit der Benutzeroberfläche des Schema-Editors vertraut machen, reduziere ich die Anzahl der Screenshots in den Anweisungen:
Luma Identity profile field group
. Es ist nicht verfügbar! Denken Sie daran, dass Feldgruppen mit einer Klasse verknüpft sind. Da wir für dieses Schema eine andere Klasse 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 wird das ganz einfach machen!Luma Identity ExperienceEvent field group
und wählen Sie die Feldergruppen hinzufügen buttonsystemIdentifier
System Identifier
Luma Offline Purchase Events Schema
Beachten Sie, dass der Datentyp alle Felder hinzugefügt hat!
Wählen Sie außerdem XDM ExperienceEvent unter Klasse Überschriften erstellen und einige der von dieser Klasse hinzugefügten Felder überprüfen. Beachten Sie, dass bei der Verwendung der XDM ExperienceEvent-Klasse die Felder _id und timestamp erforderlich sind. Diese Felder müssen für jeden Datensatz, den Sie bei Verwendung dieses Schemas erfassen, ausgefüllt werden:
Jetzt erstellen wir ein weiteres Schema für die Website-Daten von Luma. An dieser Stelle sollten Sie ein Experte in der Erstellung von Schemas sein! Erstellen Sie das folgende Schema mit diesen Eigenschaften
Eigenschaft | Wert |
---|---|
Klasse | XDM ExperienceEvent |
Feldergruppe | ExperienceEvent-Mixin für das AEP Web SDK |
Feldergruppe | Kundenerlebnisereignis |
Schemaname | Luma-Webereignisschema |
Wählen Sie die Ereignis für Kundenerlebnisse Feldergruppe. Diese Feldergruppe enthält die Commerce- und productListItems-Objekte, die sich auch in Commerce-Details. Tatsächlich Ereignis für Kundenerlebnisse ist eine Kombination aus mehreren anderen Standardfeldgruppen, die auch separat verfügbar sind. ExperienceEvent-Mixin für das AEP Web SDK Feldergruppe enthält auch andere Feldergruppen, darunter einige der gleichen in Ereignis für Kundenerlebnisse. Glücklicherweise verschmelzen sie sich nahtlos.
Beachten Sie, dass wir die Luma Identity ExperienceEvent field group
auf dieses Schema verweist. Dies liegt daran, dass das Web SDK eine andere Methode zur Erfassung von Identitäten hat. Wenn Sie die XDM ExperienceEvent -Klasse in Komposition -Abschnitt des Schema-Editors sehen Sie, dass eines der standardmäßig hinzugefügten Felder IdentityMap. IdentityMap wird von verschiedenen Adobe Apps verwendet, um eine Verbindung zu Platform herzustellen. In der Streaming-Erfassung sehen Sie, wie Identitäten über identityMap an Platform gesendet werden.
Durch Verwendung der Variablen Commerce-Details und Ereignis für Kundenerlebnisse -Feldergruppen, meldet Luma einige Details produktbezogener Ereignisse über den standardmäßigen Datentyp productListItems . Sie verfügen jedoch auch über zusätzliche Produktdetailfelder, die sie an Platform senden möchten. Anstatt alle diese Felder in ihren Point-of-Sale- und E-Commerce-Systemen zu erfassen, würde Luma diese Felder lieber direkt aus ihrem Produktkatalogsystem aufnehmen. Mit einer "Schemabeziehung"können Sie eine Beziehung zwischen zwei Schemas zum Zweck der Klassifizierung oder Suche definieren. Luma wird eine Beziehung verwenden, um ihre Produktdetails zu klassifizieren. Wir werden den Prozess jetzt beginnen und am Ende der nächsten Lektion abschließen.
Wenn Sie bereits Analytics- oder Target-Kunde sind, entspricht die Klassifizierung von Entitäten mit Schemabeziehungen der SAINT-Klassifizierung oder dem Hochladen Ihres Produktkatalogs für Recommendations
Zunächst müssen wir ein Schema für den Produktkatalog von Luma mithilfe einer benutzerdefinierten Klasse erstellen:
Luma Product Catalog Class
Luma Product Catalog field group
mit den folgenden Feldern:
Luma Product Catalog Schema
(Achten Sie darauf, das richtige Feld zu aktualisieren und den Klassennamen nicht zu aktualisieren)Ihr neues Schema sollte wie folgt aussehen: Beachten Sie, dass productSku
wird im Feld Erforderliche Felder Abschnitt:
Der nächste Schritt besteht darin, die Beziehung zwischen den beiden ExperienceEvent-Schemas und dem Luma Product Catalog Schema
Es gibt jedoch noch ein paar weitere Schritte, die wir in der nächsten Lektion unternehmen müssen, bevor wir das tun können.
Jetzt, da Sie Ihre Schemas haben, können Sie Zuordnungsidentitäten!