FTPAnforderungen an Namen und Dateigrößen der über eingehenden Datendateien

Beschreibt die erforderlichen Felder, Syntax, Benennungskonventionen und Dateigrößen, die beim Senden von Daten an Audience Manager beachtet werden müssen. Legen Sie die Namen und Größen Ihrer Dateien entsprechend diesen Spezifikationen fest, wenn Sie Daten an einen Ordner FTP des Audience Managers senden.

WARNUNG

Die Unterstützung für FTP-Konfigurationen wird schrittweise eingestellt. Während die Erfassung eingehender Datendateien in bestehenden FTP -Integrationen weiterhin unterstützt wird, empfehlen wir dringend, Amazon S3 zu verwenden, um Offline-Daten für neue Integrationen zu integrieren. Weitere Informationen finden Sie unter Anforderungen an Namen und Dateigrößen der über Amazon S3 eingehenden Datendateien.

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 von Dateinamen

FTP -Dateinamen enthalten die folgenden erforderlichen und optionalen Elemente:

ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]

Weitere akzeptierte Dateinamenformate finden Sie unter Benutzerdefinierte Partnerintegrationen.

HINWEIS

Audience Manager nur Prozesse ASCII und UTF-8 kodierte Dateien.

Elemente benennen

Die Tabelle definiert die Elemente in einem FTP-Dateinamen.

Dateinamenelement Beschreibung

ftp_dpm_

Pfad und Name Ihres -Audience Managers FTP-Verzeichnisses. Wenden Sie sich an Ihren Kundenbetreuer, um das FTP-Verzeichnis und die Anmeldeinformationen zu erhalten.

DPID

Eine ID, die den Audience Manager angibt, wenn eine Datendatei Ihre eigenen Benutzer-IDs, Android-IDs, iOS-IDs oder andere IDs enthält, die zu globalen Datenquellen gehören. Akzeptiert die folgenden Optionen:

  • Datenquellen-ID (auch als Datenanbieter-ID bezeichnet): Hierbei handelt es sich um eine eindeutige ID, die Audience Manager einer Datenquelle zuweist (siehe Audience Manager- Index der IDs ). Verwenden Sie diese zugewiesene ID in einem Dateinamen, wenn Sie Daten senden, die Ihre eigenen Benutzer-IDs enthalten. Beispielsweise teilt ...ftp_dpm_21_123456789.sync dem Audience Manager Daten an IDs mit, die zur Datenquelle 21 gehören.
  • Android-IDs (GAID): Verwenden Sie die ID 20914 in einem Datendateinamen, wenn sie Android-IDs enthält. Sie müssen das Feld _DPID_TARGET_DATA_OWNER verwenden, wenn Sie Android-IDs verwenden. Beispielsweise teilt ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync dem Audience Manager mit, dass die Datendatei nur Android-IDs enthält und dass die IDs für die Eigenschaften qualifiziert sein sollten, die zur Datenquelle _DPID_TARGET_DATA_OWNER gehören.
  • iOS-IDs (IDFA): Verwenden Sie die ID 20915 in einem Datendateinamen, wenn sie iOS-IDs enthält. Sie müssen das Feld _DPID_TARGET_DATA_OWNER verwenden, wenn Sie iOS-IDs verwenden. Beispielsweise teilt ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync dem Audience Manager mit, dass die Datendatei nur iOS-IDs enthält und dass die IDs für die Eigenschaften qualifiziert sein sollten, die zur Datenquelle _DPID_TARGET_DATA_OWNER gehören.
  • IDs, die zu anderen globalen Datenquellen gehören: Sie können Roku-IDs für Werbung (RIDA), Microsoft Advertising IDs (MAID) und andere IDs integrieren. Verwenden Sie die Kennung, die jeder Datenquelle entspricht, wie im Artikel globale Datenquellen beschrieben.

Hinweis: Mischen Sie keine ID-Typen in Ihren Datendateien. Wenn Ihr Dateiname beispielsweise die Android-Kennung enthält, dürfen Sie iOS-IDs oder Ihre eigenen IDs nicht in die Datendatei aufnehmen.

_DPID_TARGET_DATA_OWNER

Dieses Feld gibt dem Audience Manager an, zu welcher Datenquelle Daten integriert werden sollen. Dieses Feld ist erforderlich, wenn Sie die DPID auf eine Android-ID, iOS-ID oder eine andere ID festlegen, die zu globalen Datenquellen gehört. Dadurch kann Audience Manager die Dateidaten wieder mit Ihrem Unternehmen verknüpfen.

