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

Beschreibt die erforderlichen Felder, die Syntax, Benennungskonventionen und Dateigrößen, die beim Senden der Daten an Audience Manager eingehalten werden müssen. Legen Sie die Namen und Größen Ihrer Dateien entsprechend diesen Spezifikationen fest, wenn Sie Daten an einen Audience Manager FTP 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 zur Integration von Offlinedaten für neue Integrationen zu verwenden. 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 Codeelemente und Optionen angeben. Weitere Informationen finden Sie unter Stilkonventionen für Code und Textelemente.

Syntax für 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 verarbeitet ASCII und UTF-8 kodiert.

Elemente benennen

Die Tabelle definiert die Elemente in einem FTP-Dateinamen.

Dateinamenelement Beschreibung

ftp_dpm_

Pfad und Name des -Audience Managers FTP-Ordners. Wenden Sie sich an Ihren Kundenbetreuer, um den FTP-Ordner und die Anmeldeinformationen zu erhalten.

DPID

Eine ID, die angibt, dass Audience Manager angezeigt wird, 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): Diese eindeutige ID wird von Audience Manager einer Datenquelle zugewiesen (siehe Index der IDs des Audience Managers ). Verwenden Sie diese zugewiesene ID in einem Dateinamen, wenn Sie Daten mit Ihren eigenen Benutzer-IDs senden. ...ftp_dpm_21_123456789.sync weist z. B. Audience Manager an, dass Daten an Bord von IDs aus der Datenquelle 21 gesendet werden.
  • 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 Audience Manager mit, dass die Datendatei nur Android-IDs enthält und die IDs für die Eigenschaften der _DPID_TARGET_DATA_OWNER-Datenquelle qualifiziert sein sollten.
  • 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 Audience Manager mit, dass die Datendatei nur iOS-IDs enthält und die IDs für die Eigenschaften der _DPID_TARGET_DATA_OWNER-Datenquelle qualifiziert sein sollten.
  • IDs, die zu anderen globalen Datenquellen gehören: Sie können Roku-IDs für Werbung (RIDA), Microsoft Advertising IDs (MAID) und andere IDs einbinden. Verwenden Sie die ID für jede Datenquelle, wie im Artikel "Globale Datenquellen"beschrieben.

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

_DPID_TARGET_DATA_OWNER

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

Beispiel:

  • ...ftp_dpm_33_21_1234567890.sync weist Audience Manager an, dass Sie Kunden-IDs aus der Datenquelle 33 für Eigenschaften oder Signale aus der Datenquelle 21 qualifizieren.
  • 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 von Datenquelle 21 qualifiziert sein sollten.
  • 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 der Datenquelle 21 qualifiziert sein sollten.
  • 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 die IDs für die Eigenschaften der Datenquelle 21 qualifiziert sein sollten. Verwenden Sie die ID für jede Datenquelle, wie im Artikel "Globale Datenquellen"beschrieben.

(.sync |.overwrite)

Zu den Synchronisierungsoptionen gehören:

  • sync: Normales Szenario, bei dem Drittanbieter von Daten Eigenschaften auf Benutzerbasis senden, die im Audience Manager-System hinzugefügt oder entfernt werden sollen.
  • overwrite: Ermöglicht es Kunden und Datenanbietern, eine Liste von Eigenschaften pro Benutzer zu senden, die alle bestehenden Eigenschaften dieses Benutzers für eine bestimmte Datenquelle in Audience Manager überschreiben sollten. Sie müssen nicht alle Benutzer in eine Überschreibungsdatei einschließen. Schließen Sie nur die Benutzer ein, die Sie ändern möchten. Eigenschaften, die nicht der Datenquelle der Zielgruppe zugewiesen sind, werden nicht gelöscht.

[SPLIT_NUMBER]

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

Zur effizienten Dateiverarbeitung teilen Sie die Datendateien wie folgt:

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

Siehe die ersten 2 Dateinamenbeispiele unten.

TIMESTAMP

Ein 10-stelliger UTC UNIX-Zeitstempel in Sekunden. Der Zeitstempel hilft, 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 die richtige Erweiterung hat.

Komprimierte Dateien müssen mindestens 3 GB groß sein. Falls Ihre Dateien größer sind, wenden Sie sich bitte an den Kundendienst. 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 korrekt 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

[Wenn Sie weitere Beispiele benötigen, ] (assets/ftp_dpm_1234_1445374061.overwrite) laden Sie die Beispieldatei herunter. Diese Datei wird mit der Dateierweiterung .overwrite gespeichert. Öffnen Sie es mit einem einfachen Texteditor.

Akzeptierte Dateigrößen

Betrachten Sie die folgenden Zahlen für die schnellste/früheste Verarbeitung Ihrer Dateien sowie für Dateigrößenbeschränkungen, wenn Sie Daten an einen Ordner Audience Manager / FTP senden.

Dateityp Optimale Größe Maximale Größe
komprimiert

200-300 MB

3 GB

unkomprimiert

1 GB

5 GB

Auf dieser Seite