Modelldaten in Schemata

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:

Erforderliche Berechtigungen

Im Berechtigungen konfigurieren Lektion erstellen Sie alle Zugriffssteuerungen, die zum Abschluss dieser Lektion erforderlich sind.

Treueschema über Benutzeroberfläche erstellen

In dieser Übung erstellen wir ein Schema für die Treuedaten von Luma.

1. Wechseln Sie zur Benutzeroberfläche von Platform und stellen Sie sicher, dass Ihre Sandbox ausgewählt ist.
2. Navigieren Sie zu Schemas in der linken Navigation
3. Klicken Sie auf Schema erstellen oben rechts
4. Wählen Sie aus dem Dropdown-Menü XDM Individual Profile, da wir Attribute eines einzelnen Kunden modellieren werden (Punkte, Status usw.).
   

Standardfeldgruppen hinzufügen

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:

1. Im Feldergruppen hinzufügen modal, wählen Sie die folgenden Feldergruppen aus:

   1. Demografische Details für grundlegende Kundendaten wie Name und Geburtsdatum
   2. Persönliche Kontaktangaben für grundlegende Kontaktdaten wie E-Mail-Adresse und Telefonnummer

2. Sie können eine Vorschau der in der Feldergruppe hinzugefügten Felder anzeigen, indem Sie auf das Symbol rechts in der Zeile klicken.
   

3. Überprüfen Sie die Branche > Einzelhandel zum Anzeigen branchenspezifischer Feldergruppen.

4. Auswählen Treue , um die Felder des Treueprogramms hinzuzufügen.

5. 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:

1. Wählen Sie den obersten Knoten des Schemas aus.
2. Eingabe Luma Loyalty Schema als Anzeigename.
3. Wählen Sie Speichern aus.
   

Benutzerdefinierte Feldergruppe hinzufügen

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:

1. Auswählen Hinzufügen unter Schemafeldgruppen heading
   
2. Wählen Sie Neue Feldergruppe erstellen aus
3. Verwendung Luma Identity profile field group als Anzeigename
4. Verwendung system identifiers for XDM Individual Profile class als Beschreibung
5. Wählen Sie Feldergruppen hinzufügen aus
   

Die 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:

1. 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.

2. Im Feldeigenschaften Seitenleiste fügen Sie die Details des neuen Felds hinzu:

   1. Feldname: systemIdentifier
   2. Anzeigename: System Identifier
   3. Typ: Objekt
   4. Wählen Sie Anwenden aus

   

Fügen Sie nun zwei Felder unter dem systemIdentifier -Objekt:

1. Erstes Feld
   1. Feldname: loyaltyId
   2. Anzeigename: Loyalty Id
   3. Typ: Zeichenfolge
2. Zweites Feld
   1. Feldname: crmId
   2. Anzeigename: CRM Id
   3. Typ: Zeichenfolge

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.

Erstellen eines Datentyps

Feldergruppen, z. B. Ihre neue Luma Identity profile field groupkann 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.

CRM-Schema über API erstellen

Jetzt erstellen wir ein Schema mit der API.

Zuerst erstellen wir ein leeres Schema:

1. Öffnen Postman

2. Wenn Sie kein Zugriffstoken haben, öffnen Sie die Anfrage OAuth: Request Access Token und wählen Sie Senden , um ein neues Zugriffstoken anzufordern.

3. Ö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.

4. Wählen Sie Speichern aus
   

5. Anfrage öffnen Schema Registry API > Schemas > Create a new custom schema.

6. Ö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"
     }]
   }
   

   HINWEIS

   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.

7. Sie sollten eine 201 Created response

8. Kopieren meta:altId aus dem Antworttext. Wir werden es später in einer anderen Übung verwenden.
   

9. Das neue Schema sollte in der Benutzeroberfläche sichtbar sein, jedoch ohne Feldergruppen
   

Standardfeldgruppen hinzufügen

