DokumentationExperience PlatformModelldaten in Schemata

Modelldaten in Schemata

Last update: Thu May 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Beginner
  • Intermediate
  • Developer

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 Experience Platform aufgebaut ist, 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:

https://video.tv.adobe.com/v/38505?learn=on&captions=ger

TIP
Für einen tieferen Einblick in die Datenmodellierung in Experience Platform empfehlen wir, den Kurs zu verfolgen Modellieren Ihrer Kundenerlebnisdaten mit XDM, kostenlos auf Experience League!

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. Wählen Sie die Schema erstellen rechts oben.
    Schema mit OOTB-Feldergruppe

  4. Wählen Sie im Workflow Schema erstellen die Option Individuelles Profil als Basisklasse für Ihr Schema, da wir Attribute eines einzelnen Kunden modellieren werden (Punkte, Status usw.).

  5. Klicken Sie auf Weiter.
    Basisklasse auswählen

  6. Eingabe Luma Loyalty Schema im Anzeigename des Schemas Textfeld. Auf der folgenden Arbeitsfläche können Sie auch die Basisschemastruktur überprüfen und überprüfen, die von der ausgewählten Klasse bereitgestellt wird.

  7. Auswählen Beenden , um Ihr Schema zu erstellen.
    Erstellen des Treueschemas abschließen

Standardfeldgruppen hinzufügen

Nach der Erstellung des Schemas werden Sie zum Schema-Editor weitergeleitet, wo Sie dem Schema Felder hinzufügen können. Sie können einzelne Felder direkt zum Schema hinzufügen oder Feldgruppen verwenden. Beachten Sie, dass alle einzelnen Felder weiterhin mit einer Klasse oder Feldergruppe verknüpft sind. Sie können aus einem großen Satz von branchenüblichen Feldergruppen wählen, die von Adobe bereitgestellt werden, oder Ihre eigenen erstellen. Wenn Sie mit der Modellierung Ihrer eigenen Daten im Experience Platform beginnen, sollten Sie sich mit den branchenüblichen Feldergruppen von Adobe vertraut machen. 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 wichtiger 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. Auswählen Hinzufügen unter Feldergruppen -Überschrift.
    Neue Feldergruppe hinzufügen

  2. Im Feldergruppen hinzufügen modal die folgenden Feldergruppen auswählen:

    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

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

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

  5. Auswählen Treuedetails , um die Felder des Treueprogramms hinzuzufügen.

  6. Auswählen Feldergruppen hinzufügen , um alle drei Feldergruppen zum Schema hinzuzufügen.
    Hinzufügen von Standardfeldgruppen zum Treueschema

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.

Um das Schema zu speichern, wählen Sie Speichern.
Schema speichern

NOTE
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. Sie können das Feld auch aus dem Schema entfernen.

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. Sie haben die Möglichkeit zum:

  • Fügen Sie Ihrem Schema zuerst ein neues benutzerdefiniertes Feld hinzu und erstellen Sie dann eine benutzerdefinierte Feldergruppe oder
  • Erstellen Sie zuerst eine benutzerdefinierte Feldergruppe und fügen Sie ihr dann Felder hinzu.

In diesem Tutorial beginnen wir mit der Erstellung einer benutzerdefinierten Feldergruppe.

So erstellen Sie die Feldergruppe:

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

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. Auswählen + 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. Im Feldergruppe Dropdown-Liste auswählen Luma-Identitäts-Profilgruppe die wir erstellt haben.

      Neue Feldergruppe hinzufügen

    5. Auswählen Anwenden

      Anwenden neuer Feldeigenschaften

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.
Abschluss der Treuefeldgruppe

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

Gruppe von Treuefeldern abgeschlossen

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.

Gruppe von Treuefeldern abgeschlossen

CRM-Schema über API erstellen

Jetzt erstellen wir ein Schema mit der API.

TIP
Wenn Sie die API-Übung lieber überspringen möchten, können Sie das folgende Schema mithilfe der Methode der Benutzeroberfläche erstellen:
  1. Verwenden Sie die Individuelles Profil class
  2. Benennen Sie ihn Luma CRM Schema
  3. Verwenden Sie die folgenden Feldergruppen: demografische Details, persönliche Kontaktdetails und Profilgruppe "Luma Identity"

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 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. Auswählen Speichern
    CONTAINER_ID in Mandanten ändern

  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:

    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
    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.
    CRM-Schema erstellen

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

