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 dei file richiesti per l’invio dei dati a Audience Manager. Imposta i nomi e le dimensioni dei file in base a queste specifiche quando invii dati a una directory Audience Manager / Amazon S3.

NOTA

Gli stili di testo (monospaced text, corsivo, parentesi [ ] ( ), ecc.) in questo documento indicare gli elementi e le opzioni del codice. Per ulteriori informazioni, consulta le convenzioni di stile per codice ed elementi di testo.

Sintassi del 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 del 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.

NOTA

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

Elementi nome

La tabella definisce gli elementi in un nome file S3.

Elemento Nome Descrizione

AWS_directory

Percorso e nome del bucket Amazon S3. Contatta il tuo Account Manager per il nome della directory S3, il percorso e le credenziali.

date=yyyy-mm-dd

Una marca temporale (basata sull’ora UTC) di quando invii i file al bucket S3.

DPID

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

  • ID sorgente dati (noto anche come ID fornitore dati): si tratta di un ID univoco che Audience Manager assegna a un’origine dati (consulta l’ indice Audience Manager degli ID ). Utilizza questo ID assegnato in un nome file quando invii dati che contengono i tuoi ID utente. Ad esempio, ...ftp_dpm_21_123456789.sync indica a Audience Manager di integrare i dati negli ID appartenenti all'origine dati 21.
  • ID Android (GAID): usa l’ID 20914 in un nome di 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 comunica a Audience Manager che il file di dati contiene solo ID Android e che gli ID devono essere qualificati per le caratteristiche appartenenti all'origine dati _DPID_TARGET_DATA_OWNER.
  • ID iOS (IDFA): usa l'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 comunica a Audience Manager che il file di dati contiene solo ID iOS e che gli ID devono essere qualificati per le caratteristiche appartenenti all' _DPID_TARGET_DATA_OWNER origine dati.
  • ID appartenenti ad altre origini dati globali: È possibile integrare ID Roku per Advertising (RIDA), Microsoft Advertising ID (MAID) e altri ID. Utilizza l'ID corrispondente a ciascuna origine dati, come descritto nell' articolo origini dati globali.

Nota: Non combinare tipi di ID nei file di dati. Ad esempio, se il nome del 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 ad Audience Manager a quale origine dati si desidera integrare i dati. Questo campo è obbligatorio se imposti il DPID su un ID Android o iOS ID o 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 comunica ad Audience Manager che stai qualificando gli ID cliente appartenenti all’origine dati 33 per caratteristiche o segnali appartenenti all’origine dati 21.
  • ID Android (GAID): ...ftp_dpm_20914_21_1234567890.sync comunica a Audience Manager che il file di dati contiene solo ID Android e che gli ID devono essere qualificati per le caratteristiche appartenenti all’origine dati 21.
  • ID iOS (IDFA): ...ftp_dpm_20915_21_1234567890.sync indica ad Audience Manager che il file di dati contiene solo ID iOS e che gli ID devono essere qualificati per le caratteristiche appartenenti all’origine dati 21.
  • ID appartenenti ad altre origini dati globali: ...ftp_dpm_121963_21_1234567890.sync comunica ad Audience Manager che il file di dati contiene solo ID Roku e che gli ID devono qualificarsi per le caratteristiche appartenenti all’origine dati 21. Utilizza l'ID corrispondente a ciascuna origine dati, come descritto nell' articolo origini dati globali.

partner_name

Il nome dell'azienda o dell'organizzazione utilizzato in Audience Manager.

TIMESTAMP

Timestamp UNIX UTC a 10 cifre in secondi. La marca temporale consente di rendere univoco il nome di ciascun file.

(.sync|.overwrite)

Opzioni di sincronizzazione che includono:

  • sync: Scenario normale in cui i fornitori di dati di terze parti inviano caratteristiche a livello di singolo utente da aggiungere o rimuovere nel sistema di Audience Manager.
  • overwrite: Consente ai provider di dati di inviare un elenco di caratteristiche in base all’utente che dovrebbe sovrascrivere nell’Audience Manager tutte le caratteristiche di terze parti esistenti dell’utente per questo provider di dati. Non è necessario includere tutti gli utenti in un file di sovrascrittura. Includi solo gli utenti che desideri 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 la parte del file originale che si sta inviando.

Per un'elaborazione efficiente dei file, suddividi i file di dati come indicato:

  • Non compresso: 1 GB
  • Compresso: 200-300 MB

Vedi i primi 2 esempi di nome file sotto.

[.gz]

Quando invii file ad Amazon S3, utilizza solo la compressione gzip. Quando compressi, questi file ottengono l'estensione .gz. Non utilizzare la compressione .zip.

I file compressi devono essere di 3 GB o più piccoli. Se i file sono più grandi, contatta l’Assistenza clienti. Anche se Audience Manager può gestire file di grandi dimensioni, possiamo aiutarti a ridurre le dimensioni dei tuoi file e rendere i trasferimenti di dati più efficienti. Consulta File Compression for Inbound Data Transfer Files.

Esempi di nome 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

Puoi [scaricare] (assets/ftp_dpm_1234_1445374061.overwrite) il file di esempio se desideri ulteriori esempi. Questo file è stato salvato con l'estensione file .overwrite. Apritelo con un semplice editor di testo.

Dimensioni file accettate

Considera le figure riportate di seguito per l’elaborazione più rapida/veloce dei file e per le limitazioni delle dimensioni dei file quando invii 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 contrassegna i file vuoti come non validi e non li elabora.

Limiti di lunghezza delle linee

I file di dati in entrata hanno un limite di lunghezza di riga di 102400 byte. Le linee che superano questo limite sono escluse dal trasferimento.

In questa pagina