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 una directory Audience Manager / Amazon S3.

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

I nomi di file S3 contengono i seguenti elementi obbligatori e facoltativi:

  • Prefisso S3: 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 gli altri formati di file accettati, vedere Integrazioni partner personalizzate.

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

Elementi nome

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

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 ID che comunica all'Audience Manager se un file di dati contiene i tuoi ID utente, gli ID Android, gli ID iOS o altri ID appartenenti a origini dati globali. Accetta le seguenti opzioni:

  • ID Data Source (noto anche come ID provider dati): Questo è un ID univoco che Audience Manager assegna a un'origine dati (fare riferimento all'indice Audience Manager degli ID). Utilizza questo ID assegnato in un nome file quando invii dati che contengono i tuoi ID utente. ...ftp_dpm_21_123456789.sync, ad esempio, comunica a Audience Manager di integrare i dati negli ID appartenenti all'origine dati 21.
  • ID Android (GAID): Utilizzare il 20914 ID in un nome di file di dati se contiene ID Android. Utilizzare il campo _DPID_TARGET_DATA_OWNER quando si utilizzano gli Android ID. ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync, ad esempio, comunica a Audience Manager che il file di dati contiene solo ID Android e che gli ID devono essere idonei per le caratteristiche appartenenti all'origine dati _DPID_TARGET_DATA_OWNER.
  • ID iOS (IDFA): Utilizzare il 20915 ID in un nome di file di dati se contiene ID iOS. Utilizzare il campo _DPID_TARGET_DATA_OWNER quando si utilizzano gli iOS ID. ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync, ad esempio, comunica 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: è possibile integrare gli ID Roku per Advertising (RIDA), Advertising ID di Microsoft (MAID) e altri ID. Utilizzare l'ID corrispondente a ciascuna origine dati, come descritto nell'articolo delle 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 Android ID 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.
L'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: 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 caricati 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 all'Audience Manager che stai qualificando gli ID cliente appartenenti all'origine dati 33 per caratteristiche o segnali appartenenti all'origine dati 21.
  • Android ID (GAID): ...ftp_dpm_20914_21_1234567890.sync comunica a Audience Manager che il file di dati contiene solo Android ID e che gli ID devono essere idonei per le caratteristiche appartenenti all'origine dati 21.
  • ID iOS (IDFA): ...ftp_dpm_20915_21_1234567890.sync comunica 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 21.
  • ID appartenenti ad altre origini dati globali: ...ftp_dpm_121963_21_1234567890.sync comunica a Audience Manager che il file di dati contiene solo ID Roku e che 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 delle origini dati globali.
partner_name
Il nome dell'azienda o dell'organizzazione utilizzato nell'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 provider 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 provider 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. Una volta compressi, questi file ottengono l'estensione .gz. 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. Vedere 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

Puoi scaricare il file di esempio se desideri ulteriori esempi. Il file è stato salvato con l'estensione .overwrite. Aprilo con un semplice editor di testo.

Dimensioni file accettate accepted-file-sizes

Quando si inviano dati a una directory Audience Manager / Amazon S3, prendere in considerazione le figure riportate di seguito per l'elaborazione più rapida/meno recente dei file e per le limitazioni relative alle dimensioni dei file.

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