NOTE
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.
TIP
Häufige Probleme mit diesem Aufruf und mögliche Fehlerbehebungen:
  • No auth token: Führen Sie den OAuth: Zugriffstoken anfordern Anfrage zum Generieren eines neuen Tokens
  • 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: Überprüfen Sie Ihre Benutzerberechtigungen in der Admin Console.

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:

    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"
    }
  }
]

  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

    Standardfeldgruppen hinzugefügt

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)
    Liste von Feldergruppen abrufen

  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:

    code language-json 
    [{
  "op": "add",
  "path": "/allOf/-",
  "value": {
    "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
  }
}]

  7. Auswählen Senden
    Hinzufügen der Gruppe Identitätsfeld

Ü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 Erlebnisereignis -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 Erlebnisereignis -Klasse.
  2. Benennen Sie Ihr Schema. Luma Offline Purchase Events Schema.
  3. Standardfeldgruppe hinzufügen Commerce-Details , um allgemeine Bestelldetails zu erfassen. Verbringen Sie einige Minuten damit, die Objekte darin zu erforschen.
  4. 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!
  5. Wählen Sie die Neue Feldergruppe erstellen Optionsfeld
  6. Geben Sie die Anzeigename as Luma Identity ExperienceEvent field group und wählen Sie die Feldergruppen hinzufügen button
  7. Klicken Sie auf + neben dem Namen des Schemas.
  8. Als Feldname, eingeben systemIdentifier.
  9. Als Anzeigename, eingeben System Identifier.
  10. Als Typ auswählen Systemkennung Dies ist der benutzerdefinierte Datentyp, den Sie zuvor erstellt haben.
  11. Als Feldergruppe select Luma Identity ExperienceEvent-Feldergruppe.
  12. Wählen Sie die Anwenden Schaltfläche.
  13. Wählen Sie die Speichern Schaltfläche.

Beachten Sie, dass der Datentyp alle Felder hinzugefügt hat!

Den Datentyp zur Feldergruppe hinzufügen

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:

Basisstruktur für Erlebnisereignisse

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

Eigenschaft
Wert
Klasse
Erlebnisereignis
Schemaname
Luma-Webereignisschema
Feldergruppe
AEP Web SDK ExperienceEvent
Feldergruppe
Erlebnisereignis für Verbraucher

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. AEP Web SDK ExperienceEvent 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-Applikationen 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 es vorziehen, diese Felder direkt aus ihrem Produktkatalogsystem zu erfassen. 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.

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

  1. Wählen Sie die Schema erstellen Schaltfläche.

  2. Wählen Sie im Workflow Schema erstellen die Option Sonstiges -Option.
    Neues Schema erstellen

  3. Wählen Sie die Klasse erstellen button

  4. Benennen Sie ihn Luma Product Catalog Class

  5. Lassen Sie die Verhalten as Datensatz

  6. Wählen Sie die Erstellen Schaltfläche.
    Neue Klasse erstellen

  7. Die Luma Product Catalog-Klasse , die Sie erstellt haben, wird in der Tabelle Klassen unten angezeigt. Stellen Sie sicher, dass die Klasse ausgewählt ist, und wählen Sie dann Nächste.
    Neue Klasse hinzugefügt

  8. Benennen Sie das Schema. Luma Product Catalog Schema.

  9. Erstellen Sie eine neue Feldergruppe aufgerufen Luma Product Catalog field group mit den folgenden Feldern:

    1. productName: Product Name: String
    2. productCategory: Product Category: String
    3. productColor: Product Color: String
    4. productSku: Product SKU: String | Erforderlich
    5. productSize: Produktgröße: Zeichenfolge
    6. productPrice: Product Price: Double

  10. Speichern das Schema

Ihr neues Schema sollte wie folgt aussehen: Beachten Sie, dass productSku wird im Feld Erforderliche Felder Abschnitt:
Produktschema

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

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

recommendation-more-help
513160b6-bf42-4c58-abdd-4f817b1cccad