DokumentationExperience PlatformTutorial für Mobile Apps

Erstellen eines XDM-Schemas

Last update: Thu Oct 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Einsteiger
  • Fortgeschrittener
  • Entwickler

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

Schemata 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. Schemata bestehen aus einer Basisklasse und keiner oder mehreren Schema-Feldergruppen.

Weitere Informationen zum Schema-Kompositionsmodell, einschließlich Designprinzipien und Best Practices, finden Sie in den Grundlagen der Schemakomposition oder der Wiedergabeliste 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. Weitere Informationen finden Sie im Dokument Erstellen und Verwalten einer Lösungs-Design-Referenz (SDR) .

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 der 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. Öffnen Sie den App-Umschalter App-Umschalter (oben rechts),

  4. Wählen Sie Datenerfassung aus dem Menü aus.

    Anmelden bei Experience Cloud

    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. Wählen Sie in der linken Leiste unter Data Management die Option Schemas aus.

    Startbildschirm der Tags

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 in Klassen oder Feldergruppen wie einfache literale Felder als Referenzfeldtypen verwendet.

Die obigen Beschreibungen geben einen Überblick auf hoher Ebene. Weitere Informationen finden Sie im Video Schema-Bausteine oder lesen Sie 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.

  • Consumer Experience Event: Vordefinierte Feldergruppe mit vielen gemeinsamen Feldern.
  • App-Informationen: Benutzerdefinierte Feldergruppe, die entwickelt wurde, um TrackState-/TrackAction-Analytics-Konzepte zu imitieren.

Erstellen eines Schemas

  1. Wählen Sie Schema erstellen aus.

  2. Wählen Sie im Schritt Select a class des Assistenten Create schema die Option Experience Event unter Select a base class for this schema.

  3. Klicken Sie auf Weiter.

    Basisklasse des Schema-Assistenten

  4. Geben Sie im Schritt Name und Überprüfung des Assistenten Schema erstellen einen Anzeigenamen des Schemas ein, z. B. Luma Mobile Event Schema und einen Beschreibung, z. B. 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. Verwenden Sie beispielsweise anstelle von Luma Mobile App Event Schema Luma Mobile App Event Schema - Joe Smith. Siehe auch den Hinweis unter Überblick.

  5. Wählen Sie Beenden aus, um den Assistenten abzuschließen.

    Name und Überprüfung des Schemas

  6. Wählen Sie Plus Hinzufügen neben Feldergruppen aus.

    Hinzufügen einer Feldergruppe

  7. Suchen Sie nach Consumer Experience Event.

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

  9. Wählen Sie Consumer Experience Event aus.

  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 Feldergruppe Consumer Experience Event enthält den Datentyp Web information , 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 Registerkarte Datentypen aus.

  2. Wählen Sie Datentyp erstellen aus.

    Auswählen des Datentypmenüs

  3. Geben Sie einen Anzeigenamen und Beschreibung an, z. B. App Information und Custom data type describing "Screen Views" & "App Actions"

    Name und Beschreibung angeben

    note tip
    TIP
    Verwenden Sie immer lesbare, beschreibende Anzeigenamen für Ihre benutzerdefinierten Felder, da diese Vorgehensweise Marketern den Zugriff auf sie erleichtert, wenn die Felder in nachgelagerten Diensten wie dem Segment-Builder angezeigt werden.

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

  5. Dieses Feld ist ein Container-Objekt für App-Interaktionen. Geben Sie daher Feldname appInteraction, Anzeigename App Interaction in Binnenmajuskel ein und wählen Sie Object aus der Liste Typ aus.

  6. Wählen Sie Anwenden aus.

    Hinzufügen des neuen App-Aktionsereignisses

  7. Um zu messen, wie oft eine Aktion aufgetreten ist, fügen Sie ein Feld hinzu, indem Sie die Schaltfläche Plus neben dem von Ihnen erstellten Objekt appInteraction auswählen.

  8. Geben Sie ihr die Groß-/Kleinschreibung 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 Schaltfläche Plus neben dem Objekt appInteraction auswählen.

  11. Geben Sie ihr den Feldnamen name, den Anzeigenamen von Name und den 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 aus.

  13. Um ein appStateDetails -Objekt zu erstellen, das ein Measure -Feld namens screenView und zwei String -Felder namens screenName und screenType enthält, führen Sie dieselben Schritte wie beim Erstellen des appInteraction -Objekts aus.

  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. Wählen Sie Plus Hinzufügen neben Feldergruppen aus.

    Hinzufügen neuer Feldergruppen

  3. Wählen Sie Neue Feldergruppe erstellen aus.

  4. Geben Sie einen Anzeigenamen und Beschreibung an, z. B. App Interactions und Fields for app interactions.

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

    Name und Beschreibung angeben

  6. Wählen Sie im Bildschirm "Hauptkomposition"die Option *App-Interaktionen.

  7. Fügen Sie dem Stammverzeichnis des Schemas ein Feld hinzu, indem Sie neben dem Schemanamen die Schaltfläche Plus auswählen.

  8. Geben Sie in der rechten Leiste einen Feldnamen von appInformation, einen Anzeigenamen von App Information und einen Typ von App Information ein.

  9. Wählen Sie App-Interaktionen aus der Dropdown-Liste Feldergruppe aus, 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, allgemeine Rückmeldungen oder Anregungen zu zukünftigen Inhalten haben möchten, teilen Sie diese in diesem Experience League Community-Diskussionbeitrag mit.

Weiter: Erstellen eines Datastream

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