Modelldaten in Schemas

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:

TIPP

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!

Berechtigungen erforderlich

In Berechtigungen konfigurieren Lektion erstellen Sie alle Zugriffskontrollen, die zum Abschluss dieser Lektion erforderlich sind.

Treueprogramm über Benutzeroberfläche erstellen

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

  1. Navigieren Sie zur Benutzeroberfläche "Platform" und stellen Sie sicher, dass Ihre Sandbox ausgewählt ist.
  2. Gehe zu Schemas in der linken Navigation
  3. Wählen Sie Schema erstellen Schaltfläche oben rechts
  4. Wählen Sie im Dropdown-Menü Individuelles XDM-Profil, da wir die Attribute eines einzelnen Kunden modellieren werden (Punkte, Status usw.).
    Schema mit OOTB-Feldgruppe

Standardfeldgruppen Hinzufügen

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:

  1. In Feldgruppen Hinzufügen modal, wählen Sie die folgenden Feldgruppen aus:

    1. Demografische Details für grundlegende Kundendaten wie Name und Geburtsdatum
    2. Persönliche Kontaktdaten für einfache Kontaktdaten wie E-Mail-Adresse und Telefonnummer
  2. Sie können die in der Feldgruppe hinzugefügten Felder durch Auswahl des Symbols auf der rechten Seite der Zeile Vorschau werden.
    Standardfeldgruppen auswählen

  3. Überprüfen Sie die Branche > Einzelhandel , um branchenspezifische Feldgruppen anzuzeigen.

  4. Auswählen Treue um die Programm-Felder für loyale Kunden hinzuzufügen.

  5. Auswählen Feldgruppe Hinzufügen , um dem Schema alle drei Feldgruppen hinzuzufügen.
    Standardfeldgruppen zu loyalem Schema Hinzufü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:

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

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.

Benutzerdefinierte Feldgruppe Hinzufügen

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:

  1. Auswählen hinzufügen nach Schema-Feldgruppen Überschrift
    Neue Feldgruppe Hinzufügen

  2. Auswählen Neue Feldgruppe erstellen

  3. Verwenden Luma Identity profile field group als Anzeigename

  4. Verwenden system identifiers for XDM Individual Profile class als Beschreibung

  5. Auswählen Feldgruppen Hinzufügen

    Neue Feldgruppe 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:

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

  2. In Feldeigenschaften Sidebar: Details zum neuen Feld hinzufügen:

    1. Feldname: systemIdentifier
    2. Anzeigename: System Identifier
    3. Typ: Objekt
    4. Auswählen Übernehmen

    Neue Feldgruppe Hinzufügen

Fügen Sie jetzt zwei Felder unter 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 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.
Anzahl der Treuhandfelder abgeschlossen

Erstellen eines Datentyps

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

Interessensgruppen-Feldgruppe abgeschlossen

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.

Interessensgruppen-Feldgruppe abgeschlossen

CRM-Schema über API erstellen

Jetzt erstellen wir ein Schema mit der API.

TIPP

Wenn Sie die API-Übung überspringen möchten, können Sie das folgende Schema mithilfe der Benutzeroberfläche erstellen:

  1. Verwenden Sie Individuelles XDM-Profil Klasse
  2. Benennen Luma CRM Schema
  3. Verwenden Sie die folgenden Feldgruppen: Feldgruppe "Demografische Details", "Persönliche Kontaktdaten"und "Luma Identity Profil"

Zuerst erstellen wir ein leeres Schema:

  1. Öffnen Postman

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

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

  4. Wählen Sie Speichern aus
    CONTAINER_ID in Mandant ändern

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

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

    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.

  7. Sie sollten 201 Created Antwort

  8. Kopieren meta:altId aus dem Antwortkörper. Wir werden es später in einer anderen Übung nutzen.
    CRM-Schema erstellen

  9. Das neue Schema sollte in der Benutzeroberfläche, jedoch ohne Feldgruppen angezeigt werden
    CRM-Schema erstellen

HINWEIS

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.

TIPP

Häufige Probleme mit diesem Aufruf und mögliche Lösungen:

  • Kein Authentifizierungstoken: Führen Sie IMS: JWT-Generierung + Auth über Benutzer-Token Aufruf zum Erstellen neuer Token
  • 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üfen

