Nome dei file di dati in uscita: sintassi ed esempi

Descrive i campi obbligatori, la sintassi e le convenzioni utilizzati per denominare un file di dati in uscita.

NOTA

Gli elementi di stile (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.

Elementi di sintassi e nome file

I nomi dei file in uscita contengono i seguenti elementi. Tutti gli elementi seguenti sono facoltativi.

[SYNC_TYPE][_DID][_MASTER_DPID][_PID_ALIAS][_SYNC-MODE][_TIMESTAMP]SPLITNUM.sync[.gz]

Parametri

La tabella definisce gli elementi in un nome di file di dati in uscita.

Elemento nome file Descrizione

SYNC_TYPE

Si riferisce ai metodi di trasferimento dei dati. I metodi di trasferimento includono:

  • FTP - Trasferimento tramite SFTP
  • Amazon S3 - Trasferisci a Amazon AWS

DID

ID destinazione.

In entrata Audience Manager , una destinazione è l’istanza dell’integrazione in cui puoi mappare i segmenti target. I clienti possono avere più destinazioni, a seconda dei requisiti aziendali.

MASTER_DPID

ID del fornitore o dell’origine dati. Questo ID identifica il tipo di ID utente presente nel contenuto del file. Le chiavi più comuni per gli ID utente sono:

  • 20914 - ID inserzionista Google (non elaborato, senza hash)
  • 20915 - Apple ID per inserzionisti (non elaborato, senza hash)
  • ID fornitore - ID utente di terze parti (web/cookie)

Per ulteriori informazioni, consulta Global Data Sources.

PID_ALIAS

L’identificatore del cliente dalla piattaforma di terze parti.

SYNC_MODE

La modalità di sincronizzazione è un segnaposto macro che aggiunge un'etichetta al nome del file in base al tipo di sincronizzazione. I tipi di sincronizzazione includono full e incremental. Nel nome del file verranno visualizzati come iter o full .

  • iter : indica una sincronizzazione iterativa o incrementale. Un file incrementale contiene solo i nuovi dati raccolti dall'ultima sincronizzazione.
  • full : indica una sincronizzazione "completa". Un file completamente sincronizzato contiene dati precedenti ed eventuali nuovi dati raccolti dall'ultima sincronizzazione.

TIMESTAMP

Una marca temporale UNIX di 13 cifre in millisecondi, nel fuso orario UTC.

SPLITNUM

Un numero intero. Identifica la parte di un file che è stata divisa in più parti per migliorare i tempi di elaborazione. Il numero indica a quale parte del file originale appartengono i dati.

Il numero intero deve avere almeno 3 cifre, precedute da zeri, se la dimensione della divisione è inferiore a 100 parti.

Il file originale non avrà alcun numero di divisione. Il primo file diviso termina con 001. Vedi gli esempi di seguito.

.gz (optional)

Compressione GZIP.

Esempi di nome file

Scenario 1

File inviati a un Amazon S3 posizione, con PID_ALIAS="XYZCustomer" e con Google Advertiser IDs nel contenuto del file.

Ad esempio, file incrementali:

  • S3_1234_20914_XYZCustomer_iter_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000001.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000002.sync.gz

Ad esempio, file completi:

  • S3_1234_20914_XYZCustomer_full_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_full_1486140844000001.sync.gz

Scenario 2

File inviati a FTP posizione, senza PID_ALIAS e con Apple Advertiser IDs nel contenuto del file:

Ad esempio, file incrementali:

  • ftp_1234_20915_iter_1486140843000.sync.gz
  • ftp_1234_20915_iter_1486140843000001.sync.gz

Ad esempio, file completi:

  • ftp_1234_20915_full_1486140843000.sync.gz
  • ftp_1234_20915_full_1486140843000001.sync.gz

Scenario 3: file inviati a FTP posizione, con PID_ALIAS="XYZCustomer" e con ID utente di terze parti nel contenuto del file ( Vendor ID=45454):

Ad esempio, file incrementali:

  • ftp_1234_45454_XYZCustomer_iter_1486140843000.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz

Ad esempio, file completi:

  • ftp_1234_45454_XYZCustomer_full_1486140843200.sync.gz
  • ftp_1234_45454_XYZCustomer_full_1486140843200001.sync.gz

Contenuti dei file di dati in uscita: sintassi e parametri

Descrive i campi obbligatori, la sintassi e le convenzioni utilizzati per organizzare le informazioni in un file di dati in uscita. Formatta i dati in base a queste specifiche.

NOTA

Gli elementi di stile (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

I campi nel file di dati vengono visualizzati nell'ordine seguente:

UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...

Parametri

Nella tabella sono elencate le variabili che definiscono il contenuto di un file di dati.

Parametro Descrizione

UUID

Un ID utente univoco assegnato da Audience Manager .

<SPACE>

Separa i dati UUID e segmentali con uno spazio

SEGMENT_N

L’ID del segmento a cui appartiene un visitatore. Separa più segmenti con una virgola.

REMOVED_SEGMENT_N

ID del segmento da cui l’utente è stato squalificato. Separa più segmenti con una virgola. Con una sincronizzazione completa, puoi ignorare i segmenti rimossi perché il file di dati conterrà l’elenco completo dei segmenti correnti per l’utente. In genere, è importante conoscere i segmenti a cui appartiene un utente, non quelli da cui è stato rimosso. Vedi anche Nome dei file di dati in uscita: sintassi ed esempi .

Esempio: formato file di base

Un file di dati formattato correttamente potrebbe avere un aspetto simile a quello dell’esempio seguente. Questa voce di file indica che un utente è idoneo per i segmenti 24, 26 e 27. Se necessario, uno spazio separa il UUID e gli ID segmento. Un altro spazio separa i set di ID segmento. In questo esempio, un utente appartiene ai segmenti 24, 26 e 27. Sono state rimosse dai segmenti 25 e 28.

59767559181262060060278870901087098252  24,26,27  25,28

In questa pagina