DokumentationAudience ManagerBenutzerhandbuch für Audience Manager

Name der ausgehenden Datendatei: Syntax und Beispiele outbound-data-file-name-syntax-and-examples

Last update: Fri Dec 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 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 syntax-file-name

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.

Dateinamenelement
Beschreibung
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_ALIAS
Die 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.
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 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 file-name-examples

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 outbound-contents-syntax

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.

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 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.

Beispiel: Grundlegendes Dateiformat

Eine ordnungsgemäß formatierte Datendatei könnte dem folgenden Beispiel ähneln. Dieser Dateieintrag gibt an, dass ein Benutzer für die Segmente 24, 26 und 27 qualifiziert ist. Bei Bedarf werden die UUID- und Segment-IDs durch ein Leerzeichen getrennt. Ein weiteres Leerzeichen trennt die Gruppen von 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
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695