Standardfeldgruppen Hinzufügen

Jetzt ist es an der Zeit, dem Schema die Feldgruppen hinzuzufügen:

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

  2. In Parameter einfügen. meta:altId Wert der vorherigen Antwort als SCHEMA_ID

  3. Ö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"
        }
      }
    ]
    
  4. Sie sollten den Status "OK"für die Antwort erhalten und die Feldgruppen sollten als Teil Ihres Schemas in der UI angezeigt werden.

    Standard-Feldgruppen hinzugefügt

Benutzerdefinierte Feldgruppe Hinzufügen

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:

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

  2. Wählen Sie Senden Schaltfläche zum Abrufen einer Liste aller benutzerspezifischen Feldgruppen in Ihrem Konto

  3. Nehmen Sie die $id Wert der Luma Identity profile field group (Ihr Wert unterscheidet sich von dem in diesem Screenshot)
    Liste von Feldgruppen abrufen

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

  5. Die Parameter Tabulator sollte weiterhin $id Ihres Schemas

  6. Ö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"
      }
    }]
    
  7. Auswählen Senden

    Gruppe für Identitätsfeld hinzufügen

Überprüfen Sie, ob die Feldgruppe dem Schema hinzugefügt wurde, indem Sie sowohl die API-Antwort als auch die Benutzeroberfläche überprüfen.

Offline-Ereignis-Schema erstellen

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:

  1. Schema erstellen mit XDM ExperienceEvent Klasse
  2. Standardfeldgruppe Hinzufügen Commerce-Details um allgemeine Auftragsdetails zu erfassen. Erforschen Sie die Objekte im Inneren innerhalb weniger Minuten.
  3. Suchen Sie nach 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!
  4. Wählen Sie Neue Feldgruppe erstellen Optionsfeld
  5. Geben Sie die Anzeigename als Luma Identity ExperienceEvent field group und wählen Sie Feldgruppen Hinzufügen Schaltfläche
  6. Stellen Sie sicher, dass + Schaltflächen werden in Struktur Abschnitt, damit Sie neue Felder hinzufügen können
  7. In Struktur Abschnitt auswählen + auf oberster Ebene des Schemas
  8. As the Feldname, eingeben systemIdentifier
  9. As the Anzeigename, eingeben System Identifier
  10. As the Typ, wählen Systemkennung Der benutzerdefinierte Datentyp, den Sie zuvor erstellt haben
  11. Wählen Sie Übernehmen Schaltfläche
  12. Benennen des Schemas Luma Offline Purchase Events Schema
  13. Klicken Sie auf die Schaltfläche Speichern

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

Datentyp in die Feldgruppe Hinzufügen

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:

Experience Ereignis-Basisstruktur

Web-Ereignisse-Schema erstellen

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.

Produktkatalog-Schema erstellen

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.

HINWEIS

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:

  1. Wählen Sie Schema erstellen und wählen Sie Durchsuchen Option aus der Dropdown-Liste
    Neues Schema erstellen
  2. Wählen Sie Neue Klasse erstellen Optionsfeld
  3. Benennen Luma Product Catalog Class
  4. Verlassen Sie die Verhalten als Aufzeichnen
  5. Wählen Sie Klasse zuweisen Schaltfläche
    Neue Klasse erstellen
  6. Neues erstellen Feldgruppe aufgerufen Luma Product Catalog field group mit den folgenden Feldern:
    1. productName: Produktname: Zeichenfolge
    2. Produktkategorie: Kategorie des Produkts: Zeichenfolge
    3. productColor: Produktfarbe: Zeichenfolge
    4. productSku: Produkt-SKU: Zeichenfolge | Erforderlich
    5. productSize: Produktgröße: Zeichenfolge
    6. productPrice: Produktpreis: Dublette
  7. Schema benennen Luma Product Catalog Schema (stellen Sie sicher, dass Sie das richtige Feld aktualisieren und den Klassennamen nicht aktualisieren)
  8. ​Schema speichern

Ihr neues Schema sollte so aussehen. Beachten Sie, wie productSku wird in Erforderliche Felder Abschnitt:
Produkt-Schema

Im nächsten Schritt wird 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 du deine Schemas hast, kannst du Zuordnungskennungen!

Auf dieser Seite