Erstellen und Bearbeiten von Schemata in der Benutzeroberfläche

Dieses Handbuch bietet einen Überblick darüber, wie Sie Experience-Datenmodell (XDM)-Schemas für Ihr Unternehmen in der Adobe Experience Platform-Benutzeroberfläche erstellen, bearbeiten und verwalten.

Voraussetzungen

Dieses Handbuch setzt ein Verständnis des XDM-Systems voraus. Siehe Abschnitt XDM-Übersicht für eine Einführung in die Rolle von XDM im Experience Platform-Ökosystem und Grundlagen der Schemakomposition für einen Überblick darüber, wie Schemas erstellt werden.

Erstellen eines neuen Schemas

Im Schemas Arbeitsbereich auswählen Schema erstellen in der oberen rechten Ecke.

Die Schema erstellen Workflow angezeigt. Sie können eine Basisklasse für das Schema auswählen, indem Sie entweder Individuelles Profil, Erlebnisereignis oder Sonstiges, gefolgt von Nächste um Ihre Wahl zu bestätigen. Siehe XDM-individuelles Profil und XDM ExperienceEvent Dokumentation finden Sie weitere Informationen zu diesen Klassen.

Nachdem Sie eine Klasse ausgewählt haben, wird die Name und Überprüfung angezeigt. In diesem Abschnitt geben Sie einen Namen und eine Beschreibung ein, um Ihr Schema zu identifizieren. ​Die (von der Klasse bereitgestellte) Basisstruktur des Schemas wird auf der Arbeitsfläche angezeigt, damit Sie Ihre ausgewählte Klasse und Schemastruktur überprüfen und überprüfen können.

Geben Sie einen benutzerfreundlichen Anzeigename des Schemas im Textfeld. Geben Sie anschließend eine Beschreibung ein, die die Identifizierung Ihres Schemas erleichtert. Wenn Sie Ihre Schemastruktur überprüft haben und mit Ihren Einstellungen zufrieden sind, wählen Sie Beenden , um Ihr Schema zu erstellen.

Die Schema Durchsuchen angezeigt. Ihr kürzlich erstelltes Schema ist jetzt in der Schema Library aufgeführt und kann im Schema Editor.

Vorhandenes Schema bearbeiten

Um ein vorhandenes Schema zu bearbeiten, wählen Sie die Durchsuchen und wählen Sie dann den Namen des Schemas aus, das Sie bearbeiten möchten. Sie können auch die Suchleiste verwenden, um die Liste der verfügbaren Optionen einzuschränken.

Sobald Sie ein Schema auswählen, wird die Schema Editor angezeigt, wobei die Struktur des Schemas auf der Arbeitsfläche angezeigt wird. Sie können jetzt Feldergruppen hinzufügen zum Schema (oder Hinzufügen einzelner Felder aus diesen Gruppen), Anzeigenamen von Feldern bearbeitenoder Bearbeiten vorhandener benutzerdefinierter Feldergruppen , wenn das Schema eine verwendet.

Mehr Aktionen

Im Schema Editor können Sie auch Schnellaktionen durchführen, um die JSON-Struktur des Schemas zu kopieren oder das Schema zu löschen, wenn es nicht für das Echtzeit-Kundenprofil aktiviert wurde oder über verknüpfte Datensätze verfügt. Auswählen Mehr oben in der Ansicht ein Dropdown-Menü mit Schnellaktionen anzeigen.

Mit der Funktion JSON-Struktur kopieren können Sie sehen, wie eine Beispiel-Payload aussehen würde, während Sie das Schema und Ihre Daten-Pipelines noch erstellen. Dies ist besonders hilfreich in Situationen, in denen komplexe Objektzuordnungsstrukturen im Schema vorhanden sind, z. B. bei einer Identitätszuordnung.

Umschalter für Anzeigename

Der Schema Editor bietet einen Umschalter zum Ändern zwischen den ursprünglichen Feldnamen und den für Menschen lesbareren Anzeigenamen. Diese Flexibilität ermöglicht eine verbesserte Erkennung und Bearbeitung von Feldern Ihrer Schemata. Der Umschalter befindet sich oben rechts in der Ansicht Schema Editor .

