DocumentazioneAudience ManagerGuida utente di Audience Manager

File di dati per report di Audience Optimization e file di registro fruibili data-files-for-audience-optimization-reports

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

Un file di dati contiene dati su impression, clic o conversione. Una volta formattati correttamente, è possibile importare i dati in Audience Manager per visualizzarli nei Report Audience Optimization e creare caratteristiche utilizzando i dati tramite File di registro fruibili. Formatta i file di dati in base alle specifiche riportate in questa sezione.

Panoramica overview

Un file di dati formattato e denominato in modo corretto consente di importare i dati sulle impression, sui clic o sulla conversione in Report di Audience Optimization. Questa funzione è utile quando si lavora con un partner non integrato con Audience Manager e si desidera lavorare con i relativi dati in quella suite di rapporti. Questo processo richiede file separati per i dati di impression, clic e conversione. Non mescolare questi eventi in un singolo file.

Un file di dati deve essere accompagnato da un file di metadati. Il contenuto del file di metadati corrisponde alle informazioni del file di dati con le relative etichette leggibili dall'utente nei menu del report. Per ulteriori informazioni, vedere Panoramica e mappature dei file di metadati.

Convenzioni di denominazione per i file di dati naming-conventions

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

Sintassi:

tipo evento_aaaammgg

In un nome di file:

  • Il tipo di evento indica che il file contiene impression, clic o conversioni. Crea un file separato per ogni tipo di evento.
  • Un trattino basso separa il tipo di evento e una marca temporale anno-mese-data.
  • Prima di caricare, comprimi i file utilizzando gzip e salvali con l'estensione .gz.

Considerati i requisiti seguenti, assegna ai file di dati un nome in base al loro contenuto, come riportato di seguito:

  • Dati impression:

    code language-none 
    impressioni_aaaammgg.gz

  • Dati clic:

    code language-none 
    clicks_aaaammgg.gz

  • Dati di conversione:

    code language-none 
    conversioni_aaaammgg.gz

Formato del contenuto dei file di dati content-format

La sintassi seguente definisce la struttura del contenuto in un file di dati ben formato. Nota: corsivo indica un segnaposto variabile e viene sostituito con un'etichetta in un file di dati effettivo.

Sintassi:

etichetta 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 impressioni e i clic utilizzano le stesse etichette. I file di conversione contengono intestazioni aggiuntive.

  • Se non si dispone di dati per una colonna particolare, compilare il campo con -1.

  • I file must terminano con un numero di versione. La versione corrente è 1.1.

  • Separare le intestazioni e il contenuto dei file 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 precedente mostra una barra verticale "|" solo a scopo di visualizzazione.

Etichette campo

La tabella seguente elenca e descrive le intestazioni di colonna per il file di dati. Le intestazioni fanno distinzione tra maiuscole e minuscole e devono essere visualizzate come ordinato nella tabella. Tutti i tipi di dati sono numeri interi (INT), a meno che non sia indicato diversamente.

Etichetta
Descrizione
Timestamp
Data e ora UTC per l’evento di impression, clic o conversione. Utilizza il formato yyyy-MM-dd HH:mm:ss.
User-ID
L'ID per un visitatore del sito, noto anche come ID utente univoco del provider di dati o DPUUID.
Advertiser-ID
L’ID sorgente dei dati o il codice di integrazione per l’inserzionista.
BU-ID
ID Business Unit.
Campaign-ID
ID campagna.
Creative-ID
ID creatività.
ID sito
ID sito.
Placement-ID
ID di posizionamento numerico dall’ad server.
Insertion-Order-ID
ID ordine di inserimento.
Tactic-ID
ID tattico.
Vertical-ID
ID per un settore verticale o una categoria.
Quantità

Il numero di articoli venduti in un evento di conversione.

Solo per i file di dati di conversione.

Ricavi

Importo di acquisto o altra conversione. Tipo di dati: mobile.

Solo per i file di dati di conversione.

Altri dati

URL della pagina di destinazione di conversione. Tipo di dati: String.

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: fare clic su
  • -1: non attribuito o sconosciuto

Solo per i file di dati di conversione.

Versione
Numero di versione obbligatorio visualizzato alla fine di ogni riga in un file di dati di impression, clic o conversione. La versione corrente è 1.1.

Metodi di distribuzione dei file di dati delivery-methods

Carica i file di dati di impression, clic o conversione in una directory Amazon S3 per il tuo account Audience Manager. Fai riferimento a questa sezione per informazioni sui percorsi di consegna/directory, sui tempi di elaborazione dei file e sugli aggiornamenti.

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

Sintassi ed esempi del percorso di consegna

I dati vengono memorizzati in uno spazio dei nomi separato per ogni cliente in una directory Amazon S3. Il percorso del file segue la sintassi illustrata di seguito. Nota: corsivo indica un segnaposto variabile. Gli altri elementi sono costanti o chiavi e non cambiano.

Sintassi:

…/log_ingestion/pid= ID AAM/dpid= d_src/logs/ tipo di file_aaaammgg

La tabella seguente definisce ciascuno di questi elementi in un percorso di consegna file.

Parametro file
Descrizione
.../log_ingestion/
Inizio del percorso di archiviazione della directory. Riceverai il percorso completo quando tutto è configurato.
pid=AAM ID
Questa coppia chiave-valore contiene l'ID cliente dell'Audience Manager .
dpid=d_src
Questa coppia chiave-valore contiene l'ID origine dati trasmesso in una chiamata evento. Identifica l’agenzia da cui provengono i dati e li collega a un file di metadati di supporto.
logs
Una directory di livello superiore per i file di dati.
file type_yyyymmdd
Nome del tipo di file che indica il tipo di dati in esso contenuti e un timestamp di consegna.

Percorso di caricamento di esempio e nome file

Quando carichi un file, il percorso sarà simile al seguente:

.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902

Tempi di elaborazione file e aggiornamenti

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 specifico. In questo caso, un giorno è il periodo di 24 ore che va da una mezzanotte alla successiva. Come best practice, puoi utilizzare l’ora UTC per definire l’intervallo giornaliero.

Passaggi successivi next-steps

Rivedi i requisiti per la denominazione e la creazione di file di metadati. Per iniziare, vedere Panoramica e mappature dei file di metadati.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695