Name der ausgehenden Datendatei: Syntax und Beispiele

Letzte Aktualisierung: 20. Dezember 2024
  • Themen:

Beschreibt die erforderlichen Felder, die Syntax und die Konventionen zum Benennen einer ausgehenden Datendatei.

NOTE
Die Stilelemente (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 Dateinamenelemente

Ausgehende Dateinamen enthalten die folgenden Elemente. Alle folgenden Elemente sind optional.

[SYNC_TYPE][_DID][_MASTER_DPID][_PID_ALIAS][_SYNC-MODE][_TIMESTAMP]SPLITNUM.sync[.gz]

Parameter

Die Tabelle definiert die Elemente in einem Namen für eine ausgehende Datendatei.

DateinamenelementBeschreibung
SYNC_TYPE

Bezieht sich auf die Datenübertragungsmethoden. Zu den Übertragungsmethoden gehören:

  • FTP - Übertragung über SFTP
  • Amazon S3 - Weiterleitung an Amazon AWS
DID

Ziel-ID.

In Audience Manager- ist ein Ziel die Instanz der Integration, in der Sie Ihre Zielgruppensegmente zuordnen können. Abhängig von den Geschäftsanforderungen können Kunden über mehrere Ziele verfügen.

MASTER_DPID

Datenanbieter- oder Datenquellen-ID. Diese ID identifiziert den Typ der im Dateiinhalt vorhandenen Benutzer-ID. Die häufigsten Benutzer-ID-Schlüssel sind:

  • 20914 - Google Advertiser-ID- (Roh, ungehasht)
  • 20915 - Apple-ID für Advertisers- (unbearbeitet, ungehasht)
  • Anbieter-ID - Benutzer-IDs von Drittanbietern (Web/Cookie)

Weitere Informationen finden Sie unter Globale Data Sources.

PID_ALIASDie Kundenkennung der Drittanbieterplattform.
SYNC_MODE

Der Synchronisierungsmodus ist ein Makro-Platzhalter, der dem Dateinamen je nach Synchronisierungstyp eine Bezeichnung hinzufügt. Zu den Synchronisierungstypen gehören vollständig und inkrementell. Sie werden im Dateinamen als iter oder full angezeigt.

  • iter : Gibt eine „iterative“ oder inkrementelle Synchronisierung an. Eine inkrementelle Datei enthält nur neue Daten, die seit der letzten Synchronisierung erfasst wurden.
  • full : Gibt eine „vollständige“ Synchronisierung an. Eine vollständig synchronisierte Datei enthält alte Daten und alle neuen Daten, die seit der letzten Synchronisierung erfasst wurden.
TIMESTAMPEin 13-stelliger UNIX-Zeitstempel in Millisekunden in der UTC-Zeitzone.
SPLITNUM

Eine Ganzzahl. Identifiziert einen Teil einer Datei, der in mehrere Teile aufgeteilt wurde, um die Verarbeitungszeit zu verbessern. Die Zahl gibt an, zu welchem Teil der Originaldatei die Daten gehören.

Wenn die Aufspaltungsgröße weniger als 100 Teile beträgt, muss die Ganzzahl mindestens 3 Ziffern lang sein, denen Nullen vorangestellt sind.

Die Originaldatei hat keine Aufspaltungsnummer. Die erste aufgeteilte Datei endet mit 001. Siehe Beispiele unten.

.gz (optional)GZIP-Komprimierung.

Beispiele für Dateinamen

Szenario 1

Dateien, die an einen Amazon S3 Speicherort gesendet werden, mit PID_ALIAS="XYZCustomer" und mit Google Advertiser IDs im Dateiinhalt.

Z. B. inkrementelle Dateien:

  • S3_1234_20914_XYZCustomer_iter_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000001.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000002.sync.gz

Z. B. vollständige Dateien:

  • S3_1234_20914_XYZCustomer_full_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_full_1486140844000001.sync.gz

Szenario 2

Dateien werden ohne PID_ALIAS und mit Apple Advertiser IDs im Dateiinhalt an FTP Speicherort gesendet:

Z. B. inkrementelle Dateien:

  • ftp_1234_20915_iter_1486140843000.sync.gz
  • ftp_1234_20915_iter_1486140843000001.sync.gz

Z. B. vollständige Dateien:

  • ftp_1234_20915_full_1486140843000.sync.gz
  • ftp_1234_20915_full_1486140843000001.sync.gz

Szenario 3: Dateien werden an FTP Speicherort gesendet, mit PID_ALIAS="XYZCustomer" und mit Benutzer-ID von Drittanbietern im Dateiinhalt ( Vendor ID=45454):

Z. B. inkrementelle Dateien:

  • ftp_1234_45454_XYZCustomer_iter_1486140843000.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz

Z. B. vollständige Dateien:

  • ftp_1234_45454_XYZCustomer_full_1486140843200.sync.gz
  • ftp_1234_45454_XYZCustomer_full_1486140843200001.sync.gz

Inhalte ausgehender Datendateien: Syntax und Parameter

Beschreibt die erforderlichen Felder, Syntax und Konventionen zum Organisieren von Informationen in einer ausgehenden Datendatei. Formatieren Sie Ihre Daten entsprechend diesen Spezifikationen.

NOTE
Die Stilelemente (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

Die Felder in der Datendatei werden in der folgenden Reihenfolge angezeigt:

UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...

Parameter

Die Tabelle listet Variablen auf, die den Inhalt einer Datendatei definieren.

ParameterBeschreibung
UUIDEine eindeutige Benutzer-ID, die von Audience Manager- zugewiesen wird.
<SPACE>Trennen Sie die UUID- und Segmentdaten durch ein Leerzeichen
SEGMENT_NDie Segment-ID, zu der ein Besucher gehört. Trennen Sie mehrere Segmente durch ein Komma.
REMOVED_SEGMENT_NDie Segment-ID, von der der Benutzer ausgeschlossen wurde. Trennen Sie mehrere Segmente durch ein Komma. Bei einer vollständigen Synchronisierung können Sie die entfernten Segmente ignorieren, da die Datendatei die vollständige Liste der aktuellen Segmente für den Benutzer enthält. In den meisten Fällen möchten Sie mehr über Segmente wissen, zu denen ein Benutzer gehört, als über die Segmente, aus denen er entfernt wurde. Siehe auch Name der ausgehenden Datendatei: Syntax und Beispiele.