Die Anzeigenamen für Standardfeldgruppen werden systemgeneriert, können jedoch angepasst werden, wie in der Anzeigenamen Abschnitt. Anzeigenamen werden in mehreren Ansichten der Benutzeroberfläche angezeigt, einschließlich der Zuordnung und Datensatzvorschau. Die Standardeinstellung ist deaktiviert und zeigt die Feldnamen anhand ihrer ursprünglichen Werte an.

Hinzufügen von Feldergruppen zu einem Schema

Nachdem Sie ein Schema im Schema Editorkönnen Sie dem Schema mithilfe von Feldergruppen Felder hinzufügen. Wählen Sie zunächst Hinzufügen neben Feldergruppen in der linken Leiste.

Es wird ein Dialogfeld mit einer Liste von Feldergruppen angezeigt, die Sie für das Schema auswählen können. Da Feldergruppen nur mit einer Klasse kompatibel sind, werden nur die Feldergruppen aufgelistet, die mit der ausgewählten Klasse des Schemas verknüpft sind. Standardmäßig werden die aufgelisteten Feldergruppen nach ihrer Nutzungspersönlichkeit in Ihrem Unternehmen sortiert.

Wenn Sie die allgemeine Aktivität oder den Geschäftsbereich der Felder kennen, die Sie hinzufügen möchten, wählen Sie in der linken Leiste mindestens eine der vertikalen Branchen-Kategorien aus, um die angezeigte Liste der Feldergruppen zu filtern.

Sie können auch die Suchleiste verwenden, um Ihre gewünschte Feldergruppe zu finden. Feldergruppen, deren Name mit der Abfrage übereinstimmt, werden oben in der Liste angezeigt. under Standardfelder, werden Feldergruppen mit Feldern angezeigt, die die gewünschten Datenattribute beschreiben.

Aktivieren Sie das Kontrollkästchen neben dem Namen der Feldergruppe, die Sie zum Schema hinzufügen möchten. Sie können mehrere Feldergruppen aus der Liste auswählen, wobei jede ausgewählte Feldergruppe in der rechten Leiste angezeigt wird.

Nachdem Sie die Feldergruppen ausgewählt haben, wählen Sie Feldergruppen hinzufügen , um sie dem Schema hinzuzufügen.

Die Schema Editor wird mit den von der Feldergruppe bereitgestellten Feldern auf der Arbeitsfläche erneut angezeigt.

Nach dem Hinzufügen einer Feldergruppe zu einem Schema können Sie optional vorhandene Felder entfernen oder Hinzufügen neuer benutzerdefinierter Felder auf diese Gruppen, je nach Ihren Bedürfnissen.

Felder, die zu Feldergruppen hinzugefügt wurden, entfernen

Nachdem Sie einem Schema eine Feldergruppe hinzugefügt haben, können Sie alle Felder entfernen, die Sie nicht benötigen.

Im folgenden Beispiel wird die Standardfeldgruppe Demografische Details wurde zu einem Schema hinzugefügt. So entfernen Sie ein einzelnes Feld wie taxId, wählen Sie das Feld auf der Arbeitsfläche aus und klicken Sie auf Entfernen in der rechten Leiste.

Wenn Sie mehrere Felder entfernen möchten, können Sie die Feldergruppe als Ganzes verwalten. Wählen Sie auf der Arbeitsfläche ein Feld aus, das zur Gruppe gehört, und wählen Sie dann Zugehörige Felder verwalten in der rechten Leiste.

Es wird ein Dialogfeld mit der Struktur der betreffenden Feldergruppe angezeigt. Hier können Sie die Kontrollkästchen verwenden, um die erforderlichen Felder auszuwählen oder die Auswahl aufzuheben. Wenn Sie zufrieden sind, wählen Sie Bestätigen.

Die Arbeitsfläche wird nur mit den in der Schemastruktur ausgewählten Feldern wieder angezeigt.

Hinzufügen benutzerdefinierter Felder zu Feldergruppen

Nachdem Sie einem Schema eine Feldergruppe hinzugefügt haben, können Sie zusätzliche Felder für diese Gruppe definieren. Alle Felder, die einer Feldergruppe in einem Schema hinzugefügt werden, werden jedoch auch in allen anderen Schemas angezeigt, die dieselbe Feldergruppe verwenden.

