DokumentationExperience PlatformTutorial für Mobile Apps

Erstellen eines XDM-Schemas

Last update: Tue Dec 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Beginner
  • Intermediate
  • Developer

Erfahren Sie, wie Sie ein XDM-Schema für App-Ereignisse erstellen.

Standardisierung und Interoperabilität sind Schlüsselkonzepte von Adobe Experience Platform. Das von Adobe unterstützte Experience-Datenmodell (XDM) ermöglicht die Standardisierung von Kundenerlebnisdaten und die Definition von Schemas für das Customer Experience Management.

Was sind XDM-Schemata?

XDM ist eine öffentlich dokumentierte Spezifikation, die die Leistungsfähigkeit digitaler Erlebnisse verbessern soll. Es bietet allgemeine Strukturen und Definitionen, die es jeder Anwendung ermöglichen, mit Platform-Diensten zu kommunizieren. 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 erhalten wertvolle Einblicke aus Kundenaktionen, definieren Kundenzielgruppen über Segmente und verwenden Kundenattribute für Personalisierungszwecke.

Schemas dienen in Experience Platform zur konsistenten und wiederverwendbaren Beschreibung der Struktur von Daten. Durch die systemübergreifende einheitliche Definition von Daten wird es einfacher, deren Bedeutung beizubehalten und somit Wert aus Daten zu ziehen.

Bevor Daten in Platform aufgenommen werden können, muss ein Schema erstellt werden, das die Datenstruktur beschreibt und den Datentyp entsprechend des jeweiligen Feldes einschränkt. Schemas bestehen aus einer Basisklasse und keiner oder mehreren Schema-Feldergruppen.

Weitere Informationen zum Schema-Kompositionsmodell, einschließlich Designgrundsätzen, und Best Practices finden Sie in der Grundlagen der Schemakomposition oder des Kurses Modellieren Ihrer Kundenerlebnisdaten mit XDM.

TIP
Wenn Sie mit Analytics Solution Design Reference (SDRs) vertraut sind, können Sie sich ein Schema als robustere SDR vorstellen. Siehe Erstellen und Verwalten eines SDR-Dokuments (Solution Design Reference) für weitere Informationen.

Voraussetzungen

Um die Lektion abzuschließen, müssen Sie über die Berechtigung zum Erstellen eines Experience Platform-Schemas verfügen.

Lernziele

In dieser Lektion werden Sie:

  • Erstellen eines Schemas in der Datenerfassungsoberfläche
  • Hinzufügen einer Standardfeldgruppe zum Schema
  • Erstellen und Hinzufügen einer benutzerdefinierten Feldergruppe zum Schema

  1. Melden Sie sich bei Adobe Experience Cloud an.

  2. Stellen Sie sicher, dass Sie sich in der Experience Platform-Sandbox befinden, die Sie für dieses Tutorial verwenden.

  3. App-Umschalter öffnen App Switcher (oben rechts),

  4. Auswählen Datenerfassung aus dem Menü.

    Bei Experience Cloud anmelden

    note note
    NOTE
    Kunden von Platform-basierten Anwendungen wie Real-Time CDP sollten für dieses Tutorial eine Entwicklungs-Sandbox verwenden. Andere Kunden verwenden die standardmäßige Produktions-Sandbox.

  5. Auswählen Schemas under Data Management in der linken Leiste.

    Tags-Startbildschirm

Sie befinden sich nun auf der Hauptseite der Schemas und erhalten eine Liste der vorhandenen Schemas. Sie können auch Registerkarten sehen, die den Kernbausteinen eines Schemas entsprechen:

  • Feldergruppen sind wiederverwendbare Komponenten, die ein oder mehrere Felder definieren, um bestimmte Daten zu erfassen, z. B. persönliche Details, Hotelpräferenzen oder Adressen.
  • Klassen definieren die Verhaltensaspekte der Daten, die das Schema enthält. Beispiel: XDM ExperienceEvent erfasst Zeitreihen, Ereignisdaten und XDM Individual Profile erfasst Attributdaten zu einer Person.
  • Datentypen werden als Referenzfeldtypen in Klassen oder Feldgruppen auf die gleiche Weise wie grundlegende literale Felder verwendet.

Die obigen Beschreibungen geben einen Überblick auf hoher Ebene. Weitere Informationen finden Sie unter Schema-Bausteine Video oder lesen Grundlagen der Schemakomposition in der Produktdokumentation.

