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.

NOTE
Wenn Sie CSV-Daten in Experience Platform aufnehmen, können Sie diese Daten einem XDM-Schema zuordnen, das durch KI-generierte Empfehlungen erstellt wurde (derzeit in der Beta-Phase), ohne das Schema manuell selbst erstellen zu müssen.
Wenn Sie lieber ein Schema mit der Schema Registry-API erstellen möchten, lesen Sie zunächst das Schema Registry Entwicklerhandbuch, bevor Sie das Tutorial Erstellen eines Schemas mithilfe der API angehen.

Erste 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 browse

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 create

Um mit dem Erstellen eines Schemas zu beginnen, wählen Sie oben rechts im Arbeitsbereich Create schema die Option Schemas aus.

Die Registerkarte Schemas Workspace-Browse mit hervorgehobenem Create schema.

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.

Das Dialogfeld „Schema erstellen“ mit den Workflow-Optionen und hervorgehobener Auswahl.

[Beta]{class="badge informative"} Manuelle oder ML-unterstützte Schemaerstellung manual-or-assisted

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 choose-a-class

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.

Der Create schema-Workflow mit den XDM individual profile Optionen und Next hervorgehobenen Optionen.

Benennen und überprüfen name-and-review

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.

Der Name and review Abschnitt des Create schema-Workflows mit Hervorhebung von Schema display name, Description und Finish.

Erstellen eines Schemas compose-your-schema

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.

NOTE
Sie können den Anzeigenamen und die optionale Beschreibung für das Schema über die Schema properties Seitenleiste aktualisieren. Sobald ein neuer Name eingegeben wurde, wird die Arbeitsfläche automatisch aktualisiert, um den neuen Namen des Schemas widerzuspiegeln.

Der Schema-Editor mit hervorgehobener Basisklasse und hervorgehobenem Schemadiagramm.

NOTE
Sie können die Klasse eines Schemas während des anfänglichen Kompositionsprozesses jederzeit ändern, bevor das Schema gespeichert wird. Dies sollte jedoch mit größter Vorsicht geschehen. Feldergruppen sind nur mit bestimmten Klassen kompatibel. Daher werden die Arbeitsfläche und alle von Ihnen hinzugefügten Felder beim Ändern der Klasse zurückgesetzt.

Hinzufügen einer Feldergruppe field-group

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.

Der Schema-Editor mit der hervorgehobenen Schaltfläche „Feldergruppen hinzufügen“.

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.

Der Add field groups-Dialog.

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.

Der Add field groups Dialog mit den branchenspezifischen Feldergruppen ist hervorgehoben.

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.

Das Dialogfeld Add field groups mit hervorgehobenem Vorschausymbol für die ausgewählte Feldergruppe.

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.

Vorschau des Preview field group Dialogfelds mit der Feldergruppe „Demografische Details“.

Wählen Sie für dieses Tutorial die Feldergruppe Demographic Details und dann Add field group aus.

Das Dialogfeld Add field groups mit ausgewählter Feldergruppe „Demografische Details“ und hervorgehobener Add field groups.

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.

Der Schema-Editor mit den hervorgehobenen Feldergruppen „Demografische Details“.

NOTE
Innerhalb des Schema-Editors werden Standardklassen (Adobe-generiert) und Feldergruppen mit dem Schlosssymbol ( Vorhängeschloss-Symbol) gekennzeichnet. . Das Vorhängeschloss wird in der linken Leiste neben dem Namen der Klasse oder Feldergruppe sowie neben einem beliebigen Feld im Schemadiagramm angezeigt, das Teil einer systemgenerierten Ressource ist.
Der Schema-Editor mit hervorgehobenem Vorhängeschloss-Symbol

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.

NOTE
Denken Sie daran, dass Felder Skalartypen (z. B. Zeichenfolge, Ganzzahl, Array oder Datum) sowie beliebige Datentypen (eine Feldergruppe, die ein gemeinsames Konzept darstellt) in der Schema Registry verwenden können.

Beachten 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 field-group-2

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.

Das Dialogfeld Add field groups mit zwei ausgewählten und Add field groups hervorgehobenen neuen Feldergruppen.

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.

Der Schema-Editor mit der hervorgehobenen neuen zusammengesetzten Schemastruktur.

