Show Menu
THEMEN×

Amazon S3-Anforderungen an Name und Dateigröße für eingehende 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/ Amazon S3 Ordner 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:
  • S3 Prä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_Verzeichnis
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
Die Datenanbieter-ID (DPID) ist ein Bezeichner, der Audience Manager anweist, wenn eine Datendatei Ihre eigenen Benutzer-IDs oder Android- oder iOS-IDs enthält. Akzeptiert die folgenden Optionen:
Datenpartner-ID
Dies ist eine eindeutige ID, die Audience Manager Ihrem Unternehmen oder Ihrer Organisation zuweist. Verwenden Sie diese zugewiesene ID in einem Dateinamen, wenn Sie Daten mit Ihren eigenen Benutzer-IDs senden. Beispiel: ...ftp_dpm_21_123456789.sync teilt Audience Manager mit, dass ein Partner mit ID 21 die Datei gesendet hat und dass sie Benutzer-IDs enthält, die von diesem Partner zugewiesen wurden.
Android-IDs (GAID)
Verwenden Sie die ID 20914 als DPID in einem Datendateinamen, wenn die Datei Android-IDs enthält. Wenn Sie die ID 20914 als DPID verwenden, müssen Sie Ihr Unternehmen trotzdem in Audience Manager identifizieren. Das bedeutet, dass der Dateiname den Parameter _DPID_TARGET_DATA_OWNER verwenden muss, um Ihre Unternehmens-ID zu speichern. Angenommen, Sie übergeben Dateien mit Android-IDs und Ihre Datenanbieter-ID ist 21. In diesem Fall würde der Dateiname wie ...ftp_dpm_20914_21_123456789.sync . Dadurch wird Audience Manager mitgeteilt, dass die Datei Android-IDs enthält und von einem Partner stammt, der mit ID 21 identifiziert wurde.
iOS-IDs (IDFA)
Verwenden Sie die ID 20915 als DPID in einem Datendateinamen, wenn die Datei iOS-IDs enthält. Wenn Sie ID 20915 als DPID verwenden, müssen Sie Ihr Unternehmen trotzdem in Audience Manager identifizieren. Das bedeutet, dass der Dateiname den Parameter _DPID_TARGET_DATA_OWNER verwenden muss, um Ihre Unternehmens-ID zu speichern. Angenommen, Sie übergeben Dateien mit Android-IDs und Ihre Datenanbieter-ID ist 21. In diesem Fall würde der Dateiname wie ...ftp_dpm_20915_21_123456789.sync . Dadurch wird Audience Manager mitgeteilt, dass die Datei iOS-IDs enthält und von einem Partner stammt, der mit ID 21 identifiziert wurde.
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.
Siehe auch den unten stehenden Eintrag _DPID_TARGET_DATA_OWNER .
_DPID_TARGET_DATA_OWNER
Ein Platzhalter für eine ID. Sie können sie beispielsweise auf Ihre Audience Manager -ID einstellen, wenn Sie die DPID auf eine Datenquellen-ID oder eine Android- oder iOS-ID festlegen. Dadurch kann Audience Manager die Dateidaten wieder mit Ihrem Unternehmen verknüpfen.
Beispiel:
  • ...ftp_dpm_33_21_1234567890.sync zeigt, dass ein Partner mit ID 21 Daten aus einer Datenquelle gesendet hat, die die ID 33 verwendet.
  • ...ftp_dpm_20914_21_1234567890.sync zeigt, dass ein Partner mit ID 21 Daten gesendet hat, die Android-IDs enthalten.
  • ...ftp_dpm_20915_21_1234567890.sync zeigt, dass ein Partner mit ID 21 Daten gesendet hat, die iOS-IDs enthalten.
partner_name
Der Name des Unternehmens oder der Organisation, den Sie in Audience Manager verwenden.
ZEITSTEMPEL
Ein 10-stelliger UTC UNIX-Zeitstempel in Sekunden. Mit dem Zeitstempel wird jeder Dateiname eindeutig.
(.sync|.overwrite)
Zu den Synchronisierungsoptionen gehören:
  • sync : Normales Szenario, bei dem Drittanbieter von Daten Eigenschaften pro Benutzer senden, die im Audience Manager-System hinzugefügt oder entfernt werden sollen.
  • überschreiben : Damit können Datenanbieter eine Liste von Eigenschaften pro Benutzer senden, die alle bestehenden Drittanbieter-Eigenschaften dieses Benutzers für diesen Datenanbieter im 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.
[ 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. Bei der Komprimierung erhalten diese Dateien die Erweiterung .gz . 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 Sie möglicherweise dabei unterstützen, die Größe Ihrer Dateien 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>//date=2016-05-09/ftp_dpm_478_1366545717.sync.1.gz
  • s3n://<AWS_Bucket>//date=2016-05-09/ftp_dpm_478_1366545717.sync.2.gz
  • s3n://<AWS_Bucket>//date=2016-05-09/ftp_dpm_478_1366545717.sync
  • s3n://<AWS_Bucket>//date=2016-05-09/ftp_dpm_478_567_1366545717.sync.gz
  • s3n://<AWS_Bucket>//date=2016-05-09/ftp_dpm_478_1366545717.overwrite
Sie können die Beispieldatei herunterladen , wenn Sie weitere Beispiele benötigen. 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.