Dokumentation Audience Manager Benutzerhandbuch für Audience Manager

Name und Inhaltsanforderungen für ID-Synchronisierungsdateien

Letzte Aktualisierung: 20. Dezember 2024

Themen:

Beschreibt die erforderlichen Felder, die Syntax und die Namenskonventionen, die für die dateibasierte ID-Synchronisierung verwendet werden. Benennen und organisieren Sie Ihre Dateiinhalte gemäß diesen Spezifikationen.

HINWEIS

Die Textstile (monospaced text, kursiv, Klammern [ ] ( ) usw.) in diesem Dokument weisen auf Codeelemente und Optionen hin. Weitere Informationen finden Sie unter Stilkonventionen für Code und Textelemente.

Syntax und Beispiele für Dateinamen

ID-Dateinamen enthalten die folgenden erforderlichen und optionalen Elemente:

[adobe_id_] [c2c_id_]MASTERDPID_DPID[_DPID]_TIMESTAMP.sync[.SPLIT_NUMBER][.gz]

Parameter	Beschreibung
`adobe_id`	Ein statisches Präfix, das die Datei als ID-Synchronisierungsdatei angibt. Verwenden Sie dieses Präfix, wenn Sie Geräte-IDs mit anderen Geräte-IDs oder Kunden-IDs (DPUUIDs) abgleichen.
`c2c_id`	Ein statisches Präfix, das die Datei als ID-Synchronisierungsdatei für People-Based Destinations identifiziert. Verwenden Sie dieses Präfix, wenn Sie Kunden-IDs (DPUUIDs) mit Hash-E-Mail-Adressen für personenbasierte Ziele abgleichen.
`MASTERDPID`	Die Master-Datenanbieter-ID ist die übergeordnete ID der DPIDs im Dateinamen. Außerdem entspricht die erste Benutzer-ID in der Datendatei der Master-ID. Die nachfolgenden DPIDs sind andere Kennungen, die zum Master gehören. Bei der Synchronisierung werden DPIDs im Dateinamen UUIDs in der Datei zugeordnet. Diese DPID darf nur Geräte-IDs wie AAM UUID, GAID, IDFA usw. enthalten. Es darf keine DPUUIDs enthalten. Andernfalls kann es zu einer falschen Synchronisierung kommen.
`DPID`	Datenanbieter-IDs. Diese IDs stellen Entitäten oder Datenquellen dar, die mit der Master-DPID verknüpft sind. Bei der Synchronisierung werden DPIDs im Dateinamen UUIDs in der Datei zugeordnet. Die Anzahl der DPIDs im Dateinamen muss mit der Anzahl der UUIDs in der Datendatei übereinstimmen. Angenommen, der Dateiname enthält eine Master-DPID und drei DPIDs. Ihre Datendatei muss 4 entsprechende Spalten mit UUIDs enthalten, die wie im Abschnitt Dateiinhalt unten beschrieben formatiert sind.
`timestamp`	Ein 10-stelliger UNIX-Zeitstempel in Sekunden. Der Zeitstempel hilft dabei, jeden Dateinamen eindeutig zu machen.
`.sync`	Zeigt eine normale, vollständige Synchronisierung an.
`[.SPLIT_NUMBER]`	Eine Ganzzahl. Wird verwendet, wenn Sie große Dateien in mehrere kleinere Dateien aufteilen. Dies trägt dazu bei, die Verarbeitungszeiten zu verbessern. Die Zahl gibt an, welchen Teil der Originaldatei Sie senden. Siehe Beispiele für Dateinamen unten.
`[.gz]`	Gibt an, dass die Datei mit optionaler GZIP-Komprimierung komprimiert wird.

Beispiele für Dateinamen

Die folgenden Beispiele zeigen ordnungsgemäß formatierte Dateinamen. Ihre Dateinamen könnten ähnlich aussehen.

adobe_id_111_222_333_444_1454442149.sync
adobe_id_123_898_456_1454442149.sync.1.gz
adobe_id_123_898_456_1454442149.sync.2.gz
c2c_id_123_898_1454442149.sync.gz