Definieren einer benutzerdefinierten Feldergruppe define-field-group

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:

  1. Erstellen einer neuen benutzerdefinierten Feldergruppe, um diese Felder zu erfassen. Dies ist die Methode, die in diesem Tutorial behandelt wird.
  2. 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.

Das Dialogfeld Add field groups mit Hervorhebung von Create new field group, Display name und Description.

NOTE
Wie bei Klassennamen sollte der Name der Feldergruppe kurz und einfach sein und beschreiben, was die Feldergruppe zum Schema beiträgt. Auch diese sind eindeutig, sodass Sie den Namen nicht wiederverwenden können und daher sicherstellen müssen, dass er spezifisch genug ist.

"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 field-group-fields

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 Schema-Editor mit dem hervorgehobenen Pluszeichen.

Ein Platzhalter "Untitled Field" wird auf der Arbeitsfläche angezeigt, und die rechte Leiste wird aktualisiert, um Konfigurationsoptionen für das Feld anzuzeigen.

Der Schema-Editor mit einem Untitled Field und hervorgehobenem Field properties.

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.

Der Schema-Editor mit dem hervorgehobenen Objekt „Treuestufe“ Field properties dem Schema hinzugefügt.

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

Der Schema-Editor mit der im Schemadiagramm hervorgehobenen Mandanten-ID und Treuestufe.

NOTE
Das Vorhandensein des Mandanten-ID-Objekts bedeutet, dass die Felder, die Sie hinzufügen, im Namespace Ihres Unternehmens enthalten sind.
Anders ausgedrückt: Die Felder, die Sie hinzufügen, sind für Ihre Organisation einzigartig und werden in der Schema Registry in einem bestimmten Bereich, der nur für Ihre Organisation zugänglich ist, gespeichert. Felder, die Sie definieren, müssen Ihrem Mandanten-Namespace immer hinzugefügt werden, um Konflikte mit Namen anderer Standardklassen, Feldergruppen, Datentypen und Felder zu verhindern.

Wä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.

Der Schema-Editor mit der Mandanten-ID und dem neuen Unterfeld wurde zur Treuestufe im Schemadiagramm hinzugefügt.

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 .

Der Schema-Editor mit den hervorgehobenen Feldeigenschaftswerten für das neue ID-Feld.

Da id eine zufällig generierte Freiformzeichenfolge ist, sind keine weiteren Einschränkungen erforderlich. Wählen Sie Apply aus, um Ihre Änderungen anzuwenden.

Der Schema-Editor mit hinzugefügtem und hervorgehobenem ID-Feld.

Hinzufügen weiterer Felder zur Feldergruppe field-group-fields-2

Nachdem Sie jetzt das Feld id hinzugefügt haben, können Sie zusätzliche Felder hinzufügen, um auf die Treuestufe bezogene Informationen zu erfassen, z. B.:

  • Aktueller Punkteschwellenwert (Ganzzahl): Die Mindestanzahl von Treuepunkten, die das Mitglied haben muss, um in der aktuellen Stufe zu bleiben.
  • Punkteschwellenwert für nächste Stufe (Ganzzahl): Die Anzahl der Treuepunkte, die das Mitglied sammeln muss, um die nächste Stufe zu erreichen.
  • Wirksamwerden (Datum/Uhrzeit): Der Zeitpunkt, zu dem das Mitglied des Treueprogramms diese Stufe erreicht hat.

Um jedes Feld zum Schema hinzuzufügen, wählen Sie das Symbol Plus (+) neben dem loyalty-Objekt aus und geben Sie die erforderlichen Informationen ein.

Nach Fertigstellung enthält das loyaltyTier-Objekt Felder für id, currentThreshold, nextThreshold und effectiveDate.

Der Schema-Editor mit dem hervorgehobenen Objekt „Treuestufe“.

Hinzufügen eines Aufzählungsfelds zur Feldergruppe enum

Beim Definieren von Feldern im Schema Editor gibt es einige zusätzliche Optionen, die Sie auf einfache Feldtypen anwenden können, um weitere Einschränkungen für die Daten, die das Feld enthalten kann, bereitzustellen. Die Anwendungsfälle für diese Einschränkungen werden in der folgenden Tabelle erläutert:

