Anforderungen an den Namen und den Inhalt von ID-Synchronisierungsdateien

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

HINWEIS

Die Textstile (monospaced text, kursiv, Klammern [ ] ( ) usw.) in diesem Dokument Code-Elemente und -Optionen angeben. 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 bei der Zuordnung von Geräte-IDs zu anderen Geräte-IDs oder Kunden-IDs (DPUUIDs).

c2c_id

Ein statisches Präfix, das die Datei als ID-Synchronisierungsdatei für People-basierte Ziele angibt. Verwenden Sie dieses Präfix bei der Zuordnung von Kunden-IDs (DPUUIDs) zu Hash-E-Mail-Adressen für personenbasierte Ziele.

MASTERDPID

Die Übergeordnete Datenanbieter-ID ist die übergeordnete ID der DPIDs im Dateinamen. Außerdem entspricht die erste Benutzer-ID in der Datendatei der Übergeordneten ID. Die nachfolgenden DPIDs sind andere IDs, die zum Übergeordneten 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. Sie darf keine DPUUIDs enthalten. Dies kann zu einer falschen Synchronisierung führen.

DPID

Datenanbieter-IDs. Diese IDs stellen Entitäten oder Datenquellen dar, die mit der Übergeordneten 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, Ihr Dateiname enthält eine Übergeordnete DPID und 3 DPIDs. Ihre Datendatei muss 4 entsprechende Spalten von 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

Gibt 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 zur Verbesserung der Verarbeitungszeiten bei. Die Zahl gibt an, welcher Teil der Originaldatei Sie senden. Siehe Beispiele für Dateinamen unten.

[.gz]

Gibt an, dass Ihre Datei mit optionaler gzip-Komprimierung komprimiert ist.

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 - Personalisierung basierend auf allen Online-Aktivitäten in Kombination mit Offline-Daten oder Workflow B - Personalisierung basierend 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. Ihre Inhalte könnten ähnlich aussehen.

abc123 def456 ghi789 xyz987

Überlegungen zum Dateiinhalt

Stellen Sie beim Erstellen Ihrer eingehenden Dateien sicher, dass in der ersten Spalte nur Geräte-IDs wie AAM UUID, GAID, IDFA usw. enthalten sind. Eine ausführliche Erläuterung der vom Audience Manager unterstützten IDs finden Sie unter Index der IDs in Audience Manager.

WICHTIG

Verwenden Sie nicht DPUUIDs in der ersten Spalte. Dies kann zu einer falschen Synchronisierung führen.

Synchronisierung stimmt mit DPUUIDs mit UUIDs überein

Eine ID-Synchronisierungsdatei dient der Synchronisierung der DPUUIDs aus Ihren eigenen Data Sources mit Audience Manager UUIDs. Die Synchronisierung ordnet die DPUUIDs aus dem Übergeordneten DPID und die zugehörigen DPIDs den Audience Manager UUIDs zu. Wenn Sie die IDs in den Dateinamen setzen, bestimmt der Hauptteil, wie diese IDs einander zugeordnet werden. Nehmen Sie beispielsweise 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 der Inhalte ordnen die IDs wie folgt zu:

Datei 1 ( Beispieldatei herunterladen)

DPID 0 = Adobe Audience Manager UUIDs DPID 12345
68079982765673198504052656074456196039 XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38
67412682083411995725538770443620307584 XYZ3017BR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
89159024796760343733111707646026765593 XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094 XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
66184778222667870903738139438735041506 XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

Schritt 1: Der ID-Synchronisierungsprozess synchronisiert die DPUUIDs von DPID 12345 mit den Audience Manager UUIDs in der linken Spalte. Beachten Sie, dass DPID "0"im Dateinamen Audience Manager UUIDs darstellt.

Datei 2 ( Beispieldatei herunterladen)

DPID 12345 DPID 67890
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38 4598060374
XYZ3017BR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70 4581274262
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM 4392434426
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M 2351382994
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw 4601584763

Schritt 2: die DPUUIDs von DPID 12345 wurden in Schritt 1 mit dem Audience Manager UUIDs synchronisiert. Diese ID-Synchronisierung synchronisiert die DPUUIDs von DPID 67890 mit dem Audience Manager UUIDs aus Schritt 1.


Weitere Formatanforderungen

Benutzer-IDs können nicht:

  • Fügen Sie die Kennung selbst mit Registerkarten hinzu. Registerkarten werden nur zum Trennen einzelner IDs in der Datendatei verwendet.
  • Personenbezogene Informationen enthalten (PII).
  • Verwenden Sie die Kodierung URL. Nur nicht kodierte IDs übergeben.

Alle Zeilen, die mit Tabulatoren oder Leerzeichen enden, werden nicht verarbeitet oder realisiert. Achten Sie in der Regel darauf, dass das Ende der Zeilen klar ist.

Auf dieser Seite