Esportare i dati di stream DAI in tempo reale

Si tratta di una funzionalità alfa e potrebbe non essere disponibile per la tua rete.

In questa pagina

• Invio di log
• Log di invio del manifest
• Log delle interruzioni pubblicate
  • Struttura del log delle interruzioni pubblicate
    • Stato annunci
    • Stato slate
• Log delle interazioni con l'ad server
   

I log in tempo reale per l'inserimento di annunci dinamici (DAI) consentono di esportare i dati a livello di stream quasi in tempo reale per monitorare e risolvere i problemi di pubblicazione. Questo articolo illustra le specifiche relative all'invio dei file di log, i campi specifici e i problemi noti.

Invio di log

I file di log vengono inviati ai bucket di archiviazione specifici del publisher in Google Cloud, all'incirca ogni 5 minuti.

Il nome del bucket è: gs://gdai-[NETWORK_CODE]

Suggerimento: per ricevere assistenza per l'accesso al bucket Google Cloud Storage, puoi contattare il team dedicato al tuo account. Preparati a condividere un gruppo all'interno di Google Workspace gestito internamente dalla tua azienda oppure a designare un utente presso la tua azienda che possa gestire un gruppo fornito per te.

I nomi dei file hanno il seguente formato:

[Log Type]_[Network Code]_[Stream Type]_[Content ID]_[YYYYMMDD]_[HHMMSS]_
[Random Number].gz

Dove:

• Log Type: DAIAdServerInteraction o DAIManifest o DAIServedBreak
• Network Code: codice di rete Ad Manager
• Stream Type: VOD, Linear o PODSERVING
• Content ID: ID origine di contenuto per VOD unito, PODSERVING per la pubblicazione di pod VOD, chiave asset per i live streaming
• YYMMDD, HHMMSS: data e ora della generazione dei log in UTC
• Random Number: numero casuale

I file sono compressi in formato gzip e contengono dati come virgolette doppie e valori separati da virgola conformi allo standard RFC4180. Per quanto riguarda la Sezione 2, punto 5 dello standard RFC4180, che stabilisce che "Ogni campo può essere o meno racchiuso tra virgolette doppie", tieni presente che tutti i dati nei file di log sono racchiusi tra virgolette doppie.

I file rimangono nel bucket per 7 giorni, dopodiché vengono rimossi.

Nota: i campi potrebbero cambiare con le nuove release. Il client deve sempre analizzare i file CSV in base alla loro intestazione, nel caso in cui vengano aggiunti nuovi campi o quelli vecchi vengano rimossi.

Log di invio del manifest

Questo log fornisce informazioni sulla pubblicazione di stream video. Sono presenti i seguenti campi:

Campo**	Descrizione
timestamp INTEGER	Timestamp UTC della richiesta (in formato Unix)
entry_id STRING	ID univoco per la voce di log Attualmente il nostro sistema presenta un limite per cui una voce di log può comparire più di una volta. Questo ID può essere utilizzato per deduplicare le voci.
stream_id STRING	ID univoco assegnato a ogni stream (noto anche come ID SAM)
network_code INTEGER	Codice di rete del publisher
dai_type STRING	Tipo di DAI: DAI_TYPE_STITCHED DAI_TYPE_PODSERVING
content STRING	ID origine di contenuto
vid STRING	Video ID
asset_key STRING	Chiave asset del live streaming
custom_asset_key STRING	Chiave asset del live streaming definita dal publisher
manifest_type STRING	Tipo di manifest del video: MANIFEST_TYPE_HLS MANIFEST_TYPE_DASH
stream_type STRING	Tipo di stream: STREAM_TYPE_VOD STREAM_TYPE_LINEAR
request_type STRING	Tipo di richiesta: REQUEST_TYPE_STREAM_CREATE REQUEST_TYPE_MASTER_PLAYLIST REQUEST_TYPE_MEDIA_PLAYLIST REQUEST_TYPE_MPD REQUEST_TYPE_SUBTITLES REQUEST_TYPE_INTERSTITIALS REQUEST_TYPE_IFRAME_PLAYLIST REQUEST_TYPE_AD_METADATA (ID3 events) REQUEST_TYPE_SEGMENT_REDIRECT REQUEST_TYPE_POD_ASSET_LIST REQUEST_TYPE_POD_MULTIVARIANT REQUEST_TYPE_POD_VARIANT REQUEST_TYPE_POD_MPD REQUEST_TYPE_POD_TIMING_METADATA
beaconing_type STRING	Tipo di beaconing degli annunci per lo stream: BEACONING_TYPE_SERVER_TRIGGERED: lato server BEACONING_TYPE_CLIENT_TRIGGERED: lato client (SDK IMA) BEACONING_TYPE_CLIENT_INITIATED_SERVER_TRIGGERED: lato client (API DAI e SDK IMA nel prossimo futuro)
http_method STRING	Metodo utilizzato nella richiesta HTTP
user_agent STRING	User agent del dispositivo
response_code INTEGER	Codice di risposta HTTP
response_time DOUBLE	Latenza della richiesta (in secondi)