Beschränkung
Beschreibung
Required
Gibt an, dass das Feld für die Datenaufnahme erforderlich ist. Daten, die auf Grundlage dieses Schemas in einen Datensatz hochgeladen wurden und dieses Feld nicht enthalten, schlagen bei der Aufnahme fehl.
Array
Gibt an, dass das Feld ein Array von Werten jeweils mit dem angegebenen Datentyp enthält. Verwenden Sie diese Einschränkung beispielsweise für ein Feld mit dem Datentyp "String", gibt dies an, dass das Feld ein Zeichenfolgen-Array enthält.
Enum & Suggested Values
Eine Aufzählung gibt an, dass dieses Feld einen der Werte aus einer Aufzählungsliste möglicher Werte enthalten muss. Als Alternative können Sie diese Option auch verwenden, um nur eine Liste der empfohlenen Werte für ein Zeichenfolgenfeld bereitzustellen, ohne das Feld auf diese Werte zu beschränken.
Identity
Gibt an, dass dieses Feld ein Identitätsfeld ist. Weitere Informationen zu Identitätsfeldern finden Sie weiter unten in diesem Tutorial.
Relationship
Während Schemabeziehungen durch die Verwendung des Vereinigungsschemas und Real-Time Customer Profile abgeleitet werden können, gilt dies nur für Schemata einer gemeinsamen Klasse. Die Relationship Einschränkung gibt an, dass dieses Feld auf die primäre Identität eines Schemas verweist, das auf einer anderen Klasse basiert, was eine Beziehung zwischen den beiden Schemas impliziert. Weiterführende Informationen finden Sie im Tutorial zum Definieren von Beziehungen.
NOTE
Alle erforderlichen Identitäts- oder Beziehungsfelder werden in den entsprechenden Abschnitten in der linken Leiste aufgelistet, sodass Sie diese Felder unabhängig von der Komplexität des Schemas problemlos finden können.

In diesem Tutorial erfordert das loyaltyTier-Objekt im Schema ein neues Aufzählungsfeld, das die Stufenklasse beschreibt, wobei der Wert nur eine von vier möglichen Optionen sein kann. Um dieses Feld zum Schema hinzuzufügen, wählen Sie das Symbol plus (+) neben dem loyaltyTier aus und füllen Sie die erforderlichen Felder für Field name und Display name aus. Wählen Sie Type "String" aus.

Der Schema-Editor mit dem hinzugefügten Klassenobjekt „Ebene“ und hervorgehobener Field properties.

Zusätzliche Kontrollkästchen werden für das Feld angezeigt, nachdem der Typ ausgewählt wurde, einschließlich der Kontrollkästchen für Array, Enum & Suggested Values, Identity und Relationship.

Aktivieren Sie das Kontrollkästchen Enum & Suggested Values und klicken Sie dann auf Enum. Hier können Sie die Value (in Binnenmajuskel-Schreibweise) und Display Name (einen optionalen, leserfreundlichen Namen mit Großschreibung des jeweils ersten Buchstaben eines Worts) für jede akzeptable Treuestufe eingeben.

Wählen Sie nach Festlegung aller Feldeigenschaften Apply aus, um das tierClass Feld zum loyaltyTier hinzuzufügen.

Die Feldeigenschaften „Aufzählung“ und „Werte vorschlagen“ mit hervorgehobener Apply.

Konvertieren eines Objekts mit mehreren Feldern in einen Datentyp datatype

Das loyaltyTier-Objekt enthält jetzt mehrere Felder und stellt eine gemeinsame Datenstruktur dar, die in anderen Schemata nützlich sein könnte. Der Schema Editor ermöglicht Ihnen das einfache Anwenden wiederverwendbarer Objekte mit mehreren Feldern durch Konvertieren der Struktur dieser Objekte in Datentypen.

Datentypen ermöglichen den konsistenten Einsatz von Strukturen mit mehreren Feldern und bieten mehr Flexibilität als eine Feldergruppe, da sie überall in einem Schema verwendet werden können. Hierzu müssen Sie den Type des Felds auf den Wert eines beliebigen der in der Schema Registry definierten Datentypen festlegen.

Um das loyaltyTier Objekt in einen Datentyp zu konvertieren, wählen Sie auf der Arbeitsfläche das Feld loyaltyTier und dann rechts im Editor unter Convert to new data type aus Field properties

Der Schema-Editor mit dem hervorgehobenen Objekt „LoyaltyTier“ und Convert to new data type.

