DocumentazioneAudience ManagerGuida utente di Audience Manager

Nome dei file di dati in uscita: sintassi ed esempi outbound-data-file-name-syntax-and-examples

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

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

NOTE
Gli elementi di stile (monospaced text, corsivo, parentesi quadre [ ] ( ), 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 syntax-file-name

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 - Trasferimento a Amazon AWS
DID

ID destinazione.

Nell'Audience Manager di , una destinazione è l'istanza dell'integrazione in cui è possibile mappare i segmenti di destinazione. 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 Google Advertiser (non elaborato, senza hash)
  • 20915 - ID Apple per gli 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 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 file-name-examples

Scenario 1

File inviati a 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 al percorso 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 al percorso FTP, con PID_ALIAS="XYZCustomer" e 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 outbound-contents-syntax

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.

NOTE
Gli elementi di stile (monospaced text, corsivo, parentesi quadre [ ] ( ), 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. Vedere anche Nome file 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 gli ID UUID e del 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
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695