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.
HINWEISErste 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 Schemas Arbeitsbereichs
Der Arbeitsbereich Schemas 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 Schemas aus, um den Schemas Arbeitsbereich zu öffnen. Auf der Registerkarte Browse 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 (Eintrag 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 oben rechts im Arbeitsbereich Create schema die Option Schemas aus.
Das Dialogfeld Create a schema 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 Create schema Workflow wird angezeigt. Wählen Sie als Nächstes eine Basisklasse für das Schema. Sie können zwischen den Kernklassen XDM Individual Profile und XDM ExperienceEvent wählen oder Other, wenn diese Klassen nicht für Ihre Zwecke geeignet sind. Mit der Option Klassen Other können Sie entweder eine neue Klasse erstellen oder aus anderen bereits vorhandenen Klassen auswählen.
Weitere Informationen zu diesen Klassen finden Sie in der Dokumentation zu XDM individual profile und XDM ExperienceEvent . Wählen Sie für die Zwecke dieses Tutorials XDM Individual Profile gefolgt von Next aus.
Benennen und überprüfen
Nachdem Sie eine Klasse ausgewählt haben, wird der Abschnitt Name and review 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 Treueprogramme für verschiedene Marken verfügt, wäre es ratsam, Ihr Schema mit „Treuemitglieder, Marke A“ zu benennen, damit Sie dieses leicht von anderen Treueschemata 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 eine benutzerfreundliche Schema display name in das Textfeld 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 Finish 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 Structure 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 unter Class in Composition Abschnitt aufgeführt.
HINWEIS
HINWEISHinzufü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 Add im Unterabschnitt Field groups 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 Back 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 Demographic Details und dann Add field group aus.
Die Arbeitsfläche des Schemas wird wieder angezeigt. Im Abschnitt Field groups wird jetzt "Demographic Details" aufgeführt, und der Abschnitt Structure enthält die von der Feldergruppe bereitgestellten Felder. Sie können den Namen der Feldergruppe unter dem Abschnitt Field groups auswählen, um die spezifischen Felder hervorzuheben, die auf der Arbeitsfläche bereitgestellt werden.
HINWEIS
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.
HINWEISBeachten Sie, dass das Feld name den Datentyp "Full 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 Add field group-Dialogfeld, dass die Feldergruppe "Demographic 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 Personal Contact Details und Loyalty Details aus der Liste und dann Add field groups aus, um sie zum Schema hinzuzufügen.
Die Arbeitsfläche wird erneut mit den hinzugefügten Feldergruppen, die im Abschnitt Field groups unter Composition aufgelistet sind, und deren verbundenen Feldern, die der Schemastruktur hinzugefügt wurden, angezeigt.
Definieren einer benutzerdefinierten Feldergruppe
Das Loyalty Members-Schema dient zur Erfassung von Daten, die sich auf die Mitglieder eines Treueprogramms beziehen, und die Standardfeldgruppe Loyalty Details , 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 Loyalty Details mit benutzerdefinierten Feldern. Dies führt dazu, dass Loyalty Details in eine benutzerdefinierte Feldergruppe konvertiert wird und die ursprüngliche Standardfeldergruppe nicht mehr verfügbar ist. Weitere Informationen finden Sie im Handbuch zur Schemas-Benutzeroberfläche Hinzufügen benutzerdefinierter Felder zur Struktur von Standardfeldgruppen.
Um eine neue Feldergruppe zu erstellen, wählen Sie wie zuvor im Add Unterabschnitt Field groups aus. Aber dieses Mal wählen Sie Create New Field group am oberen Rand des angezeigten Dialogfelds 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 Add field groups aus.
HINWEIS"Custom Loyalty Details" sollte jetzt auf der linken Seite der Arbeitsfläche unter "Field groups" angezeigt werden. Es sind jedoch noch keine Felder damit verknüpft und daher werden keine neuen Felder unter "Structure" 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.
Ein Platzhalter "Untitled Field" 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 loyaltyTier Felds vom Typ "Object", das zum Speichern Ihrer verwandten Felder verwendet wird.
Unter Assign to 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 Apply 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).
HINWEISWä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 Field properties sichtbar.
Für jedes Feld sind die folgenden Informationen erforderlich:
- Field Name: 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: TreueStufe
- Display Name: 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: Treue-Stufe
- Type: Der Datentyp des Felds. Dazu gehören grundlegende Skalartypen und alle Datentypen, die in der Schema Registry definiert sind. Beispiele: String, Integer, Boolean, Person, Address, Phone number usw.
- Description: 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 Field properties 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 Apply aus, um Ihre Änderungen anzuwenden.
