Name der ausgehenden Datendatei: Syntax und Beispiele

Letzte Aktualisierung: 2021-08-19

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

HINWEIS

Die Stilelemente (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 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 einer ausgehenden Datendatei.

Dateinamenelement Beschreibung

SYNC_TYPE

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

  • FTP - Übertragung mit SFTP
  • Amazon S3 - Übertragung auf Amazon AWS

DID

Ziel-ID.

Im Audience Manager ist ein Ziel die Integrationsinstanz, in der Sie Ihre Zielsegmente zuordnen können. Kunden können je nach Geschäftsanforderung über mehrere Ziele verfügen.

MASTER_DPID

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

  • 20914 - Google Advertiser ID (roh, ungehasht)
  • 20915 - Apple ID für Advertiser (roh, ungehasht)
  • Anbieter-ID - Drittanbieter-Benutzer-IDs (Web/Cookie)

Weitere Informationen finden Sie unter Globale Data Sources.

PID_ALIAS

Die Kunden-ID von der Drittanbieter-Plattform.

SYNC_MODE

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

  • iter : Gibt eine "iterative"oder inkrementelle Synchronisation 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.

TIMESTAMP

Ein 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 Verarbeitungszeiten zu verbessern. Die Zahl gibt an, zu welchem Teil der Originaldatei die Daten gehören.

Die Ganzzahl muss mindestens 3 Ziffern lang sein, wobei Nullen vorangestellt werden, wenn die Aufspaltungsgröße weniger als 100 Teile beträgt.

Die ursprüngliche Datei hat keine Aufspaltungsnummer. Die erste Aufspaltungsdatei 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.

Beispielsweise 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, die an den Speicherort FTP gesendet werden, ohne PID_ALIAS und mit Apple Advertiser IDs im Dateiinhalt:

Beispielsweise 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, die an den FTP Speicherort gesendet werden, mit PID_ALIAS="XYZCustomer" und mit Benutzer-ID von Drittanbietern im Dateiinhalt ( Vendor ID=45454):

Beispielsweise 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

Inhalt der ausgehenden Datendatei: Syntax und Parameter

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

HINWEIS

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

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.

Parameter Beschreibung

UUID

Eine eindeutige Benutzer-ID, die von Audience Manager zugewiesen wird.

<SPACE>

Trennen Sie die UUID- und Segmentdaten durch ein Leerzeichen

SEGMENT_N

Die Segment-ID, zu der ein Besucher gehört. Trennen Sie mehrere Segmente durch ein Komma.

REMOVED_SEGMENT_N

Die Segment-ID, von der der Benutzer disqualifiziert wurde. Trennen Sie mehrere Segmente durch ein Komma. Bei vollständiger Synchronisierung können Sie die entfernten Segmente ignorieren, da die Datendatei die vollständige Liste der aktuellen Segmente für den Benutzer enthält. Normalerweise möchten Sie mehr über Segmente wissen, zu denen ein Benutzer gehört, als über Segmente, aus denen er entfernt wurde. Siehe auch Name der ausgehenden Datendatei: Syntax und Beispiele .

Beispiel: Grundlegendes Dateiformat

Eine ordnungsgemäß formatierte Datendatei könnte dem folgenden Beispiel ähneln. Dieser Dateieintrag zeigt an, dass ein Benutzer für die Segmente 24, 26 und 27 qualifiziert ist. Bei Bedarf werden die UUID- und die Segment-IDs durch ein Leerzeichen getrennt. Ein anderes Leerzeichen trennt die Sätze der Segment-IDs. In diesem Beispiel gehört ein Benutzer zu den Segmenten 24, 26 und 27. Sie wurden aus den Segmenten 25 und 28 entfernt.

59767559181262060060278870901087098252  24,26,27  25,28

Auf dieser Seite