Show Menu
ARGOMENTI×

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 di file richiesti per l'invio dei dati a Audience Manager. Impostate i nomi e le dimensioni dei file in base alle seguenti specifiche quando inviate i dati a una FTP directory di Audience Manager .
We are gradually phasing out support for FTP configurations. While inbound data file ingestion is still supported in existing FTP integrations, we strongly recommend using Amazon S3 to onboard offline data for new integrations. Per informazioni dettagliate, consulta Amazon S3 Name and File Size Requirements for Inbound Data Files .
Gli stili di testo ( monospaced text , corsivo , parentesi [ ] ( ) , ecc.) in questo documento indicano 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.
Audience Manager elabora solo file ASCII e file UTF-8 codificati.

Elementi nome

La tabella definisce gli elementi in un nome di FTP file.
Elemento nome file Descrizione
ftp_dpm_
Percorso e nome della directory FTP del Audience Manager . Contatta il tuo Account Manager per conoscere la directory e le credenziali dell'FTP.
DPID
Un ID che indica Audience Manager se un file di dati contiene ID utente, ID Android, ID iOS o altri ID che appartengono a origini dati globali. Accetta le seguenti opzioni:
  • ID origine dati (noto anche come ID provider dati): Si tratta di un ID univoco che Audience Manager assegna a un'origine dati (fare riferimento all'indice del Audience Manager degli ID ). Utilizzate questo ID assegnato in un nome file per l'invio di dati che contengono i vostri ID utente. Ad esempio, ...ftp_dpm_21_123456789.sync indica a Audience Manager i dati di bordo agli ID appartenenti all’origine dati 21.
  • ID Android (GAID): Utilizzate ID 20914 in un nome file di dati se contiene ID Android. Ad esempio, ...ftp_dpm_20914_123456789.sync indica Audience Manager che il file di dati contiene solo ID Android.
  • ID iOS (IDFA): Usa l'ID 20915 in un nome file di dati se contiene ID iOS. Ad esempio, ...ftp_dpm_20915_123456789.sync indica Audience Manager che il file di dati contiene solo ID iOS.
  • ID appartenenti ad altre origini dati globali: Potete utilizzare gli ID Roku per la pubblicità (RIDA), gli ID pubblicitari Microsoft (MAID) e altri ID. Utilizzare l'ID corrispondente a ciascuna origine dati, come descritto nell'articolo origini dati globali.
Nota: Non utilizzare tipi di ID misti nei file di dati. Ad esempio, se il nome file include l'identificatore Android, non inserire gli ID iOS o i tuoi ID nel file di dati.
_DPID_TARGET_DATA_OWNER
Un segnaposto per un ID. Ad esempio, puoi impostarlo sull'ID Audience Manager se imposti il DPID a un ID origine dati o a un ID Android o iOS. Questo consente Audience Manager di ricollegare i dati del file alla propria organizzazione.
Ad esempio:
  • ...ftp_dpm_33_21_1234567890.sync mostra che un partner con ID 21 ha inviato dati da un'origine dati che utilizza ID 33.
  • ...ftp_dpm_20914_21_1234567890.sync mostra che un partner con ID 21 ha inviato dati che contengono ID Android.
  • ...ftp_dpm_20915_21_1234567890.sync mostra che un partner con ID 21 ha inviato dati che contengono ID iOS.
(.sync |.overwrite)
Opzioni di sincronizzazione che includono:
  • sync : Scenario normale in cui i fornitori di dati di terze parti inviano caratteristiche in base all'utente da aggiungere o rimuovere nel Audience Manager .
  • overwrite : Consente a clienti e fornitori di dati di inviare un elenco di caratteristiche in base agli utenti, che dovrebbero sovrascrivere tutte le caratteristiche esistenti di questo utente per una determinata origine dati in Audience Manager. Non è necessario includere tutti gli utenti in un file di sovrascrittura. Includete solo gli utenti che desiderate 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 quale parte del file originale viene inviata.
Per un'elaborazione efficiente dei file, suddividere i file di dati come indicato:
  • Non compresso: 1 GB
  • Compresso: 200-300 MB
Vedere i primi due esempi Esempi di nomi file di nome file riportati di seguito.
TIMESTAMP
Marca temporale UTC di 10 cifre in secondi. La marca temporale consente di rendere univoco ciascun nome file.
[.gz]
Gzip è il formato di compressione consentito per il nome di un 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, rivolgiti all'Assistenza clienti. Anche se Audience Manager può gestire file di grandi dimensioni, possiamo aiutarti a ridurre le dimensioni dei file e rendere più efficiente il trasferimento dei dati. Consulta File Compression for Inbound Data Transfer Files .

Esempi di nomi 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) il file di esempio se avete bisogno di ulteriori esempi. Questo file viene salvato con l'estensione del .overwrite file. Aprite l’applicazione con un semplice editor di testo.

Dimensioni file accettate

Considerare le figure riportate di seguito per l'elaborazione più rapida/rapida dei file e per i limiti di dimensione dei file quando si inviano dati a una Audience Manager / FTP directory.
Tipo file Dimensione ottimale Dimensione massima
Compresso
200-300 MB
3 GB
Non compresso
1 GB
5 GB