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.
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.
Elementi nome
La tabella definisce gli elementi in un S3 nome file.
AWS_directory
date=yyyy-mm-dd
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
TIMESTAMP
(.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.
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.