Amazon S3 Anforderungen an Namen und Dateigrößen der eingehenden Datendateien amazon-s-name-and-file-size-requirements-for-inbound-data-files

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 ein Verzeichnis Audience Manager / Amazon S3 senden.

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

Dateinamensyntax file-name-syntax

S3 -Dateinamen enthalten die folgenden erforderlichen und optionalen Elemente:

  • S3prefix: 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.

NOTE
Audience Manager verarbeitet nur die kodierten Dateien ASCII und UTF-8.

Elemente benennen

Die Tabelle definiert die Elemente in einem S3 -Dateinamen.

Namenselement
Beschreibung
AWS_directory
Pfad und Name Ihres Amazon S3-Buckets. Wenden Sie sich an Ihren Kundenbetreuer, um den Namen, den Pfad und die Anmeldeinformationen Ihres S3-Ordners zu erhalten.
date=yyyy-mm-dd
Ein Zeitstempel (basierend auf der UTC-Zeit) des Zeitpunkts, zu dem Sie die Dateien an Ihren S3-Behälter senden.
DPID

Eine ID, die Audience Manager angibt, 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:

  • Daten-Source-ID (auch als Datenanbieter-ID bezeichnet): Dies ist 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. Beispiel: ...ftp_dpm_21_123456789.sync weist Audience Manager an, Daten an IDs zu integrieren, 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 Audience Manager mit, dass die Datendatei nur Android-IDs enthält und dass die IDs für die Eigenschaften qualifiziert sein sollten, die zur _DPID_TARGET_DATA_OWNER -Datenquelle 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 Audience Manager mit, dass die Datendatei nur iOS-IDs enthält und dass die IDs für die Eigenschaften qualifiziert sein sollten, die zur _DPID_TARGET_DATA_OWNER -Datenquelle gehören.
  • IDs, die zu anderen globalen Datenquellen gehören: Sie können Roku-IDs für Advertising (RIDA), Microsoft Advertising IDs (MAID) und andere IDs integrieren. Verwenden Sie die Kennung, die jeder Datenquelle entspricht, wie im Artikel globale Datenquellenbeschrieben.

Hinweis: Mischen Sie keine ID-Typen in Ihren Datendateien. Wenn Ihr Dateiname beispielsweise die Android-Kennung enthält, dürfen Sie keine iOS IDs oder Ihre eigenen IDs 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 obligatorisch, wenn Sie die DPID auf eine Android ID, eine iOS ID oder eine andere ID festlegen, die zu globalen Datenquellen gehört. Dadurch kann Audience Manager die Dateidaten wieder mit Ihrer Organisation verknüpfen.
Diese Ziel-Datenquelle muss Ihrem Unternehmen gehören. Um Daten von Zweitanbietern in eine Zieldatenquelle eines anderen Unternehmens aufnehmen zu können, müssen Sie über eine Zugriffszuordnung zwischen Ihrem Unternehmen und der Zieldatenquelle verfügen. Wenden Sie sich an Ihren Adobe-Berater oder an den Kundensupport, um die Zuordnung einzurichten.

Wichtiger Hinweis: Sie nicht müssen ein Mapping für vorhandene Datenfreigabe-Beziehungen anfordern (für Zieldatenquellen, die zu anderen Unternehmen gehören, in die Sie Daten vor dem 14. März 2022 integriert haben). Die Zuordnung ist auch nicht erforderlich, wenn Daten in Zieldatenquellen integriert werden, die zu Ihrer PID gehören.

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 dass 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 Datenquellenbeschrieben.
partner_name
Der Unternehmens- oder Organisationsname, den Sie in Audience Manager verwenden.
TIMESTAMP
Ein 10-stelliger UTC UNIX-Zeitstempel in Sekunden. Der Zeitstempel hilft dabei, jeden Dateinamen eindeutig zu machen.
(.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 Datenanbietern, eine Liste von Eigenschaften pro Benutzer zu senden, die alle bestehenden Drittanbietereigenschaften dieses Benutzers für diesen Datenanbieter im Audience Manager überschreiben sollte. Sie müssen nicht alle Ihre Benutzer in eine Überschreibungsdatei aufnehmen. 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 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.

[.gz]

Verwenden Sie beim Senden von Dateien an Amazon S3 nur die gzip-Komprimierung. Nach der Komprimierung erhalten diese Dateien die Erweiterung .gz . Verwenden Sie keine ZIP-Komprimierung.

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 file-name-examples

Die folgenden Beispiele zeigen ordnungsgemäß 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

Wenn Sie weitere Beispiele benötigen, können Sie die Beispieldatei herunterladen. Diese Datei wurde mit der Dateierweiterung .overwrite gespeichert. Öffnen Sie es mit einem einfachen Texteditor.

Zulässige Dateigrößen accepted-file-sizes

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 Verzeichnis Audience Manager / Amazon S3 .

Dateityp
Optimale Größe
Maximale Größe
komprimiert
200-300 MB
3 GB
unkomprimiert
1 GB
5 GB
NOTE
Der Validierungsprozess für eingehende Daten markiert leere Dateien als ungültig und verarbeitet sie nicht.

Zeilenlängenbeschränkungen line-limits

Eingehende Datendateien haben eine Zeilenlänge von 102400 Byte. Lines, die diesen Grenzwert überschreiten, sind von der Übertragung ausgeschlossen.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695