Namespaces

Jeder ID, nach der Sie suchen möchten, wird ein Namespace zugewiesen, bei dem es sich um eine benutzerdefinierte Zeichenfolge handelt, die diese ID in jeder Variablen identifiziert, in der sie in allen Ihren Report Suites verwendet wird.

Mit der Namespace-Zeichenfolge identifizieren Sie die Felder, die bei der Bereitstellung einer ID im Rahmen einer Datenschutzanfrage durchsucht werden sollen. Wenn eine Datenschutzanfrage eingereicht wird, enthält die Anfrage einen JSON-Abschnitt, in dem die für die Anfrage zu verwendenden IDs der betroffenen Personen angegeben sind. Mehrere IDs können als Teil einer einzigen Anfrage für eine betroffene Person angegeben werden. Die JSON-Datei enthält:

  • Ein „namespace“-Feld, das die Namespace-Zeichenfolge enthält.
  • Ein Feld „Typ“, das für die meisten Adobe Analytics-Anfragen den Wert „analytics“ enthält.
  • Ein „Wert“-Feld, das die ID enthält, nach der Analytics in den zugehörigen Namespace-Variablen jeder Ihrer Report Suites suchen sollte.

Weitere Informationen und eine 🔗Liste der StandardIdentity-Namespaces finden Sie in der Dokumentation ​CX Enterprise Data Privacy API. Eine Beispielanfrage finden Sie unter Erstellen eines Zugriffs-/Löschauftrags.

Legacy-Analytics-Tracking-Cookie, auch bekannt als Adobe Analytics-ID (AAID):

{
   "namespace": "AAID",
   "type": "standard",
   "value": "2CCEEAE88503384F-1188000089CA"
}

Der Wert muss als zwei Hexadezimalzahlen angegeben werden, die durch einen Bindestrich getrennt sind. Alle Hexadezimalziffern, bei denen es sich um alphabetische Zeichen handelt, müssen in Großbuchstaben angegeben werden. Die Hexadezimalwerte sollten keine führenden Nullen aufweisen (beachten Sie den Unterschied zu demselben Wert, der in der verworfenen Form angegeben ist, in der die führenden Nullen erforderlich sind).

Es ist auch möglich, "namespaceId": 10 anstelle von oder zusätzlich zu "namespace": "AAID" zu verwenden. Auch andere Adobe-Produkte können diese Form verwenden.

{
   "namespace": "visitorId",
   "type": "analytics",
   "value": "2cceeae88503384f-00001188000089ca"
}

Der Wert sollte in Form von zwei 16-stelligen Hexadezimalzahlen oder zwei 19-stelligen Dezimalzahlen angegeben werden. Die Zahlen sollten durch einen Bindestrich, einen Unterstrich oder einen Doppelpunkt getrennt werden. Vorangestellte Nullen sollten hinzugefügt werden, wenn beide Zahlen nicht genügend Ziffern haben.

{
   "namespace": "ECID",
   "type": "standard",
   "value": "00497781304058976192356650736267671594"
}

Der Wert muss in Form einer 38-stelligen Dezimalzahl angegeben werden. Wenn Sie diese Zahl aus den beiden Spalten „mcvisid_high/low“ oder „post_msvisid_high/low“ aus einem Daten-Feed- oder Data Warehouse-Bericht beziehen, müssen Sie jede der beiden Zahlen mit Nullen auf 19 Stellen auffüllen und sie dann mit dem hohen Wert voran verknüpfen.

Es ist auch möglich, "namespaceId": 4 anstelle von oder zusätzlich zu "namespace": "ECID" zu verwenden. Auch andere Adobe-Produkte können diese Form verwenden.

NOTE
Die Experience Cloud ID (ECID) wurde früher als Marketing Cloud ID (MCID) bezeichnet. Dementsprechend findet sich dieser Name noch in älteren Dokumentationen.
Diese IDs sind die einzigen von Analytics unterstützten IDs, die für „type“ einen anderen Wert verwenden als „analytics“.