Es wird eine Benachrichtigung angezeigt, die bestätigt, dass das Objekt erfolgreich konvertiert wurde. Auf der Arbeitsfläche können Sie jetzt sehen, dass das Feld loyaltyTier nun ein Verknüpfungssymbol enthält, und in der rechten Leiste wird angegeben, dass es den Datentyp „Loyalty Tier“ hat.

Der Schema-Editor mit dem hervorgehobenen Objekt „LoyaltyTier“ und dem neuen Anzeigenamen.

In einem zukünftigen Schema können Sie nun ein Feld als Typ „Loyalty Tier“ zuweisen. Dies enthält dann automatisch Felder für ID, Stufenklasse, Punkteschwellenwerte und das Datum des Wirksamwerdens.

NOTE
Sie können benutzerdefinierte Datentypen auch unabhängig von der Schemabearbeitung erstellen und bearbeiten. Weiterführende Informationen finden Sie im Handbuch zum Erstellen und Bearbeiten von Datentypen.

Suchen und Filtern von Schemafeldern

Ihr Schema enthält jetzt zusätzlich zu den von der Basisklasse bereitgestellten Feldern mehrere Feldergruppen. Wenn Sie mit größeren Schemata arbeiten, können Sie in der linken Leiste die Kontrollkästchen neben den Namen der Feldergruppen aktivieren, um die angezeigten Felder nur nach den von den Feldergruppen bereitgestellten Feldern zu filtern, die für Sie interessant sind.

Einige Kontrollkästchen wurden im Abschnitt Feldergruppen des Schema-Editors aktiviert, um die Größe des Schemadiagramms zu reduzieren.

Wenn Sie nach einem bestimmten Feld in Ihrem Schema suchen, können Sie auch die Suchleiste verwenden, um die angezeigten Felder nach Namen zu filtern, unabhängig davon, unter welcher Feldergruppe sie bereitgestellt werden.

Das Suchfeld des Schema-Editors mit Hervorhebung der relevanten Ergebnisse auf der Arbeitsfläche.

IMPORTANT
Die Suchfunktion berücksichtigt alle ausgewählten Feldgruppenfilter bei der Anzeige passender Felder. Wenn in einer Suchanfrage nicht die erwarteten Ergebnisse angezeigt werden, müssen Sie möglicherweise überprüfen, ob Sie relevante Feldergruppen herausfiltern.

Festlegen eines Schemafelds als Identitätsfeld identity-field

Die Standarddatenstruktur, die Schemata bereitstellen, kann genutzt werden, um quellenübergreifed Daten zu identifizieren, die zu derselben Person gehören. Dies ermöglicht verschiedene nachgelagerte Anwendungsfälle wie Segmentierung, Reporting, Datenwissenschaftsanalyse und mehr. Um Daten basierend auf einzelnen Identitäten zusammenzufügen, müssen Schlüsselfelder in anwendbaren Schemata als Identity Felder markiert werden.

Experience Platform können Sie ein Identitätsfeld ganz einfach durch ein Identity Kontrollkästchen im Schema Editor kennzeichnen. Basierend auf der Art Ihrer Daten müssen Sie jedoch festlegen, welches Feld als Identität am besten geeignet ist.

So kann es beispielsweise Tausende von Mitgliedern des Treueprogramms geben, die derselben Treuestufe angehören, sowie mehrere Mitglieder, die dieselbe physische Adresse haben. In diesem Szenario gibt jedoch jedes Mitglied des Treueprogramms bei der Registrierung seine persönliche E-Mail-Adresse an. Da persönliche E-Mail-Adressen in der Regel von einer Person verwaltet werden, eignet sich das Feld personalEmail.address (bereitgestellt von der Personal Contact Details Feldergruppe) sehr gut als Identitätsfeld.

IMPORTANT
Die folgenden Schritte beschreiben, wie Sie einem vorhandenen Schemafeld einen Identitätsdeskriptor hinzufügen. Als Alternative zur Definition von Identitätsfeldern innerhalb der Struktur des Schemas selbst können Sie stattdessen auch ein Feld identityMap zum Speichern der Identitätsinformationen verwenden.
Wenn Sie identityMap verwenden möchten, denken Sie daran, dass dadurch alle primären Identitäten außer Kraft gesetzt werden, die Sie direkt zum Schema hinzufügen. Weiterführende Informationen finden Sie im Abschnitt zu identityMap im Handbuch mit den Grundlagen der Schemakomposition.

