Show Menu
ARGOMENTI×

Requisiti di nome e dimensione file Amazon S3 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 di dati ad Audience Manager. Impostate i nomi e le dimensioni dei file in base alle seguenti specifiche quando inviate i dati ad 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:
  • S3 prefix: 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 i file vengono inviati 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 da Audience Manager alla tua società o organizzazione. Utilizzate questo ID assegnato in un nome file quando inviate dati che contengono i vostri ID utente. Ad esempio, ..ftp_dpm_21_123456789.sync dice ad 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 società in Audience Manager . Ciò significa che il nome del file deve utilizzare il parametro _DPID_TARGET_DATA_OWNER per contenere l'ID della società. Ad esempio, supponiamo che vengano inviati file con ID Android e che il tuo ID provider dati sia 21. In questo caso, il nome del file sarà ...ftp_dpm_20914_21_123456789.sync . Questo indica ad 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à in Audience Manager . Ciò significa che il nome del file deve utilizzare il parametro _DPID_TARGET_DATA_OWNER per contenere l'ID della società. Ad esempio, supponiamo che vengano inviati file con ID Android e che il tuo ID provider dati sia 21. In questo caso, il nome del file sarà ...ftp_dpm_20915_21_123456789.sync . Questo indica ad 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.
Vedi anche la voce _DPID_TARGET_DATA_OWNER seguente.
_DPID_TARGET_DATA_OWNER
Un segnaposto per un ID. Ad esempio, puoi impostarlo sull’ID Audience Manager se imposti il DPID su un ID origine dati o su un ID Android o iOS. In questo modo Audience Manager collega i dati del file alla tua organizzazione.
Ad esempio:
  • ...ftp_dpm_33_21_1234567890.sync mostra un partner con ID 21 che ha inviato dati da un’origine dati che utilizza ID 33.
  • ...ftp_dpm_20914_21_1234567890.sync mostra un partner con ID 21 che ha inviato dati che contengono ID Android.
  • ...ftp_dpm_20915_21_1234567890.sync mostra un partner con ID 21 che 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:
  • sincronizzazione : 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.
  • sovrascrittura : Consente ai provider di dati di inviare un elenco di caratteristiche in base agli utenti, che dovrebbero sovrascrivere tutte le caratteristiche di terze parti esistenti per questo provider di dati in 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. Quando compressi, questi file ottengono l'estensione .gz . 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 è in grado di gestire file di grandi dimensioni, potrebbe essere utile ridurre le dimensioni dei file e rendere più efficienti i trasferimenti di dati. Consulta Compressione file per i file di trasferimento dati in entrata.

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