Amazon S3 requisiti di nome e dimensione del 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 directory Audience Manager / Amazon S3.

NOTA

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 con nome di file accettato, vedere Integrazioni partner personalizzate.

NOTA

Audience Manager elabora solo file ASCII e file UTF-8 codificati.

Elementi nome

La tabella definisce gli elementi in un nome di file S3.

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

Un ID che indica a Audience Manager se un file di dati contiene gli ID utente, gli ID Android, gli ID iOS o altri ID appartenenti a origini dati globali. Accetta le seguenti opzioni:

  • ID origine dati (noto anche come ID provider dati): si tratta di un ID univoco che Audience Manager assegna a un'origine dati (fare riferimento all' indice Audience Manager degli ID ). 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 a Audience Manager di includere dati a bordo agli ID appartenenti all'origine dati 21.
  • ID Android (GAID): usa ID 2014 in un nome file di dati se contiene ID Android. È necessario utilizzare il campo _DPID_TARGET_DATA_OWNER quando si utilizzano gli ID Android. Ad esempio, ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync indica a Audience Manager che il file di dati contiene solo ID Android e gli ID devono essere idonei per le caratteristiche appartenenti all'origine dati _DPID_TARGET_DATA_OWNER.
  • ID iOS (IDFA): utilizzate ID 20915 in un nome file di dati se contiene ID iOS. È necessario utilizzare il campo _DPID_TARGET_DATA_OWNER quando si utilizzano gli ID iOS. Ad esempio, ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync indica a Audience Manager che il file di dati contiene solo ID iOS e che gli ID devono essere idonei per le caratteristiche appartenenti all'origine dati _DPID_TARGET_DATA_OWNER.
  • ID appartenenti ad altre origini dati globali: Potete utilizzare gli ID Roku per la pubblicità (RIDA), gli ID pubblicitari Microsoft (MAID) e altri ID. Utilizzare l'ID corrispondente a ciascuna origine dati, come descritto nell'articolo origini dati globali.

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.

_DPID_TARGET_DATA_OWNER

Questo campo indica Audience Manager a quale origine dati includere i dati a bordo. Questo campo è obbligatorio se imposti il DPID su un ID Android o iOS o su un altro ID appartenente a origini dati globali. Questo consente a Audience Manager di collegare nuovamente i dati del file all'organizzazione.

Ad esempio:

  • ...ftp_dpm_33_21_1234567890.sync indica Audience Manager che gli ID cliente qualificati appartengono all'origine dati 33 per caratteristiche o segnali appartenenti all'origine dati 21.
  • ID Android (GAID): ...ftp_dpm_20914_21_1234567890.sync informa Audience Manager che il file di dati contiene solo ID Android e gli ID devono essere idonei per le caratteristiche appartenenti all’origine dati 21.
  • ID iOS (IDFA): ...ftp_dpm_20915_21_1234567890.sync informa Audience Manager che il file di dati contiene solo ID iOS e gli ID devono essere idonei per le caratteristiche appartenenti all’origine dati 21.
  • ID appartenenti ad altre origini dati globali: ...ftp_dpm_121963_21_1234567890.sync informa Audience Manager che il file di dati contiene solo Roku ID e gli ID devono essere idonei per le caratteristiche appartenenti all’origine dati 21. Utilizzare l'ID corrispondente a ciascuna origine dati, come descritto nell'articolo origini dati globali.

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 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 nel 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 2 esempi di nome file sotto.

[.gz]

Quando inviate i file a Amazon S3, utilizzate solo la compressione gzip. Se 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 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 di 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] (assets/ftp_dpm_1234_1445374061.overwrite) il file di esempio se desiderate ulteriori esempi. Il file è stato salvato con l'estensione .overwrite. Aprite l’applicazione con un semplice editor di testo.

Dimensioni file accettate

Considerare le cifre 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 directory Audience Manager / Amazon S3.

Tipo file Dimensione ottimale Dimensione massima
Compresso

200-300 MB

3 GB

Non compresso

1 GB

5 GB

NOTA

Il processo di convalida dei dati in entrata contrassegnerà i file vuoti come non validi e non li elaborerà.

Limiti di lunghezza della linea

I file di dati in entrata hanno un limite di lunghezza di riga di 102400 byte. Sono escluse dal trasferimento le linee che superano tale limite.

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free