Wählen Sie auf der Arbeitsfläche das Feld personalEmail.address aus. Daraufhin wird unter Identity das Kontrollkästchen Field properties angezeigt. Aktivieren Sie das Kästchen. Anschließend wird die Option angezeigt, um dies als Primary identity festzulegen. Aktivieren Sie dieses Kontrollkästchen ebenfalls.

NOTE
Jedes Schema darf nur ein primäres Identitätsfeld enthalten. Nachdem ein Schemafeld als primäre Identität festgelegt wurde, erhalten Sie eine Fehlermeldung, wenn Sie später versuchen, ein anderes Identitätsfeld im Schema als primär festzulegen.

Als Nächstes müssen Sie eine Identity namespace aus der Liste der vordefinierten Namespaces im Dropdown-Menü angeben. Da dieses Feld die E-Mail-Adresse des Kunden ist, wählen Sie aus dem Dropdown-Menü die Option "Email" aus. Wählen Sie Apply aus, um die Aktualisierungen des personalEmail.address zu bestätigen.

Der Schema-Editor mit der hervorgehobenen E-Mail-Adresse und aktiviertem Kontrollkästchen für die Primäre Identität.

NOTE
Eine Liste der Standard-Namespaces und ihrer Definitionen finden Sie in der Identity Service Dokumentation.

Nach Anwendung der Änderung zeigt das Symbol für personalEmail.address ein Fingerabdrucksymbol. Dies bedeutet, dass es sich jetzt um ein Identitätsfeld handelt. Das Feld wird auch in der linken Leiste unter Identities aufgeführt.

Der Schema-Editor mit der hervorgehobenen E-Mail-Adresse und dem hervorgehobenen Identitätsfeld in der Seitenleiste zur Schemakomposition.

Nun werden alle Daten, die in das Feld personalEmail.address aufgenommen werden, verwendet, um diese Person zu identifizieren und eine individuelle Sicht auf diese Kundin oder diesen Kunden zu erstellen. Weitere Informationen zum Arbeiten mit Identitäten in Experience Platform finden Sie in der Dokumentation zu Identity Service.

Aktivieren des Schemas für die Verwendung in Real-Time Customer Profile profile

Das Real-Time Customer Profile nutzt Identitätsdaten in Experience Platform, um eine ganzheitliche Sicht auf jede einzelne Kundin und jeden einzelnen Kunden zu ermöglichen. Der Service erstellt robuste 360°-Profile mit Kundenattributen sowie mit Zeitstempel versehene Berichte für jede Interaktion, die Kundinnen und Kunden über eines der in Experience Platform integrierten Systeme hatten.

Damit ein Schema für das Real-Time Customer Profile aktiviert werden kann, muss eine primäre Identität dafür definiert sein. Sie erhalten eine Fehlermeldung, wenn Sie versuchen, ein Schema zu aktivieren, ohne vorher eine primäre Identität zu definieren.

Das Dialogfeld „Fehlende primäre Identität“.

Um das Schema „Mitglieder des Treueprogramms“ für das Profile zu aktivieren, wählen Sie zunächst den Schemanamen auf der Arbeitsfläche aus.

Rechts im Editor werden Informationen zum Schema angezeigt, einschließlich dessen Anzeigenamen, Beschreibung und Typ. Zusätzlich zu diesen Informationen gibt es eine Profile Umschalter-Schaltfläche.

Der Schema-Editor mit dem Schemastamm und dem hervorgehobenen Umschalter „Für Profil aktivieren“.

Wählen Sie Profile aus. Daraufhin wird ein Pop-up angezeigt, in dem Sie bestätigen müssen, dass Sie das Schema für die Profile aktivieren möchten.

Der Bestätigungsdialog „Für Profil aktivieren“

WARNING
Nachdem ein Schema für das Real-Time Customer Profile aktiviert und gespeichert wurde, kann es nicht mehr deaktiviert werden.

Wählen Sie Enable aus, um Ihre Auswahl zu bestätigen. Sie können den Umschalter Profile erneut auswählen, um ggf. das Schema zu deaktivieren. Aber sobald das Schema bei aktiviertem Profile gespeichert wurde, kann es nicht mehr deaktiviert werden.

Mehr Aktionen more