Wenn ein benutzerdefiniertes Feld zu einer Standardfeldgruppe hinzugefügt wird, wird diese Feldergruppe in eine benutzerdefinierte Feldergruppe konvertiert und die ursprüngliche Standardfeldgruppe ist nicht mehr verfügbar.

Wenn Sie ein benutzerdefiniertes Feld zu einer Standardfeldgruppe hinzufügen möchten, lesen Sie den Abschnitt Abschnitt unten für spezifische Anweisungen. Wenn Sie Felder zu einer benutzerdefinierten Feldergruppe hinzufügen, lesen Sie den Abschnitt unter Bearbeiten benutzerdefinierter Feldergruppen im Benutzerhandbuch für Feldergruppen.

Wenn Sie keine vorhandenen Feldergruppen ändern möchten, können Sie eine neue benutzerdefinierte Feldergruppe erstellen , um stattdessen zusätzliche Felder zu definieren.

Hinzufügen einzelner Felder zu einem Schema

Mit dem Schema Editor können Sie einzelne Felder direkt zu einem Schema hinzufügen, wenn Sie vermeiden möchten, eine ganze Feldergruppe für einen bestimmten Anwendungsfall hinzuzufügen. Sie können Hinzufügen einzelner Felder aus Standardfeldgruppen oder eigene benutzerdefinierte Felder hinzufügen anstatt.

Standardfelder hinzufügen

Sie können Felder aus Standardfeldgruppen direkt zu einem Schema hinzufügen, ohne zuvor die entsprechende Feldergruppe kennen zu müssen. Um einem Schema ein Standardfeld hinzuzufügen, wählen Sie das Pluszeichen (+) neben dem Namen des Schemas in der Arbeitsfläche. Ein Unbenanntes Feld Platzhalter wird in der Schemastruktur angezeigt und die rechte Leiste wird aktualisiert, um Steuerelemente zum Konfigurieren des Felds anzuzeigen.

under Feldname, geben Sie den Namen des Felds ein, das Sie hinzufügen möchten. Das System sucht automatisch nach Standardfeldern, die mit der Abfrage übereinstimmen, und listet sie unter Empfohlene Standardfelder, einschließlich der Feldergruppen, denen sie angehören.

Einige Standardfelder weisen denselben Namen auf, ihre Struktur kann jedoch von der Feldergruppe abhängen, aus der sie stammen. Wenn ein Standardfeld innerhalb eines übergeordneten Objekts in der Feldergruppenstruktur verschachtelt ist, wird das übergeordnete Feld auch im Schema enthalten sein, wenn das untergeordnete Feld hinzugefügt wird.

Wählen Sie das Vorschausymbol () neben einem Standardfeld klicken, um die Struktur seiner Feldergruppe anzuzeigen und besser zu verstehen, wie sie verschachtelt sein könnte. Um das Standardfeld zum Schema hinzuzufügen, wählen Sie das Pluszeichen ().

Die Arbeitsfläche wird aktualisiert und zeigt das Standardfeld an, das dem Schema hinzugefügt wurde, einschließlich der übergeordneten Felder, unter denen es innerhalb der Feldergruppenstruktur verschachtelt ist. Der Name der Feldergruppe wird auch unter Feldergruppen in der linken Leiste. Wenn Sie weitere Felder aus derselben Feldergruppe hinzufügen möchten, wählen Sie Zugehörige Felder verwalten in der rechten Leiste.

Benutzerdefinierte Felder hinzufügen

Ähnlich wie beim Workflow für Standardfelder können Sie auch eigene benutzerdefinierte Felder direkt zu einem Schema hinzufügen.

Um Felder zur Stammebene eines Schemas hinzuzufügen, wählen Sie das Pluszeichen (+) neben dem Namen des Schemas in der Arbeitsfläche. Ein Unbenanntes Feld Platzhalter wird in der Schemastruktur angezeigt und die rechte Leiste wird aktualisiert, um Steuerelemente zum Konfigurieren des Felds anzuzeigen.

