Dokumentation Experience Platform Handbuch zum Experience-Datenmodell (XDM)

Definieren einer 1:1-Beziehung zwischen zwei Schemata mithilfe des Schema Editor

Letzte Aktualisierung: 30. Dezember 2024

Themen:

Erstellt für:

Entwickler

Die Möglichkeit, Beziehungen zwischen Ihren Kunden und deren Interaktionen mit Ihrer Marke kanalübergreifend zu analysieren, ist ein wichtiger Bestandteil von Adobe Experience Platform. Durch die Definition dieser Beziehungen innerhalb der Struktur Ihrer Experience Data Model (XDM)-Schemata können Sie komplexe Einblicke in Ihre Kundendaten gewinnen.

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. Um eine Beziehung zwischen zwei Schemata herzustellen, die zu verschiedenen Klassen gehören, muss einem Quellschema ein dediziertes Beziehungsfeld hinzugefügt werden, das auf die Identität des anderen verwandten Schemas verweist.

NOTE

Wenn sowohl das Quell- als auch das Zielschema derselben Klasse angehören, sollte ein dediziertes Beziehungsfeld nicht verwendet werden. In diesem Fall verwenden Sie die Benutzeroberfläche des Vereinigungsschemas , um die Beziehung anzuzeigen. Anweisungen dazu finden Sie im Abschnitt Beziehungen anzeigen des Handbuchs zur Benutzeroberfläche des Vereinigungsschemas.

Dieses Dokument enthält ein Tutorial zum Definieren einer Beziehung zwischen zwei Schemas mithilfe des Schema-Editors in der Experience Platform-Benutzeroberfläche. Anweisungen zum Definieren von Schemabeziehungen mithilfe der API finden Sie in der Anleitung zum Definieren einer Beziehung mithilfe der Schema Registry-API.

NOTE

Anweisungen zum Erstellen einer Viele-zu-eins-Beziehung in Adobe Real-time Customer Data Platform B2B edition finden Sie im Handbuch zum von B2B-Beziehungen.

Erste Schritte

Dieses Tutorial setzt Grundkenntnisse der XDM System und des Schema-Editors in der Experience Platform-Benutzeroberfläche voraus. Bevor Sie mit dem Tutorial beginnen, lesen Sie die folgenden Dokumente:

XDM-System in Experience Platform: Ein Überblick über XDM und seine Implementierung in Experience Platform.
Grundlagen der Schemakomposition: Eine Einführung in die Bausteine von XDM-Schemata.
Erstellen eines Schemas mithilfe des Schema Editor: Ein Tutorial, das die Grundlagen der Arbeit mit dem Schema Editor behandelt.

Definieren eines Quell- und Referenzschemas

Wir gehen davon aus, dass Sie die beiden Schemata, die in der Beziehung definiert werden sollen, bereits erstellt haben. Zu Demonstrationszwecken wird in diesem Tutorial eine Beziehung zwischen den Mitgliedern des Treueprogramms einer Organisation (definiert in einem "Loyalty Members"-Schema) und ihrem Lieblingshotel (definiert in einem "Hotels"-Schema) erstellt.

IMPORTANT

Um eine Beziehung herzustellen, müssen beide Schemata über definierte primäre Identitäten verfügen und für die Real-Time Customer Profile aktiviert sein. Wenn Sie Anleitungen zur entsprechenden Konfiguration Ihrer Schemata benötigen lesen Sie im Tutorial zur Schemaerstellung den AbschnittAktivieren eines Schemas zur Verwendung im Profil“.

Schemabeziehungen werden durch ein dediziertes Feld innerhalb eines Quellschemas dargestellt, das auf ein anderes Feld innerhalb eines Referenzschemas verweist. In den folgenden Schritten ist "Loyalty Members" das Quellschema, während "Hotels" als Referenzschema dient.

In den folgenden Abschnitten wird die Struktur der einzelnen Schemas beschrieben, die in diesem Tutorial verwendet werden, bevor eine Beziehung definiert wurde.

Schema Loyalty Members

Das Quellschema "Loyalty Members" basiert auf der XDM Individual Profile-Klasse und enthält Felder, die die Mitglieder eines Treueprogramms beschreiben. Eines dieser Felder, personalEmail.addess, dient als primäre Identität für das Schema unter dem Namespace E-Mail. Wie unter Schemaeigenschaften zu sehen, wurde dieses Schema für die Verwendung in Real-Time Customer Profile aktiviert.

Schema Hotels

Das Referenzschema "Hotels" basiert auf einer benutzerdefinierten Klasse "Hotels" und enthält Felder, die ein Hotel beschreiben. Um an einer Beziehung teilzunehmen, muss für das Referenzschema auch eine primäre Identität definiert und für „Profil aktiviert . In diesem Fall fungiert _tenantId.hotelIdals primäre Identität für das Schema, wobei ein benutzerdefinierter Identity-Namespace "Hotel ID" verwendet wird.

Für Profil aktivieren

NOTE

Informationen zum Erstellen benutzerdefinierter Identity-Namespaces finden Sie in der Identity Service-Dokumentation.

Erstellen einer Feldergruppe für Beziehungen

NOTE

Dieser Schritt ist nur erforderlich, wenn Ihr Quellschema kein dediziertes Feld vom Typ Zeichenfolge hat, das als Zeiger auf die primäre Identität des Referenzschemas verwendet werden kann. Wenn das Feld in Ihrem Quellschema bereits definiert ist, fahren Sie mit dem nächsten Schritt zum Definieren eines Beziehungsfelds fort.