Log delle interruzioni pubblicate

Questo log fornisce informazioni sulle interruzioni pubblicitarie pubblicate per i client DAI. Per maggiori dettagli ed esempi sulla presentazione delle informazioni nel log, vedi Struttura del log delle interruzioni pubblicate. 

Campo**	Descrizione
timestamp INTEGER	Timestamp UTC della richiesta (in formato Unix)
entry_id STRING	ID univoco per la voce di log Attualmente il nostro sistema presenta un limite per cui una voce di log può comparire più di una volta. Questo ID può essere utilizzato per deduplicare le voci.
stream_id STRING	ID univoco assegnato a ogni stream (noto anche come ID SAM)
network_code STRING	Codice di rete del publisher
dai_type STRING	Tipo di DAI: DAI_TYPE_STITCHED DAI_TYPE_PODSERVING
content STRING	ID origine di contenuto
vid STRING	ID video
asset_key STRING	Chiave asset del live streaming
custom_asset_key STRING	Chiave asset del live streaming definita dal publisher
break_id STRING	ID di questa interruzione pubblicitaria pubblicata Per VOD, sarà un ID interruzione VMAP. Esempio: "preroll-1", "midroll-2" Per i live streaming, si tratta di un numero di interruzione sequenziale assegnato a questa interruzione da DAI. Esempio: "0000000001", "0000000024"
expected_break_duration DOUBLE	La durata per cui DAI ha richiesto gli annunci in base al tempo previsto da DAI dell'interruzione.
actual_break_duration DOUBLE	La durata in cui DAI ha riempito i contenuti. Si tratta della durata sommata di annunci, slate e contenuti DAI sottostanti riempiti nell'interruzione pubblicitaria.
ads_duration DOUBLE	La durata dei contenuti multimediali dell'annuncio nell'interruzione pubblicitaria. Per VOD, indica anche la durata effettiva dell'interruzione pubblicitaria.
slate_duration DOUBLE	La durata degli elementi multimediali slate nell'interruzione pubblicitaria.
ads_status STRING	Lo stato dell'inserimento dell'annuncio nell'interruzione pubblicitaria. Per maggiori dettagli, vedi Struttura del log delle interruzioni pubblicate.
slate_status STRING	Lo stato dell'inserimento slate nell'interruzione pubblicitaria. Per maggiori dettagli, vedi Struttura del log delle interruzioni pubblicate.
complete BOOLEAN	Indica se il pod di annunci è stato completato. Per gli stream HLS, significa che DAI ha inserito un indicatore cue-in per segnalare la fine del pod di annunci. Per gli stream DASH, significa che il periodo dell'annuncio è chiuso.

Struttura del log delle interruzioni pubblicate

I log delle interruzioni pubblicate da DAI forniscono informazioni su come DAI pubblica le interruzioni pubblicitarie per i client. Le seguenti tabelle Stato annunci e Stato slate presentano informazioni sui log DAI in diversi scenari di stitching degli annunci. Scopri di più sui log delle interruzioni pubblicate per i live streaming.

Stato annunci

Di seguito è riportato un elenco degli stati annunci e il relativo significato.

