Nome dei file di dati in uscita: sintassi ed esempi

Descrive i campi, la sintassi e le convenzioni richiesti utilizzati per assegnare un nome a un file di dati in uscita.

NOTA

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

Elementi di sintassi e nome file

I nomi dei file in uscita contengono gli elementi seguenti. Tutti gli elementi riportati di seguito sono facoltativi.

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

Parametri

La tabella definisce gli elementi in un nome 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 - Trasferimento ad Amazon AWS

DID

ID destinazione.

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

MASTER_DPID

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

  • 2014 - Google Advertiser ID (raw, unhashed)
  • 2015 - Apple ID per gli inserzionisti (raw, unhashed)
  • ID fornitore - ID utente di terze parti (web/cookie)

Per ulteriori informazioni, consulta Global Data Sources.

PID_ALIAS

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 incrementale. Vengono visualizzati nel nome del file 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 obsoleti ed eventuali nuovi dati raccolti dall'ultima sincronizzazione.

TIMESTAMP

Timestamp UNIX a 13 cifre in millisecondi, nel fuso orario UTC.

SPLITNUM

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

Il numero intero deve essere lungo almeno 3 cifre, preceduto da zero, 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. Di seguito sono riportati alcuni esempi.

.gz (optional)

Compressione GZIP.

Esempi di nome file

Scenario 1

File inviati in una posizione Amazon S3, 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 alla posizione FTP, 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 in 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

Contenuto del file di dati in uscita: Sintassi e parametri

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

NOTA

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

I campi nel file di dati vengono visualizzati in questo ordine:

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 dall'Audience Manager .

<SPACE>

Separa l'UUID e segmenta i dati 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. Di solito, desideri conoscere i segmenti a cui appartiene un utente anziché quelli da cui è stato rimosso. Vedere anche Outbound Data File Name: Sintassi ed esempi .

Esempio: Formato file di base

Un file di dati formattato correttamente potrebbe avere un aspetto simile al seguente esempio. Questa voce di file indica che un utente è idoneo per i segmenti 24, 26 e 27. Se necessario, uno spazio separa gli ID del segmento e . UUID 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