Beginnen Sie mit der Eingabe des Namens des Felds, das Sie hinzufügen möchten, und das System beginnt automatisch mit der Suche nach entsprechenden Standardfeldern. Um stattdessen ein neues benutzerdefiniertes Feld zu erstellen, wählen Sie die obere Option, die an (Neues Feld).

Nachdem Sie einen Anzeigenamen und einen Datentyp für das Feld bereitgestellt haben, besteht der nächste Schritt darin, das Feld einer übergeordneten XDM-Ressource zuzuweisen. Wenn Ihr Schema eine benutzerdefinierte Klasse verwendet, können Sie auswählen, das Feld zur zugewiesenen Klasse hinzufügen oder Feldergruppe anstatt. Wenn Ihr Schema jedoch eine Standardklasse verwendet, können Sie das benutzerdefinierte Feld nur einer Feldergruppe zuweisen.

Weisen Sie das Feld einer benutzerdefinierten Feldergruppe zu

under Zuweisen zu auswählen Feldergruppe. Wenn Ihr Schema eine Standardklasse verwendet, ist dies die einzige verfügbare Option und standardmäßig ausgewählt.

Als Nächstes müssen Sie eine Feldergruppe auswählen, mit der das neue Feld verknüpft werden soll. Beginnen Sie mit der Eingabe des Namens der Feldergruppe in der bereitgestellten Texteingabe. Wenn bereits benutzerdefinierte Feldergruppen vorhanden sind, die mit der Eingabe übereinstimmen, werden diese in der Dropdown-Liste angezeigt. Alternativ können Sie einen eindeutigen Namen eingeben, um stattdessen eine neue Feldergruppe zu erstellen.

Nachdem Sie die Feldergruppe aus der Liste ausgewählt haben, wählen Sie Anwenden.

Das neue Feld wird der Arbeitsfläche hinzugefügt und unter Ihrem Mandanten-ID um Konflikte mit Standard-XDM-Feldern zu vermeiden. Die Feldergruppe, mit der Sie das neue Feld verknüpft haben, wird ebenfalls unter Feldergruppen in der linken Leiste.

Weisen Sie das Feld einer benutzerdefinierten Klasse zu

under Zuweisen zu auswählen Klasse. Das nachstehende Eingabefeld wird durch den Namen der benutzerdefinierten Klasse des aktuellen Schemas ersetzt und gibt an, dass das neue Feld dieser Klasse zugewiesen wird.

Fahren Sie mit der Konfiguration des Felds fort und wählen Sie Anwenden wenn fertig.

Das neue Feld wird der Arbeitsfläche hinzugefügt und unter Ihrem Mandanten-ID um Konflikte mit Standard-XDM-Feldern zu vermeiden. Wenn Sie den Klassennamen in der linken Leiste auswählen, wird das neue Feld als Teil der Klassenstruktur angezeigt.

Fügen Sie benutzerdefinierte Felder zur Struktur von Standardfeldgruppen hinzu

Wenn das Schema, mit dem Sie arbeiten, ein Objekt enthält, das von einer Standardfeldgruppe bereitgestellt wird, können Sie diesem Standardobjekt eigene benutzerdefinierte Felder hinzufügen.

Wählen Sie zunächst das Pluszeichen (+) neben dem Stamm des Objekts, das von der Standardfeldgruppe bereitgestellt wird.

Es wird eine Warnmeldung angezeigt, in der Sie aufgefordert werden zu bestätigen, ob Sie die Standardfeldgruppe konvertieren möchten. Auswählen Feldgruppe weiterhin erstellen um fortzufahren.

Die Arbeitsfläche wird mit einem unbenannten Platzhalter für das neue Feld erneut angezeigt. Beachten Sie, dass der Name der Standardfeldgruppe mit "(Erweitert)", um anzugeben, dass es von der Originalversion geändert wurde. Verwenden Sie von hier aus die Steuerelemente in der rechten Leiste, um die Eigenschaften des Felds zu definieren.

Nachdem Sie Ihre Änderungen angewendet haben, wird das neue Feld unter Ihrem Mandanten-ID-Namespace innerhalb des Standardobjekts angezeigt. Dieser verschachtelte Namespace verhindert Konflikte mit Feldnamen innerhalb der Feldergruppe selbst, um Änderungen in anderen Schemas zu vermeiden, die dieselbe Feldergruppe verwenden.

