Amazon S3 requisiti di nome e dimensione file per i file di dati in entrata amazon-s-name-and-file-size-requirements-for-inbound-data-files

Descrive i campi obbligatori, la sintassi, le convenzioni di denominazione e le dimensioni dei file da seguire per l’invio dei dati a Audience Manager. Impostare i nomi e le dimensioni dei file in base a queste specifiche quando si inviano dati a un Audience Manager / Amazon S3 directory.

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

Sintassi dei nomi dei file file-name-syntax

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 nome file accettati, vedi Integrazioni di partner personalizzate.

NOTE
Audience Manager solo processi ASCII e UTF-8 file codificati.

Elementi nome

La tabella definisce gli elementi in un S3 nome file.

Elemento Name
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 documento che indica Audience Manager se un file di dati contiene ID utente, ID Android, ID iOS o altri ID appartenenti a origini dati globali. Accetta le seguenti opzioni:

  • ID origine dati (noto anche come ID provider dati): Questo è un ID univoco che Audience Manager assegna a un’origine dati (consulta l’Audience Manager indice 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 comunica Audience Manager per integrare dati in ID appartenenti alla sorgente dati 21.
  • ID Android (GAID): Utilizza il 20914 ID nel nome di un file di dati se contiene ID Android. Devi utilizzare il campo _DPID_TARGET_DATA_OWNER quando utilizzi ID Android. Ad esempio: ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync comunica Audience Manager il file di dati contiene solo ID Android e gli ID devono essere idonei per le caratteristiche appartenenti al _DPID_TARGET_DATA_OWNER origine dati.
  • ID iOS (IDFA): Utilizza il 20915 ID in un nome di file di dati se contiene iOS ID. Devi utilizzare il campo _DPID_TARGET_DATA_OWNER quando utilizzi iOS ID. Ad esempio: ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync comunica Audience Manager il file di dati contiene solo iOS ID e gli ID devono essere idonei per le caratteristiche appartenenti al _DPID_TARGET_DATA_OWNER origine dati.
  • ID appartenenti ad altre origini dati globali: puoi integrare gli ID Roku per la pubblicità (RIDA), gli ID Microsoft per la pubblicità (MAID) e altri ID. Utilizza l’ID corrispondente a ciascuna origine dati, come descritto nella sezione articolo sulle origini dati globali.

Nota: non combinare i tipi di ID nei file di dati. Ad esempio, se il nome del file include l'identificatore Android, non inserire ID iOS o ID personalizzati nel file di dati.

_DPID_TARGET_DATA_OWNER

Questo campo indica all’Audience Manager a quale origine dati incorporare i dati. Questo campo è obbligatorio se imposti il DPID su un ID Android o iOS ID o su un altro ID appartenente alle origini dati globali. Questo consente ad Audience Manager di collegare nuovamente i dati del file alla tua organizzazione.
Questa origine dati di destinazione deve essere di proprietà della società. Ai fini della condivisione dei dati di seconde parti, per acquisire i dati in un’origine dati di destinazione appartenente a un’altra società è necessario disporre di una mappatura di accesso tra la società e l’origine dati di destinazione. Contatta il tuo consulente Adobe o l’Assistenza clienti per configurare la mappatura.

Nota importante: Tu non è necessario richiedere una mappatura per le relazioni di condivisione dei dati esistenti (per le origini dati di destinazione appartenenti ad altre società in cui sono stati inseriti i dati prima del 14 marzo 2022). Inoltre, la mappatura non è necessaria quando si inseriscono dati in origini dati di destinazione che appartengono al tuo PID.

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 Audience Manager 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 comunica Audience Manager il file di dati contiene solo ID di 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 comunica Audience Manager che il file di dati contenga solo ID Roku e che gli ID siano idonei per le caratteristiche appartenenti all’origine dati 21. Utilizza l’ID corrispondente a ciascuna origine dati, come descritto nella sezione articolo sulle origini dati globali.
partner_name
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 ogni nome di file.
(.sync|.overwrite)

Opzioni di sincronizzazione che includono:

  • sync: scenario normale in cui fornitori di dati di terze parti inviano caratteristiche in base all’utente da aggiungere o rimuovere nell’Audience Manager.
  • overwrite: consente ai fornitori di dati di inviare un elenco di caratteristiche per singolo utente che dovrebbe sovrascrivere tutte le caratteristiche di terze parti esistenti dell’utente per questo fornitore di dati nell’Audience Manager. 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 dividono file di grandi dimensioni in più parti per migliorare i tempi di elaborazione. Il numero indica quale parte del file originale si sta inviando.

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

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

Vedi i primi 2 esempi di nomi di file di seguito.

[.gz]

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

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

Esempi di nomi di file file-name-examples

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

È possibile scaricare il file di esempio, se desideri ulteriori esempi. Questo file è stato salvato con .overwrite estensione file. Aprilo con un semplice editor di testo.

Dimensioni file accettate accepted-file-sizes

Considera le figure di seguito per l’elaborazione più rapida/meno recente dei tuoi file e per i limiti di dimensione dei file quando invii dati a un Audience Manager / Amazon S3 directory.

Tipo file
Dimensione ottimale
Dimensione massima
Compresso
200-300 MB
3 GB
Non compresso
1 GB
5 GB
NOTE
Il processo di convalida dei dati in entrata contrassegnerà i file vuoti come non validi e non li elaborerà.

Limiti di lunghezza delle linee line-limits

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

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695