Show Menu
ARGOMENTI×

File di dati per report di ottimizzazione dell'audience

Un file di dati contiene dati di impression, clic o conversione. Se formattati correttamente, puoi importare questi dati in Audience Manager e visualizzarli nei rapporti di ottimizzazione dell'audience. Formattare i file di dati in base alle seguenti specifiche in questa sezione.

Panoramica

Un file di dati con nome e formattazione corretti consente di importare dati di impression, clic o conversione nei report di ottimizzazione dell' audience. Questa funzione è utile quando si lavora con un partner non integrato 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.

Convenzioni di denominazione per i file di dati

La sintassi seguente definisce la struttura di un nome file di dati ben formato. Nota: il corsivo indica un segnaposto variabile che cambia a seconda del contenuto del file.
Sintassi:
event type_

yyyymmdd

In un nome file:
  • Il tipo di evento indica che il file contiene impression, clic o conversioni. Create un file separato per ciascun tipo di evento.
  • Un carattere di sottolineatura separa il tipo di evento e la marca temporale di un mese.
  • Prima di caricare i file, comprimeteli utilizzando il file gzip e salvateli con l’estensione del .gz file.
Dati questi requisiti, assegnare un nome ai file di dati in base al contenuto come segue:
  • Dati di impressione:
    impression_
    
    yymmdd
    
    .gz
    
    
  • Fare clic su dati:
    click_
    
    yyyymmdd.gz
    
    
  • Dati di conversione:
    conversioni_
    
    yyyymmdd.gz
    
    

Formato contenuto per i file di dati

La sintassi seguente definisce la struttura del contenuto in un file di dati formato correttamente. Nota: il corsivo indica un segnaposto variabile e viene sostituito con un'etichetta in un file di dati effettivo.
Sintassi:
etichetta di intestazione 1 | Etichetta 

intestazione 2 ... Etichetta 

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 barra verticale 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 yyyy-dd-mm hh:mm:ss .
ID utente
Il tuo ID per un visitatore del sito, noto anche come ID utente univoco del fornitore di dati o DPUUID.
Advertiser-ID
ID origine dati o 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:
  • 0 : Impression
  • 1 : Click
  • -1 : Non attribuito o sconosciuto
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.

Metodi di consegna dei file di dati

Caricate i file di dati di impression, clic o conversione in una directory Amazon S3 per il vostro Audience Manager account. Fare riferimento a questa sezione per informazioni sui percorsi di consegna/directory, sui tempi di elaborazione dei file e sugli aggiornamenti.
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. Note, italics indicates a variable placeholder. Altri elementi sono costanti o chiavi e non vengono modificati.
Sintassi:
.../log_ingestion/pid= 

AAM ID

/dpid= 

d_src/logs/ 

file type_

yyyymmdd

La tabella seguente definisce ciascuno di questi elementi in un percorso di consegna dei file.
Parametro file Descrizione
.../log_ingestion/
Questo è l'inizio del percorso di memorizzazione della directory. Riceverai il percorso completo quando tutto è configurato.
pid=ID AAM
Questa coppia chiave-valore che contiene l'ID cliente Audience Manager .
dpid= d_src
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.
logs
Una directory di livello superiore per i file di dati.
tipo di file_ yymmdd
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 di elaborazione 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.

Passaggi successivi

Esaminate i requisiti per denominare e creare file di metadati. Per iniziare, consultate Panoramica e mappature per i file di metadati.