Show Menu
THEMEN×

Amazon S3Anforderungen 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 Managereingehalten werden müssen. Legen Sie die Namen und Größen Ihrer Dateien entsprechend diesen Spezifikationen fest, wenn Sie Daten an ein Audience Manager /- Amazon S3 Verzeichnis senden.
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 des Dateinamens

S3 Dateinamen enthalten die folgenden erforderlichen und optionalen Elemente:
  • S3Präfix: s3n://AWS_directory/partner_name/date=yyyy-mm-dd/
  • Dateinamenelemente: ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]
Weitere akzeptierte Dateinamenformate finden Sie unter Benutzerdefinierte Partnerintegrationen .
Audience Manager verarbeitet ASCII und UTF-8 kodiert.

Elemente benennen

Die Tabelle definiert die Elemente in einem S3 Dateinamen.
Namenselement Beschreibung
AWS_directory
Der Pfad und der Name Ihres Amazon S3-Behälters. Wenden Sie sich an Ihren Kundenbetreuer, um Ihren S3-Ordnernamen, -Pfad und Ihre Anmeldeinformationen zu erhalten.
date= yyyy-mm-dd
Ein Zeitstempel (basierend auf der UTC-Zeit), mit dem die Dateien an den S3-Behälter gesendet werden.
DPID
Eine ID, die dem Audience Manager mitteilt, ob 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 mit Ihren eigenen Benutzer-IDs senden. Weisen Sie z. B. ...ftp_dpm_21_123456789.sync Audience Manager zu integrierten Daten an IDs aus, die zu 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 verwenden, _DPID_TARGET_DATA_OWNER wenn Sie Android-IDs verwenden. Weist ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync Audience Manager beispielsweise an, 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 verwenden, _DPID_TARGET_DATA_OWNER wenn Sie iOS-IDs verwenden. Weisen Sie beispielsweise ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync den Audience Manager an, 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 zu globalen 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 kann 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 weist Audience Manager an, dass die Datendatei nur Android-IDs enthält und die IDs für die Eigenschaften von Datenquelle 21 qualifiziert sein sollten.
  • iOS-IDs (IDFA): ...ftp_dpm_20915_21_1234567890.sync weist Audience Manager an, dass die Datendatei nur iOS-IDs enthält und die IDs für die Eigenschaften von Datenquelle 21 qualifiziert sein sollten.
  • IDs, die zu anderen globalen Datenquellen gehören: ...ftp_dpm_121963_21_1234567890.sync weist Audience Manager an, dass die Datendatei nur Roku-IDs enthält und die IDs für die Eigenschaften von Datenquelle 21 qualifiziert sein sollten. Verwenden Sie die ID für jede Datenquelle, wie im Artikel zu globalen Datenquellen beschrieben.
partner_name
Der Firmen- oder Organisationsname, den Sie in Audience Manager verwenden.
TIMESTAMP
Ein 10-stelliger UTC UNIX-Zeitstempel in Sekunden. Der Zeitstempel hilft, jeden Dateinamen eindeutig zu machen.
(.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 : Damit können Datenanbieter eine Liste von Eigenschaften pro Benutzer senden, die alle bestehenden Drittanbietereigenschaften dieses Benutzers für diesen Datenanbieter im Audience Manager überschreiben sollte. Sie müssen nicht alle Benutzer in eine Überschreibungsdatei einschließen. Schließen Sie nur die Benutzer ein, die Sie ändern möchten.
[ 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 beiden Beispiele für Dateinamen unten.
[.gz]
Verwenden Sie beim Senden von Dateien an Amazon S3 nur die gzip-Komprimierung. Nach der Komprimierung erhalten diese Dateien die .gz Erweiterung. Verwenden Sie keine ZIP-Komprimierung.
Komprimierte Dateien müssen mindestens 3 GB groß sein. Wenn 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.
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.1.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.2.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_567_1366545717.sync.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.overwrite
Sie können die Beispieldatei # (assets/ftp_dpm_1234_1445374061.overwrite) , wenn Sie weitere Beispiele wünschen. Diese Datei wurde mit der .overwrite Dateierweiterung gespeichert. Öffnen Sie es mit einem einfachen Texteditor.

Akzeptierte Dateigrößen

Betrachten Sie die unten stehenden Zahlen für eine schnellste/früheste Verarbeitung Ihrer Dateien sowie für Dateigrößenbeschränkungen, wenn Sie Daten an ein Audience Manager / Amazon S3 Verzeichnis senden.
Dateityp Optimale Größe Maximale Größe
komprimiert
200-300 MB
3 GB
unkomprimiert
1 GB
5 GB
Der Prozess der eingehenden Datenvalidierung markiert leere Dateien als ungültig und verarbeitet sie nicht.