FTP Requisiti 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. Impostare i nomi e le dimensioni dei file in base a queste specifiche quando si inviano dati a una directory Audience Manager FTP.

WARNING
Stiamo gradualmente eliminando il supporto per le configurazioni FTP. Anche se l'acquisizione di file di dati in entrata è ancora supportata nelle integrazioni esistenti di FTP, 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

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

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

Elemento nome file
Descrizione
ftp_dpm_
Percorso e nome della directory FTP dell'Audience Manager di . Contatta il tuo Account Manager per la directory FTP e le credenziali.
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 a 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.
(.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 provider 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. Vedere 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 hai bisogno di 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 / FTP, 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
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695