Wenn das Format des Werteteils einer dieser Cookie-IDs nicht dem für diese ID beschriebenen Format entspricht, schlägt die Datenschutzanfrage mit dem Fehler „Wert nicht korrekt formatiert“ fehl.

Sie werden diese Cookie-IDs in den meisten Fällen über das neue Datenschutz-JavaScript erfassen, das automatisch alle relevanten Schlüssel-/Wertpaare für diese JSON-IDs bereitstellt.

Der JavaScript-Code füllt den JSON-Abschnitt mit anderen Schlüssel-Wert-Paaren als den oben aufgeführten (Namespace, Typ, Wert). Die oben genannten Felder sind jedoch die wichtigsten für die Analytics-Datenschutzverarbeitung und die einzigen, die Sie bereitstellen müssen, wenn Sie IDs auf andere Weise erfassen.

Benutzerspezifische Besucher-ID

{
    "namespace": "customVisitorID",
    "type": "analytics",
    "value": "<ID>"
}

Der Namespace ist auch für die benutzerdefinierte Besucher-ID vordefiniert.

IDs in benutzerspezifischen Variablen

{
"namespace":"Email Address",
"type": "analytics",
"value": "john@xyz.com"
},
{
    "namespace": "CRM ID",
    "type": "analytics",
    "value": "123456-ABCD"
}

Bei IDs in benutzerspezifischen Traffic- oder Konversionsvariablen (Props oder eVars) müssen Sie die Variable mit einer ID-DEVICE- oder ID-PERSON-Kennzeichnung versehen und diesem ID-Typ daraufhin einen eigenen Namespace-Namen zuweisen. Siehe Namespace-Bereitstellung beim Beschriften einer Variablen als ID-DEVICE oder ID-PERSON.

Sie können auch Namespaces sehen, die Sie zuvor für andere Variablen oder Report Suites definiert haben, und einen dieser Namespaces wiederverwenden, sodass derselbe Namespace problemlos für alle Ihre Report Suites verwendet werden kann, die diesen ID-Typ speichern. Es ist auch möglich, denselben Namespace mehreren Variablen innerhalb einer Report Suite zuzuweisen. Einige Kunden speichern beispielsweise eine CRM-ID in einer Traffic-Variablen und eine Konversionsvariable (je nach Seite ist sie manchmal in der einen oder der anderen oder in beiden) und können den Namespace „CRM-ID“ beiden Variablen zuweisen.

TIP
Vermeiden Sie bei der Namespace-Angabe für die Data Privacy-API die Verwendung des Anzeigenamens einer Variablen (der auf der Benutzeroberfläche für das Reporting angezeigte Name) oder die Nummer der Variablen (z. B. eVar12), es sei denn, es handelt sich um den Namespace, den Sie beim Anwenden der Beschriftung ID-DEVICE oder ID-PERSON angegeben haben. Durch die Verwendung eines Namespace anstelle eines Anzeigenamens kann mithilfe desselben Benutzeridentitätsblocks die korrekte Variable für mehrere Report Suites angegeben werden. Dies ist beispielsweise der Fall, wenn die ID in manchen Report Suites in unterschiedlichen eVars ist oder die Anzeigenamen nicht übereinstimmen (z. B. wenn der Anzeigename für eine bestimmte Report Suite lokalisiert wurde).
CAUTION
Die Namespaces visitorId und customVisitorId sind zur Identifikation des früheren Tracking-Cookies von Analytics und der benutzerdefinierten Besucher-ID von Analytics reserviert. Verwenden Sie diese Namespaces nicht für benutzerdefinierte Traffic-Variablen oder Konversionsvariablen.

Weitere Informationen dazu finden Sie unter Namespace-Bereitstellung beim Beschriften einer Variablen als ID-DEVICE oder ID-PERSON.

recommendation-more-help
analytics-help-admin