FTPRequisiti di nome e dimensione file per i file di dati in entrata

Descrive i campi, la sintassi, le convenzioni di denominazione e le dimensioni dei file richiesti 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 una directory di Audience Manager FTP.

AVVERTENZA

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

NOTA

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

Sintassi nome file

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 file accettati, consulta Integrazioni partner personalizzate.

NOTA

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

Elementi nome

La tabella definisce gli elementi in un nome file FTP.

Elemento Nome file Descrizione

ftp_dpm_

Il percorso e il nome della directory Audience Manager FTP. Contatta il tuo Account Manager per conoscere la directory e le credenziali FTP.

DPID

Un ID che indica ad Audience Manager se un file di dati contiene i tuoi ID utente, ID Android, ID iOS o altri ID appartenenti a origini dati globali. Accetta le seguenti opzioni:

  • ID sorgente dati (noto anche come ID fornitore dati): si tratta di un ID univoco che Audience Manager assegna a un’origine dati (consulta l’ indice Audience Manager 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 indica a Audience Manager di integrare i dati negli ID appartenenti all'origine dati 21.
  • ID Android (GAID): usa l’ID 20914 in un nome di file di dati se contiene ID Android. È necessario utilizzare il campo _DPID_TARGET_DATA_OWNER quando si utilizzano gli ID Android. Ad esempio, ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync comunica a Audience Manager che il file di dati contiene solo ID Android e che gli ID devono essere qualificati per le caratteristiche appartenenti all'origine dati _DPID_TARGET_DATA_OWNER.
  • ID iOS (IDFA): usa l'ID 20915 in un nome file di dati se contiene ID iOS. È necessario utilizzare il campo _DPID_TARGET_DATA_OWNER quando si utilizzano gli ID iOS. Ad esempio, ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync comunica a Audience Manager che il file di dati contiene solo ID iOS e che gli ID devono essere qualificati per le caratteristiche appartenenti all' _DPID_TARGET_DATA_OWNER origine dati.
  • ID appartenenti ad altre origini dati globali: È possibile integrare ID Roku per Advertising (RIDA), Microsoft Advertising ID (MAID) e altri ID. Utilizza l'ID corrispondente a ciascuna origine dati, come descritto nell' articolo origini dati globali.

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

_DPID_TARGET_DATA_OWNER

Questo campo indica ad Audience Manager a quale origine dati si desidera integrare i dati. Questo campo è obbligatorio se imposti il DPID su un ID Android o iOS ID o un altro ID appartenente a origini dati globali. Questo consente a Audience Manager di collegare nuovamente i dati del file all'organizzazione.

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 a Audience Manager che il file di dati contiene solo ID Android e che gli ID devono essere qualificati per le caratteristiche appartenenti all’origine dati 21.
  • ID iOS (IDFA): ...ftp_dpm_20915_21_1234567890.sync indica ad Audience Manager che il file di dati contiene solo ID iOS e che gli ID devono essere qualificati per le caratteristiche appartenenti all’origine dati 21.
  • ID appartenenti ad altre origini dati globali: ...ftp_dpm_121963_21_1234567890.sync comunica ad Audience Manager che il file di dati contiene solo ID Roku e che gli ID devono qualificarsi per le caratteristiche appartenenti all’origine dati 21. Utilizza l'ID corrispondente a ciascuna origine dati, come descritto nell' articolo origini dati globali.

(.sync |.overwrite)

Opzioni di sincronizzazione che includono:

  • sync: Scenario normale in cui i fornitori di dati di terze parti inviano caratteristiche a livello di singolo utente da aggiungere o rimuovere nel sistema di Audience Manager.
  • overwrite: Consente ai clienti e ai fornitori di dati di inviare un elenco di caratteristiche in base all’utente che dovrebbe sovrascrivere in Audience Manager tutte le caratteristiche esistenti dell’utente per una determinata origine dati. 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 suddividono file di grandi dimensioni in più parti per migliorare i tempi di elaborazione. Il numero indica la parte del file originale che si sta inviando.

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

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

Vedi i primi 2 esempi di nome file sotto.

TIMESTAMP

Timestamp UNIX UTC a 10 cifre in secondi. La marca temporale consente di rendere univoco il nome di ciascun file.

[.gz]

Gzip è il formato di compressione consentito per un nome di file FTP. Se utilizzi la compressione file, accertati che il nome del file abbia l’estensione corretta.

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

Esempi di nome file

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

[] (assets/ftp_dpm_1234_1445374061.overwrite) Scarica il file di esempio se hai bisogno di ulteriori esempi. Questo file viene salvato con l'estensione file .overwrite. Apritelo con un semplice editor di testo.

Dimensioni file accettate

Considera le figure riportate di seguito per l’elaborazione più rapida/veloce dei file e per le limitazioni delle dimensioni dei file quando invii dati a una directory Audience Manager / FTP.

Tipo file Dimensione ottimale Dimensione massima
Compresso

200-300 MB

3 GB

Non compresso

1 GB

5 GB

In questa pagina