In diesem Tutorial verwenden Sie die Feldergruppe "Consumer Experience Event"und erstellen eine benutzerdefinierte, um den Prozess zu demonstrieren.

NOTE
Adobe fügt weiterhin mehr Standardfeldgruppen hinzu und sollten nach Möglichkeit verwendet werden, da diese Felder implizit von Experience Platform-Diensten verstanden werden und bei der Verwendung über Plattformkomponenten hinweg eine größere Konsistenz gewährleistet ist. Die Verwendung von Standardfeldgruppen bietet greifbare Vorteile wie die automatische Zuordnung in Analytics- und AI-Funktionen in Platform.

Architektur des Luma-App-Schemas

In einem realen Szenario könnte der Schemaentwurfsprozess wie folgt aussehen:

  • Sammeln Sie Geschäftsanforderungen.
  • Suchen Sie nach vordefinierten Feldergruppen, um so viele Anforderungen wie möglich abzudecken.
  • Erstellen Sie benutzerdefinierte Feldergruppen für Lücken.

Zu Lernzwecken verwenden Sie vordefinierte und benutzerdefinierte Feldergruppen.

  • Ereignis für Kundenerlebnisse: Vordefinierte Feldergruppe mit vielen gemeinsamen Feldern.
  • App-Informationen: Benutzerdefinierte Feldergruppe, die für die Nachahmung von TrackState-/TrackAction-Analytics-Konzepten entwickelt wurde.

Erstellen eines Schemas

  1. Auswählen Schema erstellen.

  2. Im Auswählen einer Klasse Schritt des Schema erstellen Assistent, wählen Sie Erlebnisereignis darunter Basisklasse für dieses Schema auswählen.

  3. Klicken Sie auf Weiter.

    Basisklasse des Schema-Assistenten

  4. Im Name und Überprüfung Schritt des Schema erstellen Assistenten, geben Sie eine Anzeigename des Schemas, beispielsweise Luma Mobile Event Schema und Beschreibung, beispielsweise Schema for Luma mobile app experience events.

    note note
    NOTE
    Wenn Sie dieses Tutorial mit mehreren Personen in einer Sandbox durchlaufen oder ein freigegebenes Konto verwenden, sollten Sie erwägen, im Rahmen Ihrer Benennungskonventionen eine Identität anzuhängen oder vorzustellen. Beispiel: anstelle von Luma Mobile App Event Schema, verwenden Luma Mobile App Event Schema - Joe Smith. Siehe auch den Hinweis unter Übersicht.

  5. Auswählen Beenden , um den Assistenten abzuschließen.

    Name des Schemas und Überprüfung

  6. Auswählen Plus Hinzufügen neben Feldergruppen.

    Hinzufügen einer Feldergruppe

  7. Suchen Sie nach Consumer Experience Event.

  8. Auswählen Vorschau um eine Vorschau der Felder anzuzeigen und/oder die Beschreibung zu lesen, um weitere Details zu erhalten, bevor Sie eine Feldergruppe auswählen.

  9. Auswählen Ereignis für Kundenerlebnisse.

  10. Wählen Sie Feldergruppen hinzufügen aus.

    Feldgruppe auswählen

    Sie gelangen zurück zum Bildschirm zur Hauptschemakomposition, wo Sie alle verfügbaren Felder sehen können.

  11. Wählen Sie Speichern aus.

NOTE
Beachten Sie, dass nicht alle Felder einer Gruppe verwendet werden müssen. Sie können auch Felder entfernen, um das Schema kurz und verständlich zu halten. Wenn es hilfreich ist, können Sie sich ein Schema als leere Datenschicht vorstellen. In Ihrer App füllen Sie die entsprechenden Werte zum richtigen Zeitpunkt aus.

Die Ereignis für Kundenerlebnisse Feldergruppe hat einen Datentyp namens Webinformationen, der Ereignisse wie Seitenansichten und Link-Klicks beschreibt. Zum Zeitpunkt des Schreibens gibt es keine App-Parität für diese Funktion. Daher erstellen Sie Ihre eigene.

Erstellen eines benutzerdefinierten Datentyps