Aktivieren eines Schemas für das Echtzeit-Kundenprofil

Echtzeit-Kundenprofil führt Daten aus unterschiedlichen Quellen zusammen, um eine vollständige Ansicht jedes einzelnen Kunden zu erhalten. Wenn die von einem Schema erfassten Daten an diesem Prozess teilnehmen sollen, müssen Sie das Schema zur Verwendung in Profile.

Um das Schema zu aktivieren, wählen Sie zunächst den Namen des Schemas in der linken Leiste aus und wählen Sie dann die Profil in der rechten Leiste ein-/ausschalten.

Es wird ein Popup angezeigt, in dem Sie darauf hingewiesen werden, dass ein Schema nach seiner Aktivierung und Speicherung nicht mehr deaktiviert werden kann. Auswählen Aktivieren , um fortzufahren.

Die Arbeitsfläche wird mit der Profil Umschalten aktiviert.

Um den Prozess abzuschließen, wählen Sie Speichern , um das Schema zu speichern.

Das Schema ist jetzt für die Verwendung im Echtzeit-Kundenprofil aktiviert. Wenn Platform Daten in Datensätze erfasst, die auf diesem Schema basieren, werden diese Daten in Ihre aggregierten Profildaten integriert.

Anzeigenamen für Schemafelder bearbeiten

Nachdem Sie einem Schema eine Klasse zugewiesen und Feldergruppen hinzugefügt haben, können Sie die Anzeigenamen der Felder des Schemas bearbeiten, unabhängig davon, ob diese Felder von standardmäßigen oder benutzerdefinierten XDM-Ressourcen bereitgestellt wurden.

Um den Anzeigenamen eines Schemafelds zu bearbeiten, wählen Sie das Feld auf der Arbeitsfläche aus. Geben Sie in der rechten Leiste den neuen Namen unter Anzeigename.

Auswählen Anwenden in der rechten Leiste angezeigt wird, wird die Arbeitsfläche aktualisiert, um den neuen Anzeigenamen des Felds anzuzeigen. Auswählen Speichern , um die Änderungen auf das Schema anzuwenden.

Klasse eines Schemas ändern

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

Um eine Klasse neu zuzuweisen, wählen Sie Zuweisen auf der linken Seite der Arbeitsfläche.

Es wird ein Dialogfeld angezeigt, in dem eine Liste aller verfügbaren Klassen angezeigt wird, einschließlich aller von Ihrer Organisation definierten Klassen (der Inhaber ist derKunde") sowie durch Adobe definierte Standardklassen.

Wählen Sie eine Klasse aus der Liste aus, um ihre Beschreibung auf der rechten Seite des Dialogfelds anzuzeigen. Sie können auch Vorschau der Klassenstruktur , um die mit der Klasse verknüpften Felder und Metadaten anzuzeigen. Auswählen Klasse zuweisen , um fortzufahren.

Es wird ein neues Dialogfeld geöffnet, in dem Sie aufgefordert werden zu bestätigen, dass Sie eine neue Klasse zuweisen möchten. Auswählen Zuweisen zur Bestätigung.

Nach Bestätigung der Klassenänderung wird die Arbeitsfläche zurückgesetzt und der gesamte Kompositionsprozess geht verloren.

Nächste Schritte

In diesem Dokument wurden die Grundlagen zum Erstellen und Bearbeiten von Schemas in der Platform-Benutzeroberfläche beschrieben. Es wird dringend empfohlen, die Tutorial zur Schemaerstellung für einen umfassenden Workflow zum Erstellen eines vollständigen Schemas in der Benutzeroberfläche, einschließlich der Erstellung benutzerdefinierter Feldergruppen und Datentypen für eindeutige Anwendungsfälle.

Weitere Informationen zu den Funktionen der Schemas Arbeitsbereich, siehe Schemas Arbeitsbereich - Übersicht.

Informationen zum Verwalten von Schemata finden Sie im Abschnitt Schema Registry API, siehe Endpunktleitfaden für Schemata.