Wie lassen sich Feldgruppen und Datentypen am besten verwenden?
Feldgruppen sind Komponenten, die ein oder mehrere Felder in einem Schema definieren. Feldgruppen erzwingen, wie ihre Felder in der Hierarchie des Schemas angezeigt werden, und weisen daher in jedem Schema, in dem sie enthalten sind, dieselbe Struktur auf. Feldgruppen sind nur mit bestimmten Klassen kompatibel, angegeben durch ihr meta:intendedToExtend
-Attribut.
Datentypen können ebenfalls ein oder mehrere Felder für ein Schema bereitstellen. Im Gegensatz zu Feldgruppen sind Datentypen jedoch nicht auf eine bestimmte Klasse beschränkt. Dadurch stellen Datentypen eine flexiblere Möglichkeit dar, um allgemeine Datenstrukturen zu beschreiben, die über mehrere Schemata mit potenziell unterschiedlichen Klassen hinweg wiederverwendet werden können.
Was ist die eindeutige ID für ein Schema?
Alle Schema Registry-Ressourcen (Schemata, Feldgruppen, Datentypen, Klassen) verfügen über einen URI, der zu Referenz- und Suchzwecken als eindeutige ID dient. Wenn Sie ein Schema in der API anzeigen, finden Sie es in den $id
- und meta:altId
-Attributen der obersten Ebene.
Weiterführende Informationen finden Sie im Abschnitt Ressourcenkennung des Schema Registry-API-Handbuchs.
Wie groß ist ein Feld vom Typ „long“ maximal?
Bei einem Feld vom Typ „long“ handelt es sich um eine Ganzzahl mit einer maximalen Größe von 53(+1) Bit, wodurch ein potenzieller Bereich zwischen -9007199254740992 und 9007199254740992 gegeben ist. Dies liegt an einer Beschränkung der Darstellung langer Ganzzahlen durch JavaScript-Implementierungen von JSON.
Weiterführende Informationen zu Feldtypen finden Sie im Dokument zu Begrenzungen für XDM-Feldtypen.
Was ist meta:altId?
meta:altId
ist eine eindeutige Kennung für ein Schema. Die meta:altId
bietet eine einfach zu verweisende ID zur Verwendung in API-Aufrufen. Diese ID vermeidet die Notwendigkeit, jedes Mal codiert/decodiert zu werden, wenn sie wie mit dem JSON-URI-Format verwendet wird.
Welche Nutzungsbeschränkungen gelten für einen Zuordnungs-Datentyp?
XDM setzt die folgenden Einschränkungen für die Verwendung dieses Datentyps:
- Zuordnungstypen MÜSSEN vom Typ „Objekt“ sein.
- Für Zuordnungstypen DÜRFEN KEINE Eigenschaften definiert sein (d. h. sie definieren „leere“ Objekte).
- Zuordnungstypen MÜSSEN ein additionalProperties.type-Feld enthalten, das die Werte beschreibt, die innerhalb der Zuordnung platziert werden können, entweder Zeichenfolge oder Ganzzahl.
- Die Segmentierung mehrerer Entitäten kann nur anhand der Zuordnungsschlüssel und nicht anhand der Werte definiert werden.
- Zuordnungen werden für Konto-Zielgruppen nicht unterstützt.
Weitere Einzelheiten finden unter „Nutzungsbeschränkungen für".
Schema-Identity Management
Dieser Abschnitt enthält Antworten auf häufige Fragen zum Definieren und Verwalten von Identitäten in Ihren Schemata.
Wie kann ich Identitäten für mein Schema definieren?
In Experience Platform werden Identitäten verwendet, um ein Subjekt (normalerweise eine einzelne Person) unabhängig von den Datenquellen, die interpretiert werden, zu identifizieren. Sie werden in Schemata definiert, indem Schlüsselfelder als „Identität“ markiert werden. Häufig verwendete Identitätsfelder sind E-Mail-Adresse, Telefonnummer, Experience Cloud ID (ECID), CRM-ID und andere eindeutige ID-Felder.
Felder können entweder über die API oder die Benutzeroberfläche als Identitäten markiert werden.
Definieren von Identitäten in der API
In der API werden Identitäten durch Erstellen von Identitätsdeskriptoren erstellt. Identitätsdeskriptoren signalisieren, dass eine bestimmte Eigenschaft für ein Schema eine eindeutige Kennung ist.
Identitätsdeskriptoren werden durch eine POST-Anfrage an den Endpunkt „/descriptors“ erstellt. Bei erfolgreicher Ausführung erhalten Sie einen HTTP-Status 201 (Erstellt) und ein Antwortobjekt mit den Details des neuen Deskriptors.
Weitere Details zum Erstellen von Identitätsdeskriptoren in der API finden Sie im Abschnitt Deskriptoren des Schema Registry-Entwicklerhandbuchs.
Definieren von Identitäten in der Benutzeroberfläche
Wenn Ihr Schema im Schema-Editor geöffnet ist, wählen Sie das Feld im Abschnitt Struktur des Editors aus, das Sie als Identität markieren möchten. Wählen Sie rechts unter Feldeigenschaften die Option Identität aus.
Weitere Details zum Verwalten von Identitäten in der Benutzeroberfläche finden Sie im Abschnitt zum Definieren von Identitätsfeldern im Tutorial für den Schema-Editor.
Benötigt mein Schema eine primäre Identität?
Primäre Identitäten sind optional, da Schemata entweder keine oder eine davon aufweisen können. Ein Schema muss jedoch über eine primäre Identität verfügen, damit das Schema zur Verwendung im Real-Time Customer Profile aktiviert werden kann. Weiterführende Informationen finden Sie im Abschnitt Identität des Tutorials für den Schema-Editor.
Aktivierung des Schemaprofils
Dieser Abschnitt enthält Anleitungen zum Aktivieren von Schemas für die Verwendung mit dem Echtzeit-Kundenprofil.
Wie aktiviere ich ein Schema zur Verwendung im Real-Time Customer Profile?
Schemata werden zur Verwendung im Real-Time Customer Profile aktiviert, indem das Tag „union“ (Vereinigung) innerhalb des meta:immutableTags
-Attributs des Schemas hinzugefügt wird. Eine Aktivierung eines Schemas zur Verwendung mit dem Profile kann über die API oder die Benutzeroberfläche erfolgen.
Aktivieren eines vorhandenen Schemas für das Profile über die API
Stellen Sie eine PATCH-Anfrage, um das Schema zu aktualisieren und das meta:immutableTags
-Attribut als Array mit dem Wert „union“ hinzuzufügen. Wenn die Aktualisierung erfolgreich ist, zeigt die Antwort das aktualisierte Schema an, das jetzt das Tag „union“ enthält.
Weiterführende Informationen zur Verwendung der API zum Aktivieren eines Schemas für das Real-Time Customer Profile finden Sie im Dokument zu Vereinigungen im Schema Registry Entwicklerhandbuch.
Aktivieren eines vorhandenen Schemas für das Profile über die Benutzeroberfläche
Wählen Sie in Experience Platform im linken Navigationsbereich die Option Schemata und dann den Namen des Schemas aus der Liste der Schemata aus, das Sie aktivieren möchten. Aktivieren Sie anschließend rechts im Editor unter Schemaeigenschaften die Option Profil.
Weiterführende Informationen finden Sie im Abschnitt zur Verwendung im Echtzeit-Kundenprofil im Tutorial Schema-Editor.
Ist das automatisch erstellte Schema für das Profil aktiviert, wenn Adobe Analytics-Daten als Quelle importiert werden?
Das Schema wird nicht automatisch für das Echtzeit-Kundenprofil aktiviert. Sie müssen den Datensatz explizit für das Profil aktivieren, je nachdem, welches Schema für das Profil aktiviert ist. In der Dokumentation erfahren Sie mehr über Schritte und Anforderungen, die erforderlich sind, um einen Datensatz für die Verwendung im Echtzeit-Kundenprofil zu.
Kann ich profilaktivierte Schemata löschen?
Ein Schema kann nicht gelöscht werden, nachdem es für das Echtzeit-Kundenprofil aktiviert wurde. Nachdem ein Schema für das Profil aktiviert wurde, kann es nicht mehr deaktiviert oder gelöscht werden und es können keine Felder aus dem Schema entfernt werden. Daher ist es wichtig, die Schemakonfiguration sorgfältig zu planen und zu überprüfen, bevor sie für das Profil aktiviert wird. Sie können jedoch einen profilaktivierten Datensatz löschen. Informationen finden Sie hier: https://experienceleague.adobe.com/de/docs/experience-platform/catalog/datasets/user-guide#delete-a-profile-enabled-dataset
Wenn Sie die Verwendung eines profilaktivierten Schemas nicht mehr wünschen, wird empfohlen, das Schema umzubenennen und Nicht verwenden oder Inaktiv einzuschließen.
Schemaänderung und Einschränkungen
In diesem Abschnitt werden Schemaänderungsregeln und die Verhinderung grundlegender Änderungen erläutert.
Wann verhindert ein Schema umfassende Änderungen?
Umfassende Änderungen können an einem Schema vorgenommen werden, solange es noch nie bei der Erstellung eines Datensatzes verwendet oder für die Verwendung im Real-Time Customer Profile aktiviert wurde. Sobald ein Schema bei der Erstellung eines Datensatzes verwendet oder für die Verwendung mit dem Real-Time Customer Profile aktiviert wurde, werden die Regeln der Schemaentwicklung vom System streng durchgesetzt.
Kann ich ein Vereinigungsschema direkt bearbeiten?
Vereinigungsschemata sind schreibgeschützt und werden automatisch vom System generiert. Sie können nicht direkt bearbeitet werden. Vereinigungsschemata werden für eine bestimmte Klasse erstellt, wenn einem Schema, das diese Klasse implementiert, das Tag „union“ (Vereinigung) hinzugefügt wird.
Weiterführende Informationen zu Vereinigungen in XDM finden Sie im Abschnitt Vereinigungen des Schema Registry-API-Handbuchs.
Wie sollte ich meine Datendatei formatieren, um Daten in mein Schema aufzunehmen?
Experience Platform akzeptiert Datendateien im Parquet- oder JSON-Format. Die Inhalte dieser Dateien müssen mit dem Schema übereinstimmen, auf das der Datensatz verweist. Details zu Best Practices für die Datendateiaufnahme finden Sie in der Übersicht zur Batch-Aufnahme.
Wie kann ich ein Schema in ein schreibgeschütztes Schema konvertieren?
Ein Schema kann derzeit nicht in ein schreibgeschütztes konvertiert werden.
Fehler und Fehlerbehebung
Im Folgenden finden Sie eine Liste von Fehlermeldungen, auf die Sie bei der Arbeit mit der Schema Registry-API stoßen können.
Ressource nicht gefunden
{
"type": "http://ns.adobe.com/aep/errors/XDM-1010-404",
"title": "Resource not found",
"status": 404,
"report": {
"registryRequestId": "a15996b5-5133-4cec-9bf7-7d1207904ae3",
"timestamp": "06-01-2021 04:11:06",
"detailed-message": "The requested class resource https://ns.adobe.com/{TENANT_ID}/classes/11447bb484d4599d2cd9b0aseefff78b463cbbde1527f498 with version 1 is not found.",
"sub-errors": []
},
"detail": "The requested class resource https://ns.adobe.com/{TENANT_ID}/classes/11447bb484d4599d2cd9b0aseefff78b463cbbde1527f498 with version 1 is not found."
}
Dieser Fehler wird angezeigt, wenn das System eine bestimmte Ressource nicht finden konnte. Die Ressource wurde möglicherweise gelöscht oder der Pfad im API-Aufruf ist ungültig. Vergewissern Sie sich, dass Sie einen gültigen Pfad für Ihren API-Aufruf eingegeben haben, bevor Sie es erneut versuchen. Sie sollten überprüfen, ob Sie die richtige ID für die Ressource eingegeben haben und ob der Pfad den richtigen Namespace gemäß dem entsprechenden Container (global oder Mandant) erhalten hat.
type
-URIs verwenden:http://ns.adobe.com/aep/errors/XDM-1010-404
http://ns.adobe.com/aep/errors/XDM-1011-404
http://ns.adobe.com/aep/errors/XDM-1012-404
http://ns.adobe.com/aep/errors/XDM-1013-404
http://ns.adobe.com/aep/errors/XDM-1014-404
http://ns.adobe.com/aep/errors/XDM-1015-404
http://ns.adobe.com/aep/errors/XDM-1016-404
http://ns.adobe.com/aep/errors/XDM-1017-404
Weiterführende Informationen zum Erstellen von Suchpfaden in der API finden Sie in den Abschnitten Container und Ressourcenkennung des Schema Registry-Entwicklerhandbuchs.