FTPRequisiti di nome e dimensione file per i file di dati in entrata ftp-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. Imposta i nomi e le dimensioni dei file in base a queste specifiche quando invii dati a un Audience Manager FTP directory.

WARNING
Stiamo gradualmente eliminando il supporto per FTP configurazioni. Mentre l’acquisizione di file di dati in entrata è ancora supportata in FTP integrazioni, si consiglia vivamente di utilizzare Amazon S3 per l’onboarding di dati offline per nuove integrazioni. Per informazioni dettagliate, consulta Amazon S3 Name and File Size Requirements for Inbound Data Files.
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

FTP i nomi dei file contengono i seguenti elementi obbligatori e facoltativi:

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 FTP nome file.

Elemento nome file
Descrizione
ftp_dpm_
Percorso e nome del file Audience Manager Directory FTP. Contatta il tuo Account Manager per la directory FTP e le credenziali.
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 Audience Manager collega 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.
(.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 clienti e ai fornitori di dati di inviare un elenco di caratteristiche per singolo utente che dovrebbe sovrascrivere tutte le caratteristiche esistenti dell’utente per una determinata origine dati in Audience Manager. Non è necessario includere tutti gli utenti in un file di sovrascrittura. Includi solo gli utenti che desideri modificare. Le caratteristiche non assegnate all’origine dati di destinazione non verranno cancellate.
[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.

TIMESTAMP
Timestamp UNIX UTC a 10 cifre in secondi. La marca temporale consente di rendere univoco ogni nome di file.
[.gz]

Gzip è il formato di compressione consentito per un nome di file FTP. Se utilizzate la compressione file, accertatevi che il nome del file abbia l'estensione corretta.

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 nome file file-name-examples

Gli esempi seguenti mostrano nomi di file formattati correttamente. I nomi dei file potrebbero essere simili.

  • ftp_dpm_478_1366545717.sync.1.gz
  • ftp_dpm_478_1366545717.sync.2.gz
  • ftp_dpm_478_1366545717.overwrite

Scarica il file di esempio, se sono necessari ulteriori esempi. Questo file viene 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 / FTP directory.

Tipo file
Dimensione ottimale
Dimensione massima
Compresso
200-300 MB
3 GB
Non compresso
1 GB
5 GB
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695