Erstellen Sie zunächst einen benutzerdefinierten Datentyp, der die beiden Ereignisse beschreibt:

  • Bildschirmansicht
  • App-Interaktion

  1. Wählen Sie die Datentypen Registerkarte.

  2. Auswählen Erstellen eines Datentyps.

    Datentypmenü auswählen

  3. Stellen Sie eine Anzeigename und Beschreibung, beispielsweise App Information und Custom data type describing "Screen Views" & "App Actions"

    Name und Beschreibung angeben

    note tip
    TIP
    Immer lesbar, beschreibend verwenden Anzeigenamen für Ihre benutzerdefinierten Felder verwenden, da diese Vorgehensweise Marketing-Experten den Zugriff darauf erleichtert, wenn die Felder in nachgelagerten Diensten wie dem Segment Builder angezeigt werden.

  4. Um ein Feld hinzuzufügen, wählen Sie die Plus Schaltfläche.

  5. Dieses Feld ist ein Container-Objekt für die App-Interaktion. Geben Sie daher eine Binnenmajuskel-Schreibweise an Feldname appInteraction, Anzeigename App Interactionund wählen Sie Object aus dem Typ Liste.

  6. Wählen Sie Anwenden aus.

    Hinzufügen eines neuen App-Aktionsereignisses

  7. Um zu messen, wie oft eine Aktion stattgefunden hat, fügen Sie ein Feld hinzu, indem Sie die Plus Schaltfläche neben appInteraction -Objekt, das Sie erstellt haben.

  8. Gib ihm ein Kamelgehäuse Feldname appAction, Anzeigename von App Action und Typ Measure.

    Dieser Schritt entspricht einem Erfolgsereignis in Adobe Analytics.

  9. Wählen Sie Anwenden aus.

    Feld für Aktionsnamen hinzufügen

  10. Fügen Sie ein Feld hinzu, das den Interaktionstyp beschreibt, indem Sie die Plus Schaltfläche neben appInteraction -Objekt.

  11. Geben Sie einen Feldname name, Anzeigename von Name und Typ String.

    Dieser Schritt entspricht einer Dimension in Adobe Analytics.

    Anwenden auswählen

  12. Scrollen Sie nach unten in der rechten Leiste und wählen Sie Anwenden.

  13. So erstellen Sie eine appStateDetails -Objekt, das Maßnahme Feld namens screenView und zwei Zeichenfolge Felder namens screenName und screenTypeführen Sie dieselben Schritte wie beim Erstellen der appInteraction -Objekt.

  14. Wählen Sie Speichern aus.

    Endgültiger Status des Datentyps

Benutzerdefinierte Feldergruppe hinzufügen

Fügen Sie nun mithilfe Ihres benutzerdefinierten Datentyps eine benutzerdefinierte Feldergruppe hinzu:

  1. Öffnen Sie das Schema, das Sie zuvor in dieser Lektion erstellt haben.

  2. Auswählen Plus Hinzufügen neben Feldergruppen.

    Neue Feldergruppe hinzufügen

  3. Wählen Sie Neue Feldergruppe erstellen aus.

  4. Stellen Sie eine Anzeigename und Beschreibung, beispielsweise App Interactions und Fields for app interactions.

  5. Wählen Sie Feldergruppen hinzufügen aus.

    Name und Beschreibung angeben

  6. Wählen Sie im Hauptkomprimierungsbildschirm die Option App-Interaktionen.

  7. Fügen Sie dem Stammverzeichnis des Schemas ein Feld hinzu, indem Sie die Plus neben dem Schemanamen.

  8. Geben Sie in der rechten Leiste einen Feldname von appInformation, a Anzeigename von App Informationund ein Typ von App Information.

  9. Auswählen App-Interaktionen aus dem Feldergruppe in der Dropdown-Liste, um die Felder Ihrer neuen Feldergruppe zuzuweisen.

  10. Wählen Sie Anwenden aus.

  11. Wählen Sie Speichern aus.

    Anwenden auswählen

NOTE
Benutzerdefinierte Feldergruppen werden immer unter Ihrer Experience Cloud-Organisationskennung platziert.
SUCCESS
Sie verfügen jetzt über ein Schema, das für den Rest des Tutorials verwendet werden kann.
Vielen Dank, dass Sie Ihre Zeit investiert haben, um mehr über das Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, ein allgemeines Feedback oder Vorschläge zu künftigen Inhalten teilen möchten, teilen Sie diese hier mit. Experience League Community-Diskussionsbeitrag.

Weiter: Erstellen Sie eine datastream

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b