Um eine Beziehung zwischen zwei Schemata zu definieren, muss das Quellschema über ein dediziertes Feld verfügen, das die primäre Identität des Referenzschemas angibt. Sie können dieses Feld zum Quellschema hinzufügen, indem Sie eine neue Schemafeldgruppe erstellen oder eine vorhandene erweitern.

Im Falle des Loyalty Members Schemas wird ein neues preferredHotel hinzugefügt, das das bevorzugte Hotel des Mitglieds des Treueprogramms für Firmenbesuche angibt. Wählen Sie zunächst das Pluszeichen (+) neben dem Namen des Quellschemas aus.

Ein Platzhalter für ein neues Feld wird auf der Arbeitsfläche angezeigt. Geben unter „Feldeigenschaften einen Feldnamen und einen Anzeigenamen für das Feld an und legen Sie seinen Typ auf "" . Wählen unter „Zuweisen zu eine vorhandene Feldergruppe aus, die erweitert werden soll, oder geben Sie einen eindeutigen Namen ein, um eine neue Feldergruppe zu erstellen. In diesem Fall wird eine neue Feldergruppe "Preferred Hotel" erstellt.

Wenn Sie fertig sind, wählen Sie Anwenden aus.

Das aktualisierte preferredHotel-Feld wird auf der Arbeitsfläche unter einem _tenantId-Objekt angezeigt, da es ein benutzerdefiniertes Feld ist. Klicken Sie Speichern, um Ihre Änderungen am Schema abzuschließen.

Definieren eines Beziehungsfelds für das Quellschema

Sobald in Ihrem Quellschema ein dediziertes Referenzfeld definiert ist, können Sie es als Beziehungsfeld festlegen.

NOTE

Beziehungen können nur für String- oder String-Array-Felder unterstützt werden.

Wählen Sie das Feld preferredHotel auf der Arbeitsfläche und dann Beziehung hinzufügen in der Seitenleiste Feldeigenschaften aus.

Der Schema-Editor mit hervorgehobener Option „Beziehung hinzufügen“ in der Seitenleiste „Feldeigenschaften“.

Das Beziehung hinzufügen wird angezeigt. In diesem Dialogfeld können Sie die erforderlichen Parameter zum Konfigurieren eines Beziehungsfelds festlegen. Für Real-Time CDP B2C-Benutzer können nur eine Eins-zu-eins-Beziehung zwischen dem Quell- und Referenzschema festlegen.

NOTE

Wenn Sie Zugriff auf Real-Time CDP B2B edition haben, können Sie die Steuerelemente der rechten Leiste der Arbeitsfläche verwenden, um ein Beziehungsfeld zu definieren und mithilfe Dialogfelds eine Viele-zu-eins-Beziehung.

Der Dialog Beziehung hinzufügen.

Verwenden Sie das Dropdown-Menü für Referenzschema und wählen Sie das Referenzschema für die Beziehung aus (in diesem Beispiel "Hotels„).

NOTE

Nur Schemas, die eine primäre Identität enthalten, werden in das Dropdown-Menü Referenzschema aufgenommen. Diese Sicherung verhindert, dass Sie versehentlich eine Beziehung zu einem Schema erstellen, das noch nicht richtig konfiguriert ist.

Der Identity-Namespace des Referenzschemas (in diesem Fall "Hotel ID„) wird automatisch unter „Referenz Identity-Namespace“. Klicken Sie Anwenden wenn Sie fertig sind.

Das Dialogfeld „Beziehung hinzufügen“ mit den konfigurierten Beziehungsparametern und der hervorgehobenen Option „Anwenden“.

Das preferredHotel Feld wird jetzt als Beziehung auf der Arbeitsfläche hervorgehoben und zeigt den Namen des Referenzschemas an. Klicken Sie Speichern, um Ihre Änderungen zu speichern und den Workflow abzuschließen.

Der Schema-Editor mit den hervorgehobenen Beziehungsreferenzen und „Speichern“.

Bearbeiten eines vorhandenen Beziehungsfelds

Um das Referenzschema zu ändern, wählen Sie ein Feld mit einer vorhandenen Beziehung und dann Beziehung bearbeiten in der Seitenleiste Feldeigenschaften aus.

Der Schema-Editor mit hervorgehobener Option „Beziehung bearbeiten“

Das Beziehung bearbeiten wird angezeigt. Von hier aus können Sie dem unter „Definieren eines Beziehungsfelds beschriebenen Prozess folgendie Beziehung löschen. Wählen Sie Beziehung löschen, um die Beziehung zum Referenzschema zu entfernen.

Der Dialog Beziehung bearbeiten.

Filtern und Suchen nach Beziehungen

Sie können über die Registerkarte „Beziehungen“ des Arbeitsbereichs Schemata nach bestimmten innerhalb Ihrer Schemata und suchen. Mithilfe dieser Ansicht können Sie Ihre Beziehungen schnell finden und verwalten. Ausführliche Anweisungen zu den Filteroptionen finden Sie Dokument untervon Schemaressourcen .

Registerkarte „Beziehungen“ im Arbeitsbereich „Schemata“.

Nächste Schritte

In diesem Tutorial haben Sie mithilfe der Schema Editor erfolgreich eine Eins-zu-eins-Beziehung zwischen zwei Schemas erstellt. Anweisungen zum Definieren von Beziehungen mithilfe der API finden Sie in der Anleitung zum Definieren einer Beziehung mithilfe der Schema Registry-API.

recommendation-more-help