Show Menu
ARGOMENTI×

Amazon S3Requisiti di nome e dimensione file per i file di dati in entrata

Descrive i campi, la sintassi, le convenzioni di denominazione e le dimensioni di file richiesti per l'invio dei dati a Audience Manager. Impostate i nomi e le dimensioni dei file in base alle seguenti specifiche quando inviate i dati a una Audience Manager / Amazon S3 directory.
Gli stili di testo ( monospaced text , corsivo , parentesi [ ] ( ) , ecc.) in questo documento indicano gli elementi e le opzioni del codice. Per ulteriori informazioni, consulta le convenzioni di stile per codice ed elementi di testo .

Sintassi nome file

S3 i nomi dei file contengono i seguenti elementi obbligatori e facoltativi:
  • S3Prefisso: s3n://AWS_directory/partner_name/date=yyyy-mm-dd/
  • Elementi nome file: ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]
Per altri formati di file accettati, consulta Integrazioni partner personalizzate.
Audience Manager elabora solo file ASCII e file UTF-8 codificati.

Elementi nome

La tabella definisce gli elementi in un nome di S3 file.
Elemento Nome Descrizione
AWS_directory
Percorso e nome del bucket Amazon S3. Contatta il tuo Account Manager per conoscere il nome della directory S3, il percorso e le credenziali.
date= yyyy-mm-dd
Una marca temporale (in base all'ora UTC) del momento in cui si inviano i file al bucket S3.
DPID
L'ID del provider di dati (DPID, Data Provider ID ) è un identificatore che informa Audience Managerse un file di dati contiene ID utente o ID Android o iOS personali. Accetta le seguenti opzioni:
ID partner dati
Si tratta di un ID univoco assegnato Audience Manager alla tua azienda o organizzazione. Utilizzate questo ID assegnato in un nome file per l'invio di dati che contengono i vostri ID utente. Ad esempio, ...ftp_dpm_21_123456789.sync indica Audience Manager che un partner con ID 21 ha inviato il file e contiene gli ID utente assegnati da tale partner.
ID Android (GAID)
Utilizzate ID 20914 come DPID in un nome file di dati se il file contiene ID Android. Se utilizzi ID 20914 come DPID, devi comunque identificare la tua azienda per Audience Manager . Questo significa che il nome file deve usare il _DPID_TARGET_DATA_OWNER parametro per contenere l'ID società. Ad esempio, supponiamo che vengano inviati file con ID Android e che il tuo ID provider di dati sia 21. In questo caso, il nome del file sarà simile a quello ...ftp_dpm_20914_21_123456789.sync . Questo indica Audience Manager che il file contiene ID Android ed è di un partner identificato dall'ID 21.
ID iOS (IDFA)
Utilizzate ID 20915 come DPID in un nome file di dati se il file contiene ID iOS. Se utilizzi ID 20915 come DPID, devi comunque identificare la tua società per Audience Manager . Questo significa che il nome file deve usare il _DPID_TARGET_DATA_OWNER parametro per contenere l'ID società. Ad esempio, supponiamo che vengano inviati file con ID Android e che il tuo ID provider di dati sia 21. In questo caso, il nome del file sarà simile a quello ...ftp_dpm_20915_21_123456789.sync . Questo indica Audience Manager che il file contiene ID iOS ed è di un partner identificato dall'ID 21.
Nota: Non utilizzare tipi di ID misti nei file di dati. Ad esempio, se il nome file include l'identificatore Android, non inserire gli ID iOS o i tuoi ID nel file di dati.
Per ulteriori informazioni, consulta Global Data Sources .
Vedere anche la _DPID_TARGET_DATA_OWNER voce seguente.
_DPID_TARGET_DATA_OWNER
Un segnaposto per un ID. Ad esempio, puoi impostarlo sul tuo ID Audience Manager se imposti il DPID a un ID origine dati o a un ID Android o iOS. Questo consente Audience Manager di ricollegare i dati del file alla propria organizzazione.
Ad esempio:
  • ...ftp_dpm_33_21_1234567890.sync mostra che un partner con ID 21 ha inviato dati da un'origine dati che utilizza ID 33.
  • ...ftp_dpm_20914_21_1234567890.sync mostra che un partner con ID 21 ha inviato dati che contengono ID Android.
  • ...ftp_dpm_20915_21_1234567890.sync mostra che un partner con ID 21 ha inviato dati che contengono ID iOS.
partner_name
Il nome della società o dell’organizzazione utilizzato in Audience Manager .
TIMESTAMP
Marca temporale UTC di 10 cifre in secondi. La marca temporale consente di rendere univoco ciascun nome file.
(.sync|.overwrite)
Opzioni di sincronizzazione che includono:
  • sync : Scenario normale in cui i fornitori di dati di terze parti inviano caratteristiche in base all'utente da aggiungere o rimuovere nel sistema Audience Manager .
  • overwrite : Consente ai provider di dati di inviare un elenco di caratteristiche in base all'utente che dovrebbero sovrascrivere tutte le caratteristiche di terze parti esistenti per questo provider di dati nell'Audience Manager . Non è necessario includere tutti gli utenti in un file di sovrascrittura. Includete solo gli utenti che desiderate modificare.
[ SPLIT_NUMBER ]
Un numero intero. Utilizzato quando si suddividono file di grandi dimensioni in più parti per migliorare i tempi di elaborazione. Il numero indica quale parte del file originale viene inviata.
Per un'elaborazione efficiente dei file, suddividere i file di dati come indicato:
  • Non compresso: 1 GB
  • Compresso: 200-300 MB
Vedere i primi due esempi Esempi di nomi file di nome file riportati di seguito.
[.gz]
Quando inviate i file ad Amazon S3, utilizzate solo la compressione gzip. Se compressi, questi file ottengono l' .gz estensione. Non utilizzate la compressione .zip.
I file compressi devono essere di almeno 3 GB. Se i file sono più grandi, rivolgiti all'Assistenza clienti. Anche se Audience Manager può gestire file di grandi dimensioni, possiamo aiutarti a ridurre le dimensioni dei file e rendere più efficiente il trasferimento dei dati. Consulta File Compression for Inbound Data Transfer Files .

Esempi di nomi file

Gli esempi seguenti mostrano nomi di file formattati correttamente. I nomi dei file potrebbero essere simili.
  • 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
Potete scaricare il file di esempio se desiderate ulteriori esempi. Il file è stato salvato con l'estensione del .overwrite file. Aprite l’immagine con un semplice editor di testo.

Dimensioni file accettate

Considerare le figure riportate di seguito per l'elaborazione più rapida/rapida dei file e per i limiti di dimensione dei file quando si inviano dati a una Audience Manager / Amazon S3 directory.
Tipo file Dimensione ottimale Dimensione massima
Compresso
200-300 MB
3 GB
Non compresso
1 GB
5 GB
Il processo di convalida dei dati in entrata contrassegnerà i file vuoti come non validi e non li elaborerà.