Stato annunci	Descrizione
ADS_STATUS_INSERTED	L'inserimento dell'annuncio è riuscito.
ADS_STATUS_DROPPED_UNKNOWN	Il pod di annunci è stato eliminato per un motivo sconosciuto.
ADS_STATUS_ALL_ADS_MISSING	Il pod di annunci è stato eliminato perché mancano tutti gli annunci nel pod.
ADS_STATUS_TOO_MANY_MIDROLLS	Il pod di annunci è stato eliminato perché l'ad server ha restituito un numero maggiore di pod mid-roll che interruzioni pubblicitarie da inserire.
ADS_STATUS_OUT_OF_WINDOW	L'interruzione pubblicitaria è parzialmente o completamente al di fuori della finestra di stitching al momento della richiesta e al posto degli annunci verranno inseriti i contenuti sottostanti.
ADS_STATUS_DISABLED	Gli annunci sono stati disattivati per questo stream.
ADS_STATUS_DROPPED_FOR_PREROLL	Questo pod di annunci mid-roll è stato eliminato a causa di un'interruzione pubblicitaria pre-roll in corso.
ADS_STATUS_EXPIRED	Il pod di annunci è scaduto perché la richiesta di annuncio non è stata completata in tempo per lo stitching ai contenuti.
ADS_STATUS_HOLIDAY	Il pod di annunci è stato eliminato a causa di una sospensione dell'annuncio in corso.
ADS_STATUS_DROPPED_SLATE_UNAVAILABLE	Gli annunci sono stati eliminati a causa di un errore che si è verificato con lo slate. Controlla lo stato dello slate.
ADS_STATUS_INTERNAL_ERROR	DAI ha rilevato un errore durante la richiesta o l'assemblaggio degli annunci.
ADS_STATUS_INVALID_POD_REQUEST	Il pod di annunci è stato eliminato a causa di una richiesta di pod non valida.
ADS_STATUS_DROPPED_FOR_MIDROLL	L'interruzione pre-roll richiesta si sovrapporrebbe a un'interruzione pubblicitaria mid-roll.
ADS_STATUS_DROPPED_EXCEEDS_MAX_POD_FILLER_DURATION	È necessario troppo riempimento del pod di annunci (non sono stati pubblicati annunci sufficienti).
ADS_STATUS_DROPPED_BREAK_DURATION_TOO_SHORT	La durata dell'interruzione pubblicitaria era troppo breve per richiedere annunci.
ADS_STATUS_DROPPED_STREAM_CREATED_AFTER_BREAK	Stream creato dopo la fine dell'interruzione pubblicitaria.
ADS_STATUS_DROPPED_MEDIA_ANALYSIS_UNAVAILABLE	Le informazioni sul flusso di contenuti necessarie per unire gli annunci mancano o non sono disponibili.
ADS_STATUS_NO_ADS_AVAILABLE_BEFORE_DEADLINE	Nessun annuncio era disponibile prima della scadenza della richiesta.

Stato slate

Di seguito è riportato un elenco degli stati slate e il relativo significato.

Stato slate	Descrizione
SLATE_STATUS_INSERTED	L'inserimento dello slate è riuscito.
SLATE_STATUS_SKIPPED	L'inserimento dello slate è stato ignorato a causa della configurazione dell'evento di live streaming (disattivato, ignorato o vuoto).
SLATE_STATUS_DROPPED_UNKNOWN	Lo slate non è stato inserito in questa interruzione pubblicitaria per motivi sconosciuti.
SLATE_STATUS_MINIMUM_INSERTED	Il resto dell'interruzione pubblicitaria è stato unito ai contenuti sottostanti, con una piccola quantità di slate per collegare annunci e contenuti.
SLATE_STATUS_INTERNAL_ERROR	Lo slate non è stato inserito in questa interruzione pubblicitaria a causa di un errore interno.

Log delle interazioni con l'ad server

Questo log fornisce informazioni sulle interazioni con un ad server per ricevere gli annunci. Per ulteriori dettagli ed esempi su come vengono presentate le informazioni nel log, consulta Struttura del log delle interazioni con l'ad server.