Beispiel:

  • ...ftp_dpm_33_21_1234567890.sync teilt dem Audience Manager mit, dass Sie Kunden-IDs qualifizieren, die zur Datenquelle 33 gehören, und zwar für Eigenschaften oder Signale, die zur Datenquelle 21 gehören.
  • Android-IDs (GAID): ...ftp_dpm_20914_21_1234567890.sync teilt Audience Manager mit, dass die Datendatei nur Android-IDs enthält und dass die IDs für die Eigenschaften qualifiziert sein sollten, die zur Datenquelle 21 gehören.
  • iOS-IDs (IDFA): ...ftp_dpm_20915_21_1234567890.sync teilt Audience Manager mit, dass die Datendatei nur iOS-IDs enthält und die IDs für die Eigenschaften qualifiziert sein sollten, die zur Datenquelle 21 gehören.
  • IDs, die zu anderen globalen Datenquellen gehören: ...ftp_dpm_121963_21_1234567890.sync teilt Audience Manager mit, dass die Datendatei nur Roku-IDs enthält und dass die IDs für die Eigenschaften qualifiziert sein sollten, die zur Datenquelle 21 gehören. Verwenden Sie die Kennung, die jeder Datenquelle entspricht, wie im Artikel globale Datenquellen beschrieben.

(.sync |.overwrite)

Zu den Synchronisierungsoptionen gehören:

  • sync: Normales Szenario, in dem Datenanbieter von Drittanbietern Eigenschaften pro Benutzer senden, um sie im Audience Manager-System hinzuzufügen oder zu entfernen.
  • overwrite: Ermöglicht es Kunden und Datenanbietern, eine Liste von Eigenschaften pro Benutzer zu senden, die alle vorhandenen Eigenschaften dieses Benutzers für eine bestimmte Datenquelle in Audience Manager überschreiben sollten. Sie müssen nicht alle Ihre Benutzer in eine Überschreibungsdatei aufnehmen. Schließen Sie nur die Benutzer ein, die Sie ändern möchten. Eigenschaften, die nicht der Zieldatenquelle zugewiesen sind, werden nicht gelöscht.

[SPLIT_NUMBER]

Eine Ganzzahl. Wird verwendet, wenn Sie große Dateien in mehrere Teile aufteilen, um die Verarbeitungszeiten zu verbessern. Die Zahl gibt an, welcher Teil der Originaldatei Sie senden.

Um eine effiziente Dateiverarbeitung zu gewährleisten, teilen Sie Ihre Datendateien wie angegeben auf:

  • unkomprimiert: 1 GB
  • Komprimiert: 200-300 MB

Siehe die ersten 2 Beispiele für Dateinamen unten.

TIMESTAMP

Ein 10-stelliger UTC UNIX-Zeitstempel in Sekunden. Der Zeitstempel hilft dabei, jeden Dateinamen eindeutig zu machen.

[.gz]

Gzip ist das zulässige Komprimierungsformat für einen FTP-Dateinamen. Wenn Sie die Dateikomprimierung verwenden, stellen Sie sicher, dass der Dateiname über die richtige Erweiterung verfügt.

Komprimierte Dateien müssen 3 GB oder kleiner sein. Wenn Ihre Dateien größer sind, wenden Sie sich an die Kundenunterstützung. Obwohl Audience Manager große Dateien verarbeiten kann, können wir Ihnen möglicherweise helfen, die Dateigröße zu reduzieren und die Datenübertragung effizienter zu gestalten. Siehe Dateikomprimierung für eingehende Datenübertragungsdateien .

Beispiele für Dateinamen

Die folgenden Beispiele zeigen ordnungsgemäß formatierte Dateinamen. Ihre Dateinamen könnten ähnlich aussehen.

  • ftp_dpm_478_1366545717.sync.1.gz
  • ftp_dpm_478_1366545717.sync.2.gz
  • ftp_dpm_478_1366545717.overwrite

[] (assets/ftp_dpm_1234_1445374061.overwrite) Laden Sie die Beispieldatei herunter, wenn Sie zusätzliche Beispiele benötigen. Diese Datei wird mit der Dateierweiterung .overwrite gespeichert. Öffnen Sie es mit einem einfachen Texteditor.

Akzeptierte Dateigrößen

Beachten Sie die folgenden Zahlen für die schnellste/früheste Verarbeitung Ihrer Dateien sowie für Dateigrößenbeschränkungen beim Senden von Daten an ein Audience Manager / FTP-Verzeichnis.

Dateityp Optimale Größe Maximale Größe
Komprimiert

200-300 MB

3 GB

unkomprimiert

1 GB

5 GB

Auf dieser Seite