In dieser Lektion modellieren Sie Lumas Daten in Schema. Das ist eine der längsten Lektionen des Tutorials, also bringen Sie ein Glas Wasser und schnallen Sie sich ein!
Normung und Interoperabilität sind Schlüsselkonzepte für Adobe Experience Platform. Experience Data Model (XDM) ist ein Versuch, Kundenerlebnisdaten zu standardisieren und Schema für das Kundenerlebnismanagement zu definieren.
XDM ist eine öffentlich dokumentierte Spezifikation, die die Leistungsfähigkeit digitaler Erlebnisse verbessern soll. Es enthält gemeinsame Strukturen und Definitionen für jede Anwendung, die zur Kommunikation mit Plattformdiensten verwendet wird. Durch die Einhaltung der XDM-Standards können alle Kundenerlebnisdaten in eine gemeinsame Darstellung integriert werden, die Erkenntnisse schneller und integrierter liefert. Sie können wertvolle Einblicke aus Kundenaktionen gewinnen, Audiencen durch Segmente definieren und Kundenattribute für Personalisierungszwecke ausdrücken.
XDM ist der Grundgerüst, der es Adobe Experience Cloud, angetrieben von der Experience Platform, ermöglicht, die richtige Botschaft an die richtige Person, am richtigen Kanal, genau zum richtigen Zeitpunkt zu senden. die Methode, auf der die Experience Platform basiert, XDM-System, operationalisiert Experience Data Model-Schema für die Nutzung durch Plattformdienste.
Datenarchitekten müssen Schemas außerhalb dieses Tutorials erstellen, Dateningenieure arbeitet eng mit den Schemas zusammen, die vom Datenarchitekten erstellt wurden.
Bevor Sie mit den Übungen beginnen, sehen Sie sich dieses kurze Video an, um mehr über Schema und das Erlebnisdatenmodell (XDM) zu erfahren:
Für einen tieferen Einstieg in die Datenmodellierung in der Experience Platform empfehlen wir, den Kurs zu wählen Kundenerlebnisdaten mit XDM modellieren, kostenlos auf Experience League verfügbar!
In Berechtigungen konfigurieren Lektion erstellen Sie alle Zugriffskontrollen, die zum Abschluss dieser Lektion erforderlich sind.
In dieser Übung werden wir ein Schema für die Treuedaten von Luma schaffen.
Als Nächstes werden Sie aufgefordert, dem Schema Feldgruppen hinzuzufügen. Alle Felder müssen Schemas mit Gruppen hinzugefügt werden. Sie können aus einem großen Satz von Feldgruppen nach Industriestandard, die von der Adobe bereitgestellt werden, wählen oder eigene Feldgruppen erstellen. Wenn Sie Ihre eigenen Daten in der Experience Platform modellieren, sollten Sie sich mit den branchenüblichen Feldgruppen der Adobe vertraut machen. Wenn möglich, ist es empfehlenswert, sie zu verwenden, da sie manchmal nachgelagerte Dienste wie Customer AI, Attribution AI und Adobe Analytics betreiben.
Wenn Sie mit Ihren eigenen Daten arbeiten, besteht ein großer Schritt darin, zu bestimmen, welche Ihrer eigenen Daten in der Plattform erfasst und wie sie modelliert werden sollen. Dieses große Thema wird im Kurs ausführlicher diskutiert Kundenerlebnisdaten mit XDM modellieren. In diesem Tutorial werde ich Sie lediglich durch die Umsetzung einiger vorab festgelegter Schema führen.
So fügen Sie Feldgruppen hinzu:
In Feldgruppen Hinzufügen modal, wählen Sie die folgenden Feldgruppen aus:
Sie können die in der Feldgruppe hinzugefügten Felder durch Auswahl des Symbols auf der rechten Seite der Zeile Vorschau werden.
Überprüfen Sie die Branche > Einzelhandel , um branchenspezifische Feldgruppen anzuzeigen.
Auswählen Treue um die Programm-Felder für loyale Kunden hinzuzufügen.
Auswählen Feldgruppe Hinzufügen , um dem Schema alle drei Feldgruppen hinzuzufügen.
Nehmen Sie sich Zeit, um den aktuellen Stand des Schemas zu erkunden. Die Feldgruppen haben Standardfelder zu einer Person hinzugefügt, deren Kontaktdaten und den Treuhandstatus von Programmen. Diese beiden Feldgruppen sind bei der Erstellung von Schemas für die Daten Ihrer eigenen Firma nützlich. Wählen Sie eine bestimmte Feldgruppenzeile aus oder aktivieren Sie das Kontrollkästchen neben dem Feldgruppennamen, um zu sehen, wie sich die Visualisierung ändert.
So speichern Sie das Schema:
Luma Loyalty Schema
als Anzeigename.Es ist in Ordnung, wenn eine Feldgruppe ein Feld für einen Datenpunkt hinzufügt, den Sie nicht erfassen. "faxPhone"ist beispielsweise ein Feld, für das Luma keine Daten erfasst. Das ist in Ordnung. Nur weil ein Feld im Schema definiert ist, bedeutet das nicht, dass die Daten für das Feld muss zu einem späteren Zeitpunkt eingeschlossen werden.
Erstellen wir nun eine benutzerdefinierte Feldgruppe.
Während die Gruppe des Treuhandfelds eine loyaltyID
-Feld, möchte Luma alle Systemkennungen in einer einzigen Gruppe verwalten, um die Konsistenz in allen Schemas sicherzustellen.
Feldgruppen müssen im Schema-Workflow erstellt werden. So erstellen Sie die Feldgruppe:
Auswählen hinzufügen nach Schema-Feldgruppen Überschrift
Auswählen Neue Feldgruppe erstellen
Verwenden Luma Identity profile field group
als Anzeigename
Verwenden system identifiers for XDM Individual Profile class
als Beschreibung
Auswählen Feldgruppen Hinzufügen
Die neue leere Feldgruppe wird Ihrem Schema hinzugefügt. Die + -Schaltflächen können verwendet werden, um neue Felder zu beliebigen Positionen in der Hierarchie hinzuzufügen. In unserem Fall möchten wir Felder auf der Root-Ebene hinzufügen:
Auswählen + neben dem Namen des Schemas. Hiermit wird ein neues Feld unter Ihrem Mandanten-ID-Namensraum hinzugefügt, um Konflikte zwischen Ihren benutzerdefinierten Feldern und beliebigen Standardfeldern zu verwalten.
In Feldeigenschaften Sidebar: Details zum neuen Feld hinzufügen:
systemIdentifier
System Identifier
Fügen Sie jetzt zwei Felder unter systemIdentifier
Objekt:
loyaltyId
Loyalty Id
crmId
CRM Id
Ihre neue Feldgruppe sollte so aussehen. Wählen Sie Speichern -Taste, um Ihr Schema zu speichern, aber lassen Sie das Schema für die nächste Übung geöffnet.
Feldgruppen, z. B. Ihre neue Luma Identity profile field group
, kann in anderen Schemas wiederverwendet werden, sodass Sie Standarddatendefinitionen auf mehreren Systemen erzwingen können. Aber sie können nur wiederverwendet werden in Schemas, die eine Klasse teilen, in diesem Fall die XDM Individual Profil-Klasse.
Der Datentyp ist ein weiteres Multifield-Konstrukt, das in Schemas wiederverwendet werden kann. über mehrere Klassen hinweg. Konvertieren wir unser neues systemIdentifier
Objekt in einen Datentyp ein:
Mit Luma Loyalty Schema
weiterhin öffnen, wählen Sie systemIdentifier
Objekt und auswählen In neuen Datentyp konvertieren
Wenn Abbrechen aus dem Schema heraus und navigieren Sie zu Datentypen angezeigt, wird Ihr neu erstellter Datentyp angezeigt. Dieser Datentyp wird später in der Lektion verwendet.
Jetzt erstellen wir ein Schema mit der API.
Wenn Sie die API-Übung überspringen möchten, können Sie das folgende Schema mithilfe der Benutzeroberfläche erstellen:
Luma CRM Schema
Zuerst erstellen wir ein leeres Schema:
Öffnen Postman
Wenn Sie in den letzten 24 Stunden keine Anfrage gestellt haben, sind Ihre Autorisierungstoken wahrscheinlich abgelaufen. Anforderung öffnen Adobe I/O Access Token Generation > Local Signing (Non-production use-only) > IMS: JWT Generate + Auth via User Token und wählen Senden um neue JWT und Zugriffstoken anzufordern.
Öffnen Sie Ihre Umgebung-Variablen und ändern Sie den Wert von Container_ID von global
nach tenant
. Denken Sie daran, dass Sie tenant
wann immer Sie mit Ihren eigenen benutzerspezifischen Elementen in der Plattform interagieren möchten, z. B. ein Schema erstellen.
Wählen Sie Speichern aus
Anforderung öffnen Schema Registry API > Schemas > Create a new custom schema.
Öffnen Sie die Hauptteil und fügen Sie folgenden Code ein und wählen Sie Senden , um den API-Aufruf durchzuführen. Dieser Aufruf erstellt ein neues Schema mit dem gleichen XDM Individual Profile
Basisklasse:
{
"type": "object",
"title": "Luma CRM Schema",
"description": "Schema for CRM data of Luma Retail ",
"allOf": [{
"$ref": "https://ns.adobe.com/xdm/context/profile"
}]
}
Der Namensraum verweist in diesen und folgenden Codebeispielen (z. B. https://ns.adobe.com/xdm/context/profile
), können Sie mithilfe von Liste-API-Aufrufen mit der CONTAINER_ID und akzeptieren den Header auf die korrekten Werte. Einige sind auch leicht zugänglich in der Benutzeroberfläche.
Sie sollten 201 Created
Antwort
Kopieren meta:altId
aus dem Antwortkörper. Wir werden es später in einer anderen Übung nutzen.
Das neue Schema sollte in der Benutzeroberfläche, jedoch ohne Feldgruppen angezeigt werden
Die meta:altId
oder Schema-ID kann auch abgerufen werden, indem die API-Anfrage gesendet wird Schema Registry API > Schemas > Retrieve a list of schemas within the specified container. mit Container_ID einstellen auf tenant
und eine Überschrift akzeptieren application/vnd.adobe.xdm+json
.
Häufige Probleme mit diesem Aufruf und mögliche Lösungen:
401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/
: Aktualisieren Sie die Container_ID Umgebung Variable von 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, dem Schema die Feldgruppen hinzuzufügen:
In Postman, Anfrage öffnen Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.
In Parameter einfügen. meta:altId
Wert der vorherigen Antwort als SCHEMA_ID
Öffnen Sie die Registerkarte "Hauptteil" und fügen Sie folgenden Code ein. Wählen Sie Senden , um den API-Aufruf durchzuführen. Dieser Aufruf fügt dem 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 "OK"für die Antwort erhalten und die Feldgruppen sollten als Teil Ihres Schemas in der UI angezeigt werden.
Fügen wir nun unsere Luma Identity profile field group
zum Schema. Zuerst müssen wir die ID unserer neuen Feldgruppe mithilfe einer Liste-API finden:
Anforderung öffnen Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.
Wählen Sie Senden Schaltfläche zum Abrufen einer Liste aller benutzerspezifischen Feldgruppen in Ihrem Konto
Nehmen Sie die $id
Wert der Luma Identity profile field group
(Ihr Wert unterscheidet sich von dem in diesem Screenshot)
Anforderung öffnen Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. erneut
Die Parameter Tabulator sollte weiterhin $id
Ihres Schemas
Öffnen Sie die Hauptteil und fügen Sie den folgenden Code ein, indem Sie die $ref
Wert mit $id
von 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 Feldgruppe dem Schema hinzugefügt wurde, indem Sie sowohl die API-Antwort als auch die Benutzeroberfläche überprüfen.
Erstellen wir nun ein Schema basierend auf XDM ExperienceEvent -Klasse für Lumas Offline-Kaufdaten. Da Sie sich jetzt mit der Benutzeroberfläche des Schema-Editors vertraut machen, werde ich die Anzahl der Screenshots in den folgenden Anweisungen reduzieren:
Luma Identity profile field group
. Es ist nicht verfügbar! Beachten Sie, dass Feldgruppen mit einer Klasse verbunden sind und dass wir für dieses Schema keine andere Klasse verwenden können. Wir müssen eine neue Feldgruppe 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 Feldgruppen Hinzufügen SchaltflächesystemIdentifier
System Identifier
Luma Offline Purchase Events Schema
Beachten Sie, wie der Datentyp alle Felder hinzugefügt hat!
Wählen Sie außerdem XDM ExperienceEvent nach Klasse einige der von dieser Klasse eingebrachten Felder zu bearbeiten und zu überprüfen. Beachten Sie, dass bei der Verwendung der XDM ExperienceEvent-Klasse die Felder _id und Zeitstempel erforderlich sind. Diese Felder müssen für jeden Datensatz ausgefüllt werden, den Sie bei Verwendung dieses Schemas erfassen:
Jetzt werden wir ein weiteres Schema für Lumas Website-Daten erstellen. An dieser Stelle sollten Sie ein Experte sein, um Schemas zu erstellen! Erstellen Sie das folgende Schema mit diesen Eigenschaften
Eigenschaft | Wert |
---|---|
Klasse | XDM ExperienceEvent |
Feldergruppe | AEP Web SDK ExperienceEvent Mixin |
Feldergruppe | Consumer Experience Ereignis |
Name des Schemas | Luma Web Ereignisses Schema |
Wählen Sie Consumer Experience Ereignis Feldgruppe. Diese Feldgruppe enthält die commerce- und productListItems-Objekte, die ebenfalls in Commerce-Details. Tatsächlich Consumer Experience Ereignis ist eine Kombination aus mehreren anderen Standardfeldgruppen, die ebenfalls separat erhältlich sind. AEP Web SDK ExperienceEvent Mixin Feldgruppe enthält auch andere Feldgruppen, darunter einige derselben in Consumer Experience Ereignis. Glücklicherweise verschmelzen sie sich nahtlos zusammen.
Beachten Sie, dass wir die Luma Identity ExperienceEvent field group
zu diesem Schema. Das liegt daran, dass das Web SDK eine andere Methode hat, Identitäten zu sammeln. Wenn Sie XDM ExperienceEvent Klasse in Komposition im Schema-Editor, werden Sie feststellen, dass eines der von ihm hinzugefügten Felder standardmäßig als IdentityMap. IdentityMap wird von verschiedenen Adobe-Anwendungen verwendet, um eine Verbindung zur Plattform herzustellen. Sie werden sehen, wie Identitäten über IdentityMap in der Streaming-Inhalten-Lektion an Platform gesendet werden.
Durch Verwendung von Commerce-Details und Consumer Experience Ereignis -Feldgruppen, meldet Luma einige Details produktbezogener Ereignis über den standardmäßigen productListItems-Datentyp. Sie verfügen aber auch über zusätzliche Produktdetailfelder, die sie an Platform senden möchten. Anstatt all diese Felder in ihren Verkaufs- und E-Commerce-Systemen zu erfassen, würde Luma es vorziehen, diese Felder direkt aus ihrem Produktkatalogsystem zu erfassen. Eine "Schema-Beziehung" ermöglicht es Ihnen, eine Beziehung zwischen zwei Schemas für die Klassifizierung oder Suche zu definieren. Luma verwendet eine Beziehung, 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 Zielgruppe-Kunde sind, entspricht die Klassifizierung von Entitäten mit Schema-Beziehungen einer SAINT-Klassifizierung oder dem Upload Ihres Produktkatalogs für Recommendations.
Zunächst müssen wir ein Schema für den Produktkatalog von Luma mit einer benutzerdefinierten Klasse erstellen:
Luma Product Catalog Class
Luma Product Catalog field group
mit den folgenden Feldern:
Luma Product Catalog Schema
(stellen Sie sicher, dass Sie das richtige Feld aktualisieren und den Klassennamen nicht aktualisieren)Ihr neues Schema sollte so aussehen. Beachten Sie, wie productSku
wird in Erforderliche Felder Abschnitt:
Im nächsten Schritt wird 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 du deine Schemas hast, kannst du Zuordnungskennungen!