Campo**	Descrizione
timestamp INTEGER	Timestamp UTC della richiesta (in formato Unix)
entry_id STRING	ID univoco per la voce di log Attualmente il nostro sistema presenta un limite per cui una voce di log può comparire più di una volta. Questo ID può essere utilizzato per deduplicare le voci.
stream_id STRING	ID univoco assegnato a ogni stream (noto anche come ID SAM)
network_code INTEGER	Codice di rete Ad Manager
dai_type STRING	Tipo di DAI: DAI_TYPE_STITCHED DAI_TYPE_PODSERVING
content STRING	ID origine di contenuto
vid STRING	Video ID
asset_key STRING	Chiave asset del live streaming
custom_asset_key STRING	Chiave asset del live streaming definita dal publisher
pod_id INTEGER	ID dell'interruzione pubblicitaria: Per VOD, si tratta dell'ID interruzione di VMAP Per i live streaming, si tratta del numero di interruzione sequenziale
ad_server_host_name STRING	Nome di dominio dell'ad server
response_time DOUBLE	Latenza della richiesta (in secondi)
response_type STRING	Tipo di risposta: VAST VMAP UNKNOWN: da impostare quando viene ricevuta una risposta non valida o si verifica il timeout della risposta
response_code INTEGER	Codice di risposta HTTP
row_type STRING	Tipo di voce del file di log: PRIMARY_REQUEST AD_POD WRAPPER INLINE Fai riferimento all'esempio di risposta VMAP che include ogni tipo di file di log.
vast_error_code STRING	Codice di errore VAST
prefetch_stage STRING	Fase di precaricamento (se il precaricamento è abilitato)
ad_position STRING	Posizione dell'annuncio deciso nel pod di annunci Il valore degli annunci selezionati parte da 1 Questo campo è vuoto per gli annunci del buffet pubblicitario inutilizzati e gli annunci ignorati
ad_id STRING	Una stringa identificatore definita dall'ad server per l'annuncio. Mappato all'attributo id <Ad> in VAST.
ad_system STRING	Una stringa che fornisce il nome dell'ad server che ha restituito l'annuncio. Mappato all'elemento <AdSystem> in VAST.
ad_title STRING	Una stringa che fornisce un nome comune per l'annuncio. Mappato all'elemento <AdTitle> in VAST.
creative_id STRING	Una stringa utilizzata per identificare l'ad server che fornisce la creatività. Mappato all'attributo ID <Creative>.
creative_ad_id STRING	Utilizzato per fornire l'identificatore univoco dell'ad server per la creatività. Mappato all'attributo <Creative> adId.
universal_ad_id_registry STRING	Stringa utilizzata per identificare l'URL del sito web del registro in cui è catalogato l'ID creatività univoco. Corrisponde all'attributo idRegistry dell'elemento <UniversalAdId> in VAST.
universal_ad_id_value STRING	Un identificatore univoco della creatività mantenuto in tutti i sistemi pubblicitari.  Mappato all'attributo <UniversalAdId> idValue.
creative_duration DOUBLE	Durata della creatività
mezzanine_uri STRING	Il file video non elaborato di alta qualità che può essere utilizzato per produrre transcodifiche della migliore qualità, se necessario. Mappa all'elemento <Mezzanine> in VAST. Tutti gli elementi dell'URI sono preceduti da un carattere di escape, ad eccezione dei caratteri specificati come non riservati in RFC3986.
media_uri STRING	Questo è il primo elemento trovato nel nodo MediaFiles in VAST. Tutti gli elementi dell'URI sono preceduti da un carattere di escape, ad eccezione dei caratteri specificati come non riservati in RFC3986.
break_start_uri STRING	L'elemento di monitoraggio utilizzato per monitorare l'inizio di un'interruzione pubblicitaria. Questi dati provengono dalla risposta VMAP Tutti gli elementi dell'URI sono preceduti da un carattere di escape, ad eccezione dei caratteri specificati come non riservati in RFC3986.
google_video_id STRING	Identificatore univoco di una creatività associata a questo annuncio.

** Dove non applicabili per una determinata riga, alcuni campi potrebbero essere lasciati vuoti