File di dati per report di Audience Optimization e file di registro fruibili

Un file di dati contiene dati di impression, clic o conversione. Se formattati correttamente, potete importare questi dati in Audience Manager per visualizzarli nei report di Audience Optimization e creare caratteristiche utilizzando i dati tramite i file di registro fruibili. 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 rapporti Audience Optimization. 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 filedi metadati.

Naming Conventions for Data Files

La sintassi seguente definisce la struttura di un nome di 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 ai file di dati un nome in base al contenuto come indicato di seguito:

  • Dati di impressione:
    impression_yymmdd.gz
  • Fare clic su dati:
    click_yyyymmdd.gz
  • Dati di conversione:
    conversioni_yyyymmdd.gz

Content Format for Data Files

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 2etichetta 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 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 yyyy-MM-dd HH:mm:ss 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:

  • 0: Impressioni
  • 1: Clic
  • -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.

Delivery Methods for Data Files

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.

IMPORTANTE

Contatta il tuo consulente Audience Manager o l'Assistenza clienti per iniziare e configurare una Amazon S3 directory per i file di dati.

Sintassi percorso di consegna ed esempi

I dati vengono memorizzati in uno spazio dei nomi separato per ciascun cliente in una Amazon S3 directory. Il percorso del file segue la sintassi indicata di seguito. Note, italics indicates a variable placeholder. Gli 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=AAM ID

Questa coppia chiave-valore 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.

file type_yyyymmdd

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.

Passaggi successivi

Esaminate i requisiti per la denominazione e la creazione di file di metadati. Per iniziare, consultate Panoramica e mappature per i filedi metadati.

In questa pagina