Jetzt ist es an der Zeit, die Feldergruppen zum Schema hinzuzufügen:

1. In Postman, die Anforderung öffnen Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

2. Im Parameter Registerkarte, fügen Sie die meta:altId Wert aus der vorherigen Antwort als SCHEMA_ID

3. Ö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"
       }
     }
   ]
   

4. 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

   

Benutzerdefinierte Feldergruppe hinzufügen

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:

1. Anfrage öffnen Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.

2. Wählen Sie die Senden -Schaltfläche zum Abrufen einer Liste aller benutzerdefinierten Feldergruppen in Ihrem Konto

3. Grab die $id Wert der Luma Identity profile field group (Ihr unterscheidet sich vom Wert in diesem Screenshot)
   

4. Anfrage öffnen Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. repeat

5. Die Parameter -Registerkarte sollte weiterhin enthalten sein. $id Ihres Schemas

6. Ö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"
     }
   }]
   

7. 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.

Offline-Kaufereignisschema erstellen

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:

1. Erstellen Sie ein Schema mit der XDM ExperienceEvent class
2. Standardfeldgruppe hinzufügen Commerce-Details , um allgemeine Bestelldetails zu erfassen. Verbringen Sie einige Minuten damit, die Objekte darin zu erforschen.
3. Suchen Sie nach 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!
4. Wählen Sie die Neue Feldergruppe erstellen Optionsfeld
5. Geben Sie die Anzeigename as Luma Identity ExperienceEvent field group und wählen Sie die Feldergruppen hinzufügen button
6. Stellen Sie sicher, dass + -Schaltflächen werden in Struktur Abschnitt, damit neue Felder hinzugefügt werden können
7. In Struktur Bereich, wählen Sie + auf der obersten Ebene des Schemas
8. Als Feldname, eingeben systemIdentifier
9. Als Anzeigename, eingeben System Identifier
10. Als Typ auswählen Systemkennung der benutzerdefinierte Datentyp ist, den Sie zuvor erstellt haben
11. Wählen Sie die Anwenden button
12. Benennen des Schemas Luma Offline Purchase Events Schema
13. Klicken Sie auf die Schaltfläche Speichern

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:

Webereignisschema erstellen

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

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.

Produktkatalog-Schema erstellen

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.

Zunächst müssen wir ein Schema für den Produktkatalog von Luma mithilfe einer benutzerdefinierten Klasse erstellen:

1. Wählen Sie die Schema erstellen und wählen Sie die Durchsuchen Option aus der Dropdown-Liste
   
2. Wählen Sie die Neue Klasse erstellen Optionsfeld
3. Benennen Sie sie Luma Product Catalog Class
4. Lassen Sie die Verhalten as Datensatz
5. Wählen Sie die Klasse zuweisen button
   
6. Erstellen Sie eine neue Feldergruppe aufgerufen Luma Product Catalog field group mit den folgenden Feldern:
   1. productName: Produktname: Zeichenfolge
   2. productCategory: Produktkategorie: Zeichenfolge
   3. productColor: Produktfarbe: Zeichenfolge
   4. productSku: Produkt-SKU: Zeichenfolge | Erforderlich
   5. productSize: Produktgröße: Zeichenfolge
   6. productPrice: Produktpreis: Double
7. Benennen Sie das Schema. Luma Product Catalog Schema (Achten Sie darauf, das richtige Feld zu aktualisieren und den Klassennamen nicht zu aktualisieren)
8. ​​Schema speichern

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 SchemaEs gibt jedoch noch ein paar weitere Schritte, die wir in der nächsten Lektion unternehmen müssen, bevor wir das tun können.

Weitere Ressourcen

• Experience-Datenmodell (XDM) - Systemdokumentation
• Schema Registry-API

Jetzt, da Sie Ihre Schemas haben, können Sie Zuordnungsidentitäten!

Ressourcen für Business.Adobe.com