Erstellen eines Schemas mit dem Schema Editor
In der Benutzeroberfläche von Adobe Experience Platform können Sie Experience Data Model (XDM)-Schemata in einer interaktiven visuellen Arbeitsfläche namens Schema Editor erstellen und verwalten. In diesem Tutorial wird beschrieben, wie Sie ein Schema mit dem Schema Editor erstellen.
Zu Demonstrationszwecken wird in diesem Tutorial ein Beispielschema erstellt, in dem die Mitglieder eines Kundentreueprogramms beschrieben werden. Sie können diese Schritte zwar verwenden, um ein anderes Schema für Ihre eigenen Zwecke zu erstellen, es wird jedoch empfohlen, zunächst das Beispielschema zu erstellen, um mehr über die Funktionen des Schema Editor zu erfahren.
NOTEErste Schritte
Dieses Tutorial erfordert ein Grundverständnis der verschiedenen Aspekte von Adobe Experience Platform, die mit der Schema-Erstellung verbunden sind. Bevor Sie mit diesem Tutorial beginnen, lesen Sie die Dokumentation für die folgenden Konzepte:
- Experience Data Model (XDM): Das standardisierte Framework, mit dem Kundenerlebnisdaten von Experience Platform organisiert werden.
- Grundlagen der Schema-Komposition: Eine Übersicht über XDM-Schemata und ihre Bausteine, einschließlich Klassen, Schemafeldgruppen, Datentypen und einzelner Felder.
- Real-Time Customer Profile: Bietet ein einheitliches Echtzeit-Kundenprofil, das auf aggregierten Daten aus verschiedenen Quellen basiert.
Öffnen des Arbeitsbereichs Schemata
Der Arbeitsbereich Schemata in der Experience Platform-Benutzeroberfläche bietet eine Visualisierung der Schema Library, mit der Sie die für Ihr Unternehmen verfügbaren Schemata anzeigen und verwalten können. Der Arbeitsbereich umfasst auch den Schema Editor, die Arbeitsfläche, in der Sie während dieses Tutorials ein Schema erstellen.
Wählen Sie nach der Anmeldung bei Experience Platform im linken Navigationsbereich die Option Schemata aus, um den Arbeitsbereich Schemata zu öffnen. Auf Registerkarte Durchsuchen“ wird eine Liste von Schemata (eine Darstellung der Schema Library) angezeigt, die Sie anzeigen und anpassen können. Die Liste umfasst den Namen, den Typ, die Klasse und das Verhalten (Datensatz oder Zeitreihen), auf denen das Schema basiert, sowie das Datum und die Uhrzeit der letzten Änderung des Schemas.
Weitere Informationen finden Sie im Handbuch zu Erkunden vorhandener XDM-Ressourcen in der Benutzeroberfläche.
Erstellen und Benennen eines Schemas
Um mit dem Erstellen eines Schemas zu beginnen wählen Sie Schema erstellen) in der oberen rechten Ecke des Arbeitsbereichs Schemas aus.
Das Erstellen eines Schemas wird angezeigt. In diesem Dialogfeld können Sie entweder manuell ein Schema erstellen, indem Sie Felder und Feldergruppen hinzufügen, oder Sie können eine CSV-Datei hochladen und ML-Algorithmen verwenden, um ein Schema zu generieren. Wählen Sie im Dialogfeld einen Workflow zur Schemaerstellung aus.
Beta Manuelle oder ML-unterstützte Schemaerstellung
Informationen dazu, wie Sie einen ML-Algorithmus verwenden können, um eine Schemastruktur basierend auf einer hochgeladenen Datei zu empfehlen, finden Sie im Handbuch zur Erstellung von Schemata durch maschinelles Lernen. Dieses Handbuch für die Benutzeroberfläche konzentriert sich auf den Workflow zur manuellen Erstellung.
Basisklasse wählen
Der Schema erstellen wird angezeigt. Wählen Sie als Nächstes eine Basisklasse für das Schema. Sie können zwischen den Kernklassen von XDM Individual Profile und XDM ExperienceEvent oder Other wählen, wenn diese Klassen nicht für Ihre Zwecke geeignet sind. Die Option Sonstige-Klassen ermöglicht es Ihnen, entweder eine neue Klasse zu erstellen oder aus anderen bereits vorhandenen Klassen auszuwählen.
Weitere Informationen zu diesen Klassen finden Sie in Dokumentation XDM Individual Profile🔗 und XDM ExperienceEvent . Wählen Sie für die Zwecke dieses Tutorials die Option Individuelles XDM-Profil gefolgt von Weiter aus.
Benennen und überprüfen
Nachdem Sie eine Klasse ausgewählt haben, wird der Abschnitt Name und Überprüfung angezeigt. In diesem Abschnitt geben Sie einen Namen und eine Beschreibung ein, um Ihr Schema zu identifizieren. Bei der Entscheidung über einen Namen für Ihr Schema sind einige wichtige Aspekte zu beachten:
- Schemanamen sollten kurz und beschreibend sein, damit das Schema später leicht gefunden werden kann.
- Die Namen der Schemas müssen eindeutig sein, d. h. sie sollten so spezifisch sein, dass sie in Zukunft nicht wiederverwendet werden. Wenn Ihr Unternehmen z. B. über separate Loyalitätsprogramme für verschiedene Marken verfügt, wäre es ratsam, Ihr Schema mit „Loyalitätsmitglieder, Marke A“ zu benennen, damit Sie dieses leicht von anderen Loyalitätsschemata unterscheiden können, die Sie u. U. später definieren.
- Sie können die Schemabeschreibung auch verwenden, um zusätzliche kontextuelle Informationen zum Schema bereitzustellen.
In diesem Tutorial wird ein Schema zur Aufnahme von Daten über die Mitglieder eines Treueprogramms zusammengestellt. Daher heißt das Schema „Loyalty Members“.
Die Basisstruktur des Schemas (bereitgestellt von der Klasse) wird auf der Arbeitsfläche angezeigt, damit Sie Ihre ausgewählte Klasse und Schemastruktur überprüfen und überprüfen können.
Geben Sie im Textfeld einen benutzerfreundlichen Anzeigenamen Schemas“ ein. Geben Sie als Nächstes eine geeignete Beschreibung ein, um Ihr Schema zu identifizieren. Wenn Sie Ihre Schemastruktur überprüft haben und mit Ihren Einstellungen zufrieden sind, wählen Sie Beenden aus, um Ihr Schema zu erstellen.
Erstellen eines Schemas
Der Schema Editor wird angezeigt. Dies ist die Arbeitsfläche, auf der Sie Ihr Schema zusammenstellen. Das selbstbetitelte Schema wird automatisch im Abschnitt Struktur der Arbeitsfläche erstellt, wenn Sie den Editor aufrufen, zusammen mit den Standardfeldern, die in der von Ihnen ausgewählten Basisklasse enthalten sind. Die zugewiesene Klasse für das Schema wird auch im Abschnitt Komposition unter Klasse aufgelistet.
NOTE
NOTEHinzufügen einer Feldergruppe
Sie können nun beginnen, Ihrem Schema Felder hinzuzufügen, indem Sie Feldergruppen hinzufügen. Eine Feldergruppe ist eine Gruppe aus einem oder mehreren Feldern, die häufig zusammen zur Beschreibung eines bestimmten Konzepts verwendet werden. In diesem Tutorial werden Feldergruppen verwendet, um die Mitglieder des Treueprogramms zu beschreiben und wichtige Informationen wie Name, Geburtsdatum, Telefonnummer, Adresse usw. zu erfassen.
Um eine Feldergruppe hinzuzufügen, wählen Sie im Unterabschnitt Feldergruppen die Option Hinzufügen aus.
Es wird ein neues Dialogfeld mit einer Liste der verfügbaren Feldergruppen angezeigt. Jede Feldergruppe ist nur für die Verwendung mit einer bestimmten Klasse vorgesehen. Daher listet das Dialogfeld nur Feldergruppen auf, die mit der ausgewählten Klasse kompatibel sind (in diesem Fall die Klasse XDM Individual Profile). Wenn Sie eine XDM-Standardklasse verwenden, wird die Liste der Feldergruppen basierend auf der Nutzungshäufigkeit intelligent sortiert.
Sie können in der linken Leiste einen der Filter auswählen, um die Liste der Standardfeldgruppen auf bestimmte Branchen wie Einzelhandel, Finanzdienstleistungen und Gesundheitswesen einzugrenzen.
Wenn Sie eine Feldergruppe aus der Liste auswählen, wird sie in der rechten Leiste angezeigt. Sie können bei Bedarf mehrere Feldergruppen auswählen und jede Feldergruppe zur Liste in der rechten Leiste hinzufügen, bevor Sie den Vorgang bestätigen. Darüber hinaus wird rechts neben der aktuell ausgewählten Feldgruppe ein Symbol angezeigt, über das Sie die Struktur der darin enthaltenen Felder in einer Vorschau anzeigen können.
Bei der Vorschau einer Feldergruppe wird in der rechten Leiste eine detaillierte Beschreibung des Schemas der Feldergruppe bereitgestellt. Sie können auch durch die Felder der Feldergruppe in der bereitgestellten Arbeitsfläche navigieren. Wenn Sie verschiedene Felder auswählen, wird die rechte Leiste aktualisiert, um Details zum betreffenden Feld anzuzeigen. Wählen Sie Zurück aus, wenn Sie mit der Vorschau fertig sind, um zum Dialogfeld für die Feldergruppenauswahl zurückzukehren.
Wählen Sie für dieses Tutorial die Feldergruppe Demografische Details und dann Feldergruppe hinzufügen aus.
Die Arbeitsfläche des Schemas wird wieder angezeigt. Im Abschnitt Feldergruppen wird jetzt „Demografische Details“ aufgeführt, und der Abschnitt Struktur enthält die von der Feldergruppe bereitgestellten Felder. Sie können den Namen der Feldergruppe unter dem Abschnitt Feldergruppen auswählen, um die spezifischen Felder hervorzuheben, die auf der Arbeitsfläche bereitgestellt werden.
NOTE
Diese Feldergruppe stellt mehrere Felder unter dem übergeordneten Namen person mit dem Datentyp „Person“ bereit. Diese Gruppe von Feldern beschreibt Informationen zu einer Person, einschließlich Name, Geburtsdatum und Geschlecht.
NOTEBeachten Sie, dass das Feld name den Datentyp „Vollständiger Name“ aufweist, d. h., es beschreibt auch ein gemeinsames Konzept und enthält namensbezogene Unterfelder wie Vorname, Nachname, Höflichkeits- oder Ehrentitel und Suffix.
Wählen Sie verschiedene Felder auf der Arbeitsfläche aus, um weitere Felder anzuzeigen, die sie für die Schemastruktur bereitstellen.
Hinzufügen weiterer Feldergruppen
Sie können jetzt dieselben Schritte wiederholen, um eine weitere Feldergruppe hinzuzufügen. Dieses Mal sehen Sie im Dialogfeld Feldergruppe hinzufügen, dass die Feldergruppe „Demografische Details“ ausgegraut ist und das Kontrollkästchen daneben nicht ausgewählt werden kann. Dadurch wird verhindert, dass Feldergruppen, die bereits in Ihrem aktuellen Schema enthalten sind, versehentlich dupliziert werden.
Wählen Sie für dieses Tutorial die Standardfeldgruppen Persönliche Kontaktdaten und Treuedetails aus der Liste und dann Feldergruppen hinzufügen aus, um sie dem Schema hinzuzufügen.
Die Arbeitsfläche wird erneut mit den hinzugefügten Feldergruppen, die im Abschnitt Komposition unter Feldergruppen aufgelistet sind, und deren verbundenen Feldern, die der Schemastruktur hinzugefügt wurden, angezeigt.
Definieren einer benutzerdefinierten Feldergruppe
Das Schema Mitglieder des Treueprogramms soll Daten erfassen, die sich auf die Mitglieder eines Treueprogramms beziehen, und die Standardfeldgruppe Treuedetails, die Sie zum Schema hinzugefügt haben, enthält die meisten davon, darunter Programmtyp, Punkte, Beitrittsdatum usw.
Es kann jedoch vorkommen, dass Sie für Anwendungsfälle zusätzliche benutzerdefinierte Felder hinzufügen möchten, die nicht von Standardfeldgruppen abgedeckt werden. Beim Hinzufügen benutzerdefinierter Treuefelder haben Sie zwei Möglichkeiten:
- Erstellen einer neuen benutzerdefinierten Feldergruppe, um diese Felder zu erfassen. Dies ist die Methode, die in diesem Tutorial behandelt wird.
- Erweitern der Standardfeldgruppe Treuedetails mit benutzerdefinierten Feldern. Dies führt dazu, dass Treuedetails in eine benutzerdefinierte Feldergruppe konvertiert wird und dass die ursprüngliche Standardfeldgruppe nicht mehr verfügbar ist. Im Handbuch für die Benutzeroberfläche Schemata finden Sie weitere Informationen zum Hinzufügen benutzerdefinierter Felder zur Struktur von Standardfeldgruppen.
Um eine neue Feldergruppe zu erstellen, wählen Sie wie zuvor im Unterabschnitt Feldergruppen die Option Hinzufügen aus. Aber dieses Mal wählen Sie am oberen Rand des angezeigten Dialogfelds die Option Neue Feldergruppe erstellen aus. Anschließend werden Sie aufgefordert, einen Anzeigenamen und eine Beschreibung für die neue Feldergruppe anzugeben. Nennen Sie für dieses Tutorial die neue Feldergruppe „Custom Loyalty Details“ und wählen Sie dann Feldergruppen hinzufügen aus.
NOTE„Custom Loyalty Details“ sollte jetzt auf der linken Seite der Arbeitsfläche unter Feldergruppe angezeigt werden. Es sind jedoch noch keine Felder damit verknüpft und daher werden keine neuen Felder unter Struktur angezeigt.
Hinzufügen von Feldern zur Feldergruppe
Nachdem Sie jetzt die Feldergruppe „Custom Loyalty Details“ erstellt haben, können Sie die Felder definieren, die die Feldergruppe für das Schema bereitstellen wird.
Wählen Sie zunächst das Symbol Plus (+) neben dem Namen des Schemas auf der Arbeitsfläche.
Der Platzhalter „Nicht benanntes Feld“ wird auf der Arbeitsfläche angezeigt, und die rechte Leiste wird aktualisiert, um Konfigurationsoptionen für das Feld anzuzeigen.
In diesem Szenario muss das Schema über ein Feld vom Typ „Objekt“ verfügen, das die aktuelle Treuestufe der Person detailliert beschreibt. Beginnen Sie mit der Erstellung eines Felds loyaltyTier vom Typ „Objekt“, das zum Speichern Ihrer verwandten Felder verwendet wird.
Unter Zuweisen zu müssen Sie eine Feldergruppe auswählen, der das Feld zugewiesen werden soll. Denken Sie daran, dass alle Schemafelder entweder zu einer Klasse oder zu einer Feldergruppe gehören. Da dieses Schema eine Standardklasse verwendet, besteht die einzige Option darin, eine Feldergruppe auszuwählen. Geben Sie zunächst den Namen „Custom Loyalty Details“ ein und wählen Sie dann die Feldergruppe aus der Liste aus.
Wenn Sie fertig sind, wählen Sie Anwenden aus.
Die Änderungen werden angewandt, und das neu erstellte loyaltyTier-Objekt wird angezeigt. Da es sich hierbei um ein benutzerdefiniertes Feld handelt, wird es automatisch in einem Objekt mit einem Namespace entsprechend der Mandanten-ID Ihrer Organisation und vorangestelltem Unterstrich verschachtelt (_tenantId in diesem Beispiel).
NOTEWählen Sie das Symbol Plus (+) neben dem loyaltyTier-Objekt aus, um mit dem Hinzufügen von Unterfeldern zu beginnen. Ein Platzhalter für ein neues Feld wird angezeigt, und rechts auf der Arbeitsfläche ist der Abschnitt Feldeigenschaften sichtbar.
Für jedes Feld sind die folgenden Informationen erforderlich:
- Feldname: Der Name des Felds, vorzugsweise in Binnenmajuskel-Schreibweise geschrieben. Leerzeichen sind nicht zulässig. Dies ist der Name, der verwendet wird, um auf das Feld im Code und in anderen nachgelagerten Anwendungen zu verweisen.
- Beispiel: LoyalitätsStufe
- Anzeigename: Der Name des Felds, mit Großschreibung des ersten Buchstaben jedes Worts. Dies ist der Name, der auf der Arbeitsfläche erscheint, wenn das Schema angezeigt oder bearbeitet wird.
- Beispiel: Loyalitäts-Stufe
- Typ: Der Datentyp des Felds. Dazu gehören grundlegende Skalartypen und alle Datentypen, die in der Schema Registry definiert sind. Beispiele: Zeichenfolge, Ganzzahl, Boolescher Wert, Person, Adresse, Telefonnummer usw.
- Beschreibung: Eine optionale Beschreibung des Felds mit maximal 200 Zeichen sollte enthalten sein.
Das erste Feld für das loyaltyTier-Objekt ist eine Zeichenfolge mit der Bezeichnung id, die die ID der aktuellen Stufe des Mitglieds des Treueprogramms darstellt. Die Stufen-ID ist für jedes Mitglied des Treueprogramms eindeutig, da dieses Unternehmen für jede Kundin und jeden Kunden basierend auf verschiedenen Faktoren unterschiedliche Punkteschwellenwerte für die Treuestufe festlegt. Wenn Sie den Typ des neuen Felds auf "String" festgelegt haben, werden im Abschnitt Feldeigenschaften mehrere Optionen zum Anwenden von Einschränkungen angezeigt, darunter „Standardwert“, „Format“ und „Maximale Länge“. Weitere Informationen finden Sie in der Dokumentation Best Practices für Datenvalidierungsfelder .
Da id eine zufällig generierte Freiformzeichenfolge ist, sind keine weiteren Einschränkungen erforderlich. Wählen Sie Übernehmen, um Ihre Änderungen anzuwenden.
