Name und Inhaltsanforderungen für ID-Synchronisierungsdateien name-and-content-requirements-for-id-synchronization-files

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.

NOTE
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 file-name-syntax

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
NOTE
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 file-content-syntax

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 considerations

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 sync-matches-dpuuids-uuids

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 other-format-reqs

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
de293fbf-b489-49b0-8daa-51ed303af695