Im Schema-Editor können Sie auch Schnellaktionen durchführen, um die JSON-Struktur des Schemas zu kopieren oder das Schema zu löschen. Wählen Sie oben in der Ansicht More aus, um eine Dropdown-Liste mit Schnellaktionen anzuzeigen.

Der Schema-Editor mit der hervorgehobenen Schaltfläche „Mehr“ und den angezeigten Dropdown-Optionen.

Löschen eines Schemas delete-a-schema

Ein Schema kann über die Benutzeroberfläche mithilfe von More-Aktionen aus dem Schema-Editor sowie über die Schemadetails auf der Registerkarte Browse gelöscht werden. Es gibt bestimmte Bedingungen, die verhindern, dass ein Schema gelöscht wird. Ein Schema kann nicht gelöscht werden, wenn:

  • Das Schema ist für das Profil aktiviert.
  • Das Schema ist für Profil aktiviert und verfügt über verknüpfte Datensätze.
  • Das Schema verfügt über verknüpfte Datensätze, ist jedoch nicht für das Profil aktiviert.

Kopieren von JSON-Strukturen copy-json-structure

Wählen Sie Copy JSON structure aus, um eine Export-Payload für ein beliebiges Schema in der Schemabibliothek zu generieren. Diese Aktion kopiert die JSON-Struktur in die Zwischenablage. Ihre exportierte JSON-Datei kann dann zum Importieren des Schemas und aller zugehörigen Ressourcen in eine andere Sandbox oder Organisation verwendet werden. Dadurch wird die Freigabe und Wiederverwendung von Schemata zwischen verschiedenen Umgebungen einfach und effizient.

Nächste Schritte und zusätzliche Ressourcen

Nachdem Sie das Schema fertiggestellt haben, ist das vollständige Schema auf der Arbeitsfläche sichtbar. Wählen Sie Save aus. Das Schema wird in der Schema Library gespeichert, sodass es von der Schema Registry aufgerufen werden kann.

Ihr neues Schema kann jetzt zur Aufnahme von Daten in Experience Platform verwendet werden. Denken Sie daran, dass nach Verwendung des Schemas zur Datenaufnahme nur noch Ergänzungen vorgenommen werden können. Weitere Informationen zur Schemaversionierung finden Sie in den Grundlagen der Schema-Komposition.

Mithilfe des Tutorials Definieren einer Schemabeziehung in der Benutzeroberfläche können Sie nun dem Schema „Mitglieder des Treueprogramms“ ein neues Beziehungsfeld hinzufügen.

Das Schema „Mitglieder des Treueprogramms“ steht auch zur Ansicht und Verwaltung mit der Schema Registry-API zur Verfügung. Um mit der API zu arbeiten, lesen Sie zunächst das Schema Registry API Entwicklerhandbuch.

Videoressourcen

WARNING
Die Experience Platform-Benutzeroberfläche, die in den folgenden Videos angezeigt wird, ist veraltet. Die neuesten Screenshots und Funktionen der Benutzeroberfläche finden Sie in der obigen Dokumentation.

Das folgende Video zeigt, wie ein einfaches Schema in der Experience Platform-Benutzeroberfläche erstellt wird.

Das folgende Video soll Ihr Verständnis für die Arbeit mit Feldergruppen und Klassen verbessern.

Anhang

Die folgenden Abschnitte enthalten zusätzliche Informationen zur Verwendung des Schema Editor.

Erstellen einer neuen Klasse create-new-class

Experience Platform bietet die Flexibilität, ein Schema auf der Grundlage einer Klasse zu definieren, die eindeutig für Ihre Organisation ist. Informationen zum Erstellen einer neuen Klasse finden Sie im Handbuch zum Erstellen und Bearbeiten von Klassen in der Benutzeroberfläche.

Ändern der Klasse eines Schemas change-class

Sie können die Klasse eines Schemas während des anfänglichen Kompositionsprozesses jederzeit ändern, bevor das Schema gespeichert wurde.

WARNING
Die Neuzuweisung der Klasse für ein Schema sollte mit äußerster Vorsicht erfolgen. Feldergruppen sind nur mit bestimmten Klassen kompatibel. Daher werden die Arbeitsfläche und alle von Ihnen hinzugefügten Felder beim Ändern der Klasse zurückgesetzt.

Informationen zum Ändern der Klasse eines Schemas finden Sie im Handbuch zum Verwalten von Schemata in der Benutzeroberfläche.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07