Un file di dati contiene dati di impression, clic o conversione. Se formattati correttamente, puoi importare questi dati nel Audience Manager per visualizzarli nei report di Audience Optimization e creare caratteristiche utilizzando i dati tramite File di registro fruibili. Formattare i file di dati in base alle seguenti specifiche in questa sezione.
Un file di dati con nome e formattazione corretti consente di importare dati di impression, clic o conversione in Audienci Optimization Reports. Questo è utile quando si lavora con un partner che non è integrato con Audience Manager e si desidera lavorare con i propri dati in quella suite di rapporti. Questo processo richiede file separati per ottenere dati di impression, clic e conversione. Non mescolate questi eventi in un singolo file.
Un file di dati deve essere accompagnato da un file di metadati. I contenuti dei file di metadati corrispondono alle informazioni sui file di dati e alle relative etichette leggibili dai menu dei report. Per ulteriori informazioni, consultate Panoramica e mappature per i file di metadati.
La sintassi seguente definisce la struttura di un nome di file di dati ben formato. Nota: italics indica un segnaposto variabile che cambia a seconda del contenuto del file.
Sintassi:
event type_yyyymmdd
In un nome file:
.gz
.Dati questi requisiti, assegnare ai file di dati un nome in base al contenuto come indicato di seguito:
impression_yymmdd.gz
click_yymmdd.gz
conversioni_yyyymmdd.gz
La sintassi seguente definisce la struttura del contenuto in un file di dati formato correttamente. Nota: italics indica un segnaposto variabile e viene sostituito con un'etichetta in un file di dati effettivo.
Sintassi:
etichetta di intestazione 1 | etichetta di intestazione 2 … etichetta di intestazione n | versione
Nel contenuto del file:
Le etichette di intestazione devono essere visualizzate nell'ordine indicato nella tabella seguente. Le impression e i clic utilizzano le stesse etichette. I file di conversione contengono intestazioni aggiuntive.
Se non si dispone di dati per una particolare colonna, compilare il campo con un -1
.
I file devono terminare con un numero di versione. La versione corrente è 1.1.
Intestazioni e contenuti del file separati con il carattere ASCII 001 non stampabile. Se non è possibile utilizzare ASCII 001, separare le intestazioni e i dati con un delimitatore di tabulazione. Poiché si tratta di caratteri non stampabili, l’esempio di sintassi riportato sopra mostra una pipe "|"
solo a scopo di visualizzazione.
Etichette campo
La tabella seguente elenca e descrive le intestazioni delle colonne per il file di dati. Le intestazioni sono sensibili alle maiuscole/minuscole e devono essere visualizzate come ordinato nella tabella. Tutti i tipi di dati sono numeri interi (INT), se non diversamente indicato.
Etichetta | Descrizione |
---|---|
Timestamp |
Una data e un'ora UTC per l'evento di impression, clic o conversione. Utilizzate il formato |
ID utente |
Il tuo ID per un visitatore del sito, noto anche come ID utente univoco del fornitore di dati o DPUUID. |
Advertiser-ID |
L'ID origine dati o il codice di integrazione per l'inserzionista. |
BU-ID |
ID unità aziendale. |
Campaign-ID |
ID campagna. |
Creative-ID |
ID creativo. |
ID sito |
ID sito. |
Placement-ID |
ID posizionamento numerico dal server annunci. |
Insertion-Order-ID |
ID ordine di inserimento. |
Tactic-ID |
ID tattico. |
ID verticale |
ID per un settore verticale o categoria. |
Quantità |
Il numero di articoli venduti in un evento di conversione. Solo per i file di dati di conversione. |
Ricavi |
Acquisto o altro importo di conversione. Tipo di dati: Mobile. Solo per i file di dati di conversione. |
Altri dati |
URL della pagina di destinazione della conversione. Tipo di dati: Stringa. Solo per i file di dati di conversione. |
Event-Type |
Tipo di conversione. Indica se una conversione corrisponde o meno. Le opzioni includono:
Solo per i file di dati di conversione. |
Versione |
Numero di versione richiesto che viene visualizzato alla fine di ogni riga in un file di dati di impression, click o conversione. La versione corrente è 1.1. |
Caricate i file di dati di impression, clic o conversione in una directory Amazon S3 per il vostro account Audience Manager. Fare riferimento a questa sezione per informazioni sui percorsi di consegna/directory, sui tempi di elaborazione dei file e sugli aggiornamenti.
Contatta il tuo consulente Audience Manager o l'Assistenza clienti per iniziare e configurare una directory Amazon S3 per i tuoi file di dati.
Sintassi percorso di consegna ed esempi
I dati vengono memorizzati in uno spazio dei nomi separato per ciascun cliente in una directory Amazon S3. Il percorso del file segue la sintassi indicata di seguito. Nota: italics indica un segnaposto variabile. Gli altri elementi sono costanti o chiavi e non vengono modificati.
Sintassi:
…/log_ingestion/pid= ID AAM/dpid= d_src/logs/ tipo di file_yyyymmdd
La tabella seguente definisce ciascuno di questi elementi in un percorso di consegna dei file.
Parametro file | Descrizione |
---|---|
|
Questo è l'inizio del percorso di memorizzazione della directory. Riceverai il percorso completo quando tutto è configurato. |
|
Questa coppia chiave-valore contiene l'ID cliente Audience Manager. |
|
Questa coppia chiave-valore contiene l’ID origine dati passato in una chiamata dell’evento. Identifica l'agenzia da cui provengono i dati e associa tali dati a un file di metadati di supporto. |
|
Una directory di livello superiore per i file di dati. |
|
Un nome di tipo di file che indica il tipo di dati che contiene e una marca temporale di consegna. |
Percorso e nome del file di caricamento di esempio
Quando caricate un file, il percorso sarà simile al seguente:
.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902
Tempi e aggiornamenti dell'elaborazione dei file
I file di dati vengono elaborati quattro volte al giorno, a intervalli regolari.
Per aggiornare i dati, invia un file contenente tutte le impression, i clic o le conversioni per un giorno particolare. In questo caso, un giorno è il periodo di 24 ore compreso tra una mezzanotte e l’altra. È consigliabile utilizzare l'ora UTC per definire l'intervallo di giorni.
Esaminate i requisiti per la denominazione e la creazione di file di metadati. Per iniziare, vedi Panoramica e mappature per i file di metadati.