HINWEIS

Informationen zur Benennung der ID-Synchronisierungsdatei (c2c-Präfix) für personenbasierte Ziele finden Sie unter Workflow A - Personalization basiert auf allen Online-Aktivitäten kombiniert mit Offline-Daten oder Workflow B - Personalization basiert auf reinen Offline-Daten.

Syntax und Beispiele für Dateiinhalte

Der Inhalt einer ID-Datei umfasst die folgenden Elemente:

UUID <tab>UUID<tab>UUID<tab>UUID

Die Datei enthält Benutzer-IDs (UUID). Trennen Sie die IDs in jeder Zeile durch eine Registerkarte. Das folgende Beispiel zeigt eine ordnungsgemäß formatierte ID-Datei. Ihr Inhalt könnte ähnlich aussehen.

abc123 def456 ghi789 xyz987

Überlegungen zum Dateiinhalt

Stellen Sie bei der Erstellung Ihrer eingehenden Dateien sicher, dass die erste Spalte nur mit Geräte-IDs wie AAM UUID, GAID, IDFA usw. gefüllt ist. Unter Index der IDs im Audience Managerfinden Sie eine detaillierte Erklärung der vom Audience Manager unterstützten IDs.

IMPORTANT

Verwenden Sie DPUUIDs nicht in der ersten Spalte. Andernfalls kann es zu einer falschen Synchronisierung kommen.

Synchronisierung gleicht DPUUIDs mit UUIDs ab

Der Zweck einer ID-Synchronisierungsdatei besteht darin, die DPUUIDs aus Ihren eigenen Datenquellen mit Audience Manager UUIDs zu synchronisieren. Bei der Synchronisierung werden die DPUUID vom primären DPID und den zugehörigen DPID auf die Audience Manager UUID abgebildet. Wobei Sie die IDs in den Dateinamen einfügen und der Hauptteil bestimmt, wie diese Kennungen einander zugeordnet werden. Nehmen wir zum Beispiel die beiden folgenden Beispieldateien:

Datei 1: adobe_id_0_12345_1476312152.sync
Datei 2: adobe_id_12345_67890_1476312876.sync

Unter Berücksichtigung des Beispielnamens und des Inhalts werden die IDs wie folgt zugeordnet:

Datei 1 ( Beispieldatei herunterladen)

DPID 0 = Adobe Audience Manager-UUIDs

DPID 12345

68079982765673198504052656074456196039

XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR38

67412682083411995725538770443620307584

XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70

89159024796760343733111707646026765593

XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM

66552757407517449462805881945288602094

XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M

66184778222667870903738139438735041506

XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

Schritt 1: Der ID-Synchronisierungsvorgang synchronisiert die DPUUID von DPID 12345 mit den Audience Manager UUID in der linken Spalte. Beachten Sie, dass die DPID „0“ im Dateinamen Audience Manager UUIDs darstellt.

Datei 2 ( Beispieldatei herunterladen)

DPID 12345

DPID 67890

XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR38

4598060374

XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70

4581274262

XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM

4392434426

XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M

2351382994

XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

4601584763

Schritt 2: Die DPUUIDs aus DPID 12345 wurden in Schritt 1 mit den UUID des Audience Managers synchronisiert. Diese ID-Synchronisierung synchronisiert die DPUUID aus DPID 67890 mit den Audience Manager UUID Schritt 1.

Andere Formatanforderungen

Benutzer-IDs können nicht:

Die ID selbst enthält Registerkarten. Registerkarten werden nur verwendet, um einzelne IDs in der Datendatei zu trennen.
Enthalten persönlich identifizierbare Informationen (PII).
URL verwenden. Übergeben Sie nur unverschlüsselte IDs.

Zeilen, die mit Tabulatoren oder Leerzeichen enden, werden nicht verarbeitet oder realisiert. In der Regel ist darauf zu achten, dass das Ende der Zeilen nicht verdeckt ist.

recommendation-more-help