API live per la pubblicazione di pod di inserimento di annunci dinamici

L'API Dynamic Ad Insertion ti consente di richiedere e monitorare i live streaming DAI.

Servizio: dai.google.com

Tutti gli URI sono relativi a https://dai.google.com.

Metodo: stream

Metodi
stream POST /ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

Registra una sessione di live streaming di pubblicazione di pod DAI.

Richiesta HTTP

POST https://dai.google.com/ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

Parametri del percorso

Parametri
network_code string

Il codice di rete Google Ad Manager del publisher.

custom_asset_key string

L'identificatore personalizzato associato a questo evento in Google Ad Manager.

Corpo della richiesta

Il corpo della richiesta è di tipo application/x-www-form-urlencoded e contiene i seguenti parametri:

Parametri
Parametri di targeting DFP Facoltativo Parametri di targeting aggiuntivi.
Override Stream Parameters Facoltativo Eseguire l'override dei valori predefiniti di un parametro di creazione dello stream.
Autenticazione HMAC Facoltativo Autenticati utilizzando un token basato su HMAC.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un nuovo oggetto Stream.

Open Measurement

L'API DAI contiene informazioni per la verifica Open Measurement nel campo Verifications. Questo campo contiene uno o più elementi Verification che elencano le risorse e i metadati necessari per eseguire il codice di misurazione di terze parti al fine di verificare la riproduzione della creatività. È supportato solo JavaScriptResource. Per ulteriori informazioni, consulta IAB Tech Lab e la specifica VAST 4.1.

Metodo: segmento di pod

Metodi
pod segment GET /linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

Crea uno stream DAI per l'ID evento specificato.

Richiesta HTTP

GET https://dai.google.com/linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

Parametri del percorso

Parametri
network_code string

Il codice di rete Google Ad Manager del publisher.

custom_asset_key string

L'identificatore personalizzato associato a questo evento in Google Ad Manager.

pod_identifier

Sono supportati i seguenti formati:

pod/{integer}

L'identificatore numerico dell'interruzione pubblicitaria corrente. Gli ID pod di annunci vengono assegnati in modo incrementale per ogni evento di interruzione pubblicitaria, a partire da 1.

ad_break_id/{string}

L'identificatore stringa per l'interruzione pubblicitaria corrente. Un ID interruzione pubblicitaria fornito dal publisher non ha gli stessi vincoli dell'ID pod di annunci. Qualsiasi ID interruzione pubblicitaria sconosciuto fornito a questo endpoint crea una nuova interruzione pubblicitaria per l'evento live streaming.

profile_name string

Il nome del profilo di codifica DAI di Google Ad Manager richiesto. Il profilo di codifica deve essere uno di quelli configurati per l'evento selezionato.

segment_number integer

L'indice del segmento richiesto all'interno del pod di annunci corrente, a partire da zero.
segment_format string

L'estensione del file associata al formato del segmento richiesto. Le estensioni accettate sono: ts, mp4, vtt, aac, ac3 o eac3.

Parametri di query

Parametri
stream_id obbligatorio string

L'ID stream per la sessione dell'utente corrente. Questo valore viene restituito da una richiesta riuscita all'endpoint stream.
sd required1 integer

La durata del segmento richiesto, in millisecondi.
so facoltativo

L'offset del segmento richiesto all'interno del pod di annunci, in millisecondi. Se ometti il parametro so, questo verrà calcolato moltiplicando la durata del segmento per il numero del segmento.
pd obbligatorio2 integer

La durata del pod di annunci, in millisecondi.
auth-token obbligatorio string

Un token HMAC firmato e codificato nell'URL per il pod di annunci corrente.
last facoltativo boolean

Indica l'ultimo segmento dell'interruzione pubblicitaria. Ometti questo parametro per tutti gli altri segmenti.
scte35 facoltativo string

Segnale SCTE-35 con codifica Base64 per questa interruzione pubblicitaria.
cust_params facoltativo string

Un insieme di coppie chiave-valore, utilizzate per il targeting di campagne Ad Manager. Queste coppie devono essere rappresentate come una stringa di query con codifica URL.

Esempio:
Parametri
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Note a piè di pagina

  1. sd non è obbligatorio per i segmenti di inizializzazione. ↩
  2. pd non è richiesto per gli eventi con interruzioni pubblicitarie senza durata abilitate. ↩

Esempio

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/ad_break_id/adbreak-2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

Corpo della risposta

In caso di esito positivo, il corpo della risposta sarà un segmento di stream riproducibile corrispondente al formato e ai parametri specificati nella richiesta.

Metodo: manifest pod HLS

Recupera un manifest del pod di annunci HLS di un live streaming pronto per essere caricato e riprodotto da un video player client.

Metodi
GET GET /linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset}/{pod_identifier}.m3u8;

API per recuperare una playlist multivariante HLS per un pod di annunci.

Richiesta HTTP

GET https://dai.google.com/linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}.m3u8?stream_id={stream_id}&pd={pod_duration}

Parametri del percorso

Parametri
network_code string

Il codice di rete Google Ad Manager del publisher.
custom_asset_key string

L'identificatore personalizzato associato a questo evento in Google Ad Manager
pod_identifier

Sono supportati i seguenti formati:

pod/{integer}

L'identificatore numerico dell'interruzione pubblicitaria corrente. Gli ID pod di annunci vengono assegnati in modo incrementale per ogni evento di interruzione pubblicitaria, a partire da 1.

ad_break_id/{string}

L'identificatore stringa per l'interruzione pubblicitaria corrente. Un ID interruzione pubblicitaria fornito dal publisher non ha gli stessi vincoli dell'ID pod di annunci. Qualsiasi ID interruzione pubblicitaria sconosciuto fornito a questo endpoint crea una nuova interruzione pubblicitaria per l'evento live streaming.

Parametri di query

Parametri
stream_id Obbligatorio string

L'ID stream per la sessione dell'utente corrente. Questo valore viene restituito da una richiesta riuscita all'endpoint stream.
pd Obbligatorio integer

La durata del pod di annunci, in millisecondi.
scte35 facoltativo string

Segnale SCTE-35 con codifica Base64 per questa interruzione pubblicitaria.
cust_params facoltativo string

Un insieme di coppie chiave-valore, utilizzate per il targeting di campagne Ad Manager. Queste coppie devono essere rappresentate come una stringa di query con codifica URL.

Esempio:
Parametri
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Corpo della risposta

In caso di esito positivo, il corpo della risposta è una playlist multivariante HLS.

Metodo: manifest pod DASH

Recupera un manifest di pod di annunci MPEG-DASH di un live streaming pronto per essere caricato e riprodotto da un video player client.

Metodi
GET GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset}/stream/{stream_id}/pod/{pod_id}/manifest.mpd

API per recuperare una playlist MPEG-DASH mpd per un pod di annunci.

Richiesta HTTP

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/stream/{stream_id}/pod/{pod_id}/manifest.mpd?pd={pod_duration}

Parametri del percorso

Parametri
network_code string

Il codice di rete Google Ad Manager del publisher.
custom_asset_key string

L'identificatore personalizzato associato a questo evento in Google Ad Manager
stream_id string

L'ID stream per la sessione dell'utente corrente. Questo valore viene restituito da una richiesta riuscita all'endpoint stream.
pod_id integer

L'identificatore numerico dell'interruzione pubblicitaria corrente. Gli ID pod di annunci vengono assegnati in modo incrementale per ogni evento di interruzione pubblicitaria, a partire da 1.

Parametri di query

Parametri
pd Obbligatorio integer

La durata del pod di annunci, in millisecondi.
scte35 facoltativo string

Segnale SCTE-35 con codifica Base64 per questa interruzione pubblicitaria.
cust_params facoltativo string

Un insieme di coppie chiave-valore, utilizzate per il targeting di campagne Ad Manager. Queste coppie devono essere rappresentate come una stringa di query con codifica URL.

Esempio:
Parametri
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Corpo della risposta

In caso di esito positivo, il corpo della risposta è una playlist MPD MPEG-DASH.

Metodo: modello di periodo del pod DASH

Metodi
pods GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

Richiede un modello di periodo DASH da Google Ad Manager. Questo modello contiene macro che devi compilare con i parametri dello stream. Una volta compilate queste macro, il modello diventa il periodo di interruzione pubblicitaria e può essere inserito nel manifest DASH.

Richiesta HTTP

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

Parametri del percorso

Parametri
network_code string

Il codice di rete Google Ad Manager del publisher.

custom_asset_key string

L'identificatore personalizzato associato a questo evento in Google Ad Manager.

Parametri di query

Parametri
stream_id obbligatorio string

L'ID stream per la sessione dell'utente corrente. Questo valore viene restituito da una richiesta riuscita all'endpoint stream.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un nuovo oggetto PodTemplateResponse.

Metodo: metadati di sincronizzazione del pod di annunci

Metodi
ad pod timing metadata GET /linear/pods/v1/adv/network/{network_code}/custom_asset/{custom_asset_key}/pod.json

Recupera i metadati di temporizzazione del pod di annunci.

Richiesta HTTP

GET https://dai.google.com/linear/pods/v1/adv/network/{network_code}/custom_asset/{custom_asset_key}/pod.json

Parametri del percorso

Parametri
network_code string

Il codice di rete Google Ad Manager del publisher.

custom_asset_key string

L'identificatore personalizzato associato a questo live streaming in Google Ad Manager.

Parametri di query

Parametri
stream_id Obbligatorio string

L'ID stream di Ad Manager dell'app video player client.
ad_break_id obbligatorio string

L'ID della prossima interruzione pubblicitaria imminente.

Gli ID interruzione pubblicitaria vengono forniti dal server di stitching o da VTP e devono corrispondere nelle notifiche di interruzione pubblicitaria anticipata, nelle richieste di metadati di temporizzazione del pod pubblicitario e nelle richieste di reindirizzamento del segmento per la stessa interruzione pubblicitaria.

Si applicano le seguenti limitazioni agli ID interruzione pubblicitaria personalizzati:

  • Deve avere una lunghezza compresa tra 1 e 63 caratteri
  • Deve contenere solo lettere minuscole, cifre e trattini.
  • L'ID interruzione pubblicitaria preroll è riservato al recupero del pod di annunci pre-roll. Non può essere utilizzato per identificare altri pod di annunci.
auth-token obbligatorio string

auth-token è costituito da un token HMAC con i seguenti parametri:

  • ad_break_id
  • custom_asset_key
  • exp
  • network_code
  • custom_params
  • pd
  • scte35
timeout facoltativo integer

Il numero di millisecondi per cui DAI può bloccare questa richiesta in attesa della decisione sugli annunci. Utilizza questo parametro nelle richieste che devono restituire annunci compilati nella prima richiesta, ad esempio le interruzioni pubblicitarie pre-roll.

Se il timeout viene superato, la richiesta restituisce lo stato In attesa.

Se incluso, il valore del timeout deve essere compreso tra 1000 e 15.000 millisecondi. Se omesso, le risposte non vengono ritardate per attendere la decisione sugli annunci.
final facoltativo boolean

Imposta true per indicare a DAI che questa è l'ultima richiesta che il VTP è disposto a effettuare per questo pod di annunci. Se una decisione pubblicitaria non è ancora disponibile (entro il timeout facoltativo), DAI restituirà una schermata in modo permanente per questa richiesta.

Il valore predefinito è false.

Parametri per le decisioni relative agli annunci
pd facoltativo integer

La durata dell'interruzione pubblicitaria (in millisecondi). Indicata anche come durata del pod di annunci.

Se viene utilizzato EABN, il valore pd deve corrispondere alla durata fornita nella notifica della pausa pubblicitaria. Se le durate non corrispondono, verrà data priorità al valore EABN.

cust_params facoltativo string

Parametri personalizzati per il targeting delle interruzioni pubblicitarie, come descritto nel Centro assistenza Ad Manager.
scte35 facoltativo string

Un segnale SCTE-35 con codifica Base64.

Se l'indicatore non è valido, verrà inviato un messaggio nell'intestazione HTTP X-Ad-Manager-Dai-Warning della risposta e la richiesta verrà inviata senza il valore scte35 non valido.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un nuovo oggetto AdPodTimingMetadataResponse.

Metodo: verifica dei contenuti multimediali

Dopo aver rilevato un identificatore di contenuti pubblicitari durante la riproduzione, invia immediatamente una richiesta utilizzando l'media_verification_url ottenuta dall'endpoint stream indicato sopra. Queste richieste non sono necessarie per gli stream di beaconing lato server, in cui il server avvia la verifica dei contenuti multimediali.

Le richieste all'endpoint media verification sono idempotenti.

Metodi
media verification GET /{media_verification_url}/{ad_media_id}

Notifica all'API un evento di verifica dei contenuti multimediali.

Richiesta HTTP

GET https://{media-verification-url}/{ad-media-id}

Corpo della risposta

media verification restituisce le seguenti risposte:

  • HTTP/1.1 204 No Content se la verifica dei contenuti multimediali ha esito positivo e tutti i ping vengono inviati.
  • HTTP/1.1 404 Not Found se la richiesta non può verificare i contenuti multimediali a causa della formattazione errata dell'URL o della scadenza.
  • HTTP/1.1 404 Not Found se una precedente richiesta di verifica per questo ID è andata a buon fine.
  • HTTP/1.1 409 Conflict se un'altra richiesta sta già inviando ping in questo momento.

ID elementi multimediali annuncio

Gli identificatori dei contenuti multimediali degli annunci verranno codificati in una traccia di metadati separata: metadati temporizzati per il flusso di trasporto HLS o emsg per i file MP4. Gli identificatori dei media pubblicitari inizieranno sempre con la stringa google_.

L'intero contenuto di testo della voce dei metadati deve essere aggiunto all'URL di verifica dell'annuncio prima di effettuare ogni richiesta di verifica dell'annuncio.

Metodo: metadati

L'endpoint dei metadati all'indirizzo metadata_url restituisce le informazioni utilizzate per creare un'interfaccia utente dell'annuncio. L'endpoint dei metadati non è disponibile per gli stream di beaconing lato server, in cui il server è responsabile dell'avvio della verifica dei contenuti pubblicitari.

Metodi
metadata GET /{metadata_url}/{ad-media-id}

GET /{metadata_url}

Recupera le informazioni sui metadati degli annunci.

Richiesta HTTP

GET https://{metadata_url}/{ad-media-id}

GET https://{metadata_url}

Corpo della risposta

In caso di esito positivo, la risposta restituisce un'istanza di PodMetadata.

Analisi dei metadati

I metadati sono suddivisi in tre sezioni distinte: tags, ads e breaks. Il punto di accesso ai dati è la sezione tags. Da qui, scorri i tag e trova la prima voce il cui nome è un prefisso per l'ID media annuncio trovato nel flusso video. Ad esempio, potresti avere un ID media annuncio simile a questo:

google_1234567890

Poi, trovi un oggetto tag denominato google_12345. In questo caso, corrisponde all'ID delle risorse pubblicitarie. Una volta trovato l'oggetto prefisso del media dell'annuncio corretto, puoi cercare gli ID annuncio, gli ID interruzione pubblicitaria e il tipo di evento. Gli ID annuncio vengono poi utilizzati per indicizzare gli oggetti ads e gli ID interruzione pubblicitaria vengono utilizzati per indicizzare gli oggetti breaks.

Dati della risposta

Stream

Stream viene utilizzato per eseguire il rendering di un elenco di risorse per un flusso appena creato in formato JSON.
Rappresentazione JSON
{
  "stream_id": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "heartbeat_url": string,
  "polling_frequency": number,
  "pod_manifest_url": string,
  "manifest_format": string,
}
Campi
stream_id string

L'identificatore dello stream GAM.
media_verification_url string

L'URL di verifica dei contenuti multimediali utilizzato come endpoint di base per il monitoraggio degli eventi di riproduzione.
metadata_url string

URL dei metadati utilizzato per eseguire il polling delle informazioni periodiche sugli eventi degli annunci in streaming imminenti.
session_update_url string

L'URL di aggiornamento della sessione utilizzato per aggiornare i parametri di targeting per questo stream. I valori originali dei parametri di targeting vengono acquisiti durante la richiesta iniziale di creazione dello stream.
heartbeat_url string

L'URL heartbeat, utilizzato per mantenere attivo lo stream di beaconing lato server, deve essere sottoposto a ping ogni {PollingFrequency} secondi. Compilato per gli stream di beaconing lato server.
polling_frequency number

La frequenza di polling, in secondi, quando si richiede metadata_url o heartbeat_url.
pod_manifest_url string

Il modello di URL del file manifest del pod viene utilizzato per generare l'URL per recuperare il file manifest del pod di uno stream, corrispondente all'URL della playlist multivariante in HLS o dell'MPD in DASH. Compilato per gli eventi Livestream di tipo inserimento di annunci dinamici POD_SERVING_MANIFEST. https://developers.google.com/ad-manager/api/reference/v202305/LiveStreamEventService.DynamicAdInsertionType
manifest_format string

Manifest format is the format of the manifest retrieved from pod_manifest_url, either dash or hls.

PodMetadata

PodMetadata contiene informazioni sui metadati di annunci, interruzioni pubblicitarie e tag ID media.
Rappresentazione JSON
{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}
Campi
tags map[string, object(TagSegment)]

Mappa dei segmenti di tag indicizzati in base al prefisso del tag.
ads map[string, object(Ad)]

Mappa degli annunci indicizzati per ID annuncio.
ad_breaks map[string, object(AdBreak)]

Mappa delle interruzioni pubblicitarie indicizzate per ID interruzione pubblicitaria.

TagSegment

TagSegment contiene un riferimento a un annuncio, alla relativa interruzione pubblicitaria e al tipo di evento. TagSegment con type="progress" non deve essere pingato all'endpoint di verifica dei contenuti multimediali dell'annuncio.
Rappresentazione JSON
{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}
Campi
ad string

L'ID dell'annuncio di questo tag.
ad_break_id string

L'ID dell'interruzione pubblicitaria di questo tag.
type string

Il tipo di evento di questo tag.

AdBreak

AdBreak descrive una singola interruzione pubblicitaria nel flusso. Contiene una durata, un tipo (mid/pre/post) e il numero di annunci.
Rappresentazione JSON
{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}
Campi
type string

I tipi di interruzione validi sono: pre, mid e post.
duration number

Durata totale dell'annuncio per questa interruzione pubblicitaria, in secondi.
expected_duration number

Durata prevista dell'interruzione pubblicitaria (in secondi), inclusi tutti gli annunci e qualsiasi elemento slate.
ads number

Numero di annunci nell'interruzione pubblicitaria.
Annuncio descrive un annuncio nello stream.
Rappresentazione JSON
{
  "ad_break_id": string,
  "position": number,
  "duration": number,
  "title": string,
  "description": string,
  "advertiser": string,
  "ad_system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
  "clickthrough_url": string,
  "click_tracking_urls": [],
  "verifications": [object(Verification)],
  "slate": boolean,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "universal_ad_id": object(UniversalAdID),
  "extensions": [],
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
}
Campi
ad_break_id string

L'ID dell'interruzione pubblicitaria di questo annuncio.
position number

Posizione di questo annuncio nell'interruzione pubblicitaria, a partire da 1.
duration number

Durata dell'annuncio, in secondi.
title string

Titolo facoltativo dell'annuncio.
description string

Descrizione facoltativa dell'annuncio.
advertiser string

Identificatore inserzionista facoltativo.
ad_system string

Sistema pubblicitario facoltativo.
ad_id string

ID annuncio facoltativo.
creative_id string

ID creatività facoltativo.
creative_ad_id string

ID annuncio creatività facoltativo.
deal_id string

ID deal facoltativo.
clickthrough_url string

(Facoltativo) URL di clickthrough.
click_tracking_urls string

(Facoltativo) URL di monitoraggio dei clic.
verifications [object(Verification)]

Voci di verifica Open Measurement facoltative che elencano le risorse e i metadati necessari per eseguire il codice di misurazione di terze parti per verificare la riproduzione delle creatività.
slate boolean

Valore booleano facoltativo che indica che la voce corrente è una scheda.
icons [object(Icon)]

Un elenco di icone, omesso se vuoto.
wrappers [object(Wrapper)]

Un elenco di wrapper, omesso se vuoto.
universal_ad_id object(UniversalAdID)

ID annuncio universale facoltativo.
extensions string

Elenco facoltativo di tutti i nodi <Extension> in VAST.
companions [object(Companion)]

Companion facoltativi che possono essere visualizzati insieme a questo annuncio.
interactive_file object(InteractiveFile)

Creatività interattiva facoltativa (SIMID) da visualizzare durante la riproduzione dell'annuncio.

PodTemplateResponse

PodTemplateResponse rappresenta il payload JSON restituito a un VTP per l'unione dei pod.
Rappresentazione JSON
{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}
Campi
dash_period_template string

DashPeriodTemplate è il modello XML per il periodo da compilare con i dati appropriati prima dell'unione.
segment_duration_ms int64

SegmentDurationMS è la durata dei segmenti di periodo in millisecondi.

AdpodTimingMetadataResponse

AdpodTimingMetadataResponse contiene informazioni sul pod di annunci e su come creare gli URL dei segmenti per il pod.
Rappresentazione JSON
{
  "status": string,
  "ads": [object(AdRendering)],
  "slate": object(SlateRendering),
  "dash_representations": map[string, object(DASHRepresentation)],
  "dash_adaptation_sets": map[string, object(DASHAdaptationSet)],
}
Campi
status string

Stato della decisione per il pod di annunci.
ads [object(AdRendering)]

Array di oggetti annuncio che descrivono come eseguire il rendering degli URL dei segmenti di annuncio, indicizzati a partire da 0.
slate object(SlateRendering)

Slate che descrive come eseguire il rendering degli URL dei segmenti di slate.
dash_representations map[string, object(DASHRepresentation)]

Elenco delle rappresentazioni DASH per il pod di annunci da eseguire il rendering nei manifest DASH.
dash_adaptation_sets map[string, object(DASHAdaptationSet)]

Elenco di set di adattamento DASH per il pod di annunci da eseguire il rendering nei manifest DASH.

AdRendering

AdRendering descrive come eseguire il rendering di un annuncio per cui è stata presa una decisione.
Rappresentazione JSON
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
Campi
duration_ms number

Durata dell'annuncio, in millisecondi (int).
variants map[string, object(VariantRendering)]

Dizionario di oggetti Variant (vedi sotto), indicizzato in base all'ID variante/profilo, come configurato dall'interfaccia utente.

SlateRendering

SlateRendering descrive come eseguire il rendering dei contenuti della lavagna.
Rappresentazione JSON
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
Campi
duration_ms number

Durata della schermata, in millisecondi (int).
variants map[string, object(VariantRendering)]

Dizionario di oggetti Variant, indicizzati per ID variante/profilo. Le durate delle slide devono essere ripetute in loop fino al raggiungimento della durata richiesta, inserendo interruzioni HLS tra le iterazioni o ripetendo in loop i nuovi periodi per MPEG-DASH.

VariantRendering

VariantRendering descrive una variante/un profilo all'interno dell'annuncio/della scheda.
Rappresentazione JSON
{
  "segment_extension": string,
  "segment_durations": object(SegmentDurations),
}
Campi
segment_extension string

Stringa, uno dei seguenti valori: ts, mp4, aac, ac3, ec3, m4a, m4v. Estensione del nome file parte degli URL dei segmenti.
segment_durations object(SegmentDurations)

Oggetti SegmentDurations. La durata di ogni segmento può essere convertita in un URL del segmento.

SegmentDurations

SegmentDurations descrive la durata di una sequenza di segmenti in un'unità di tempo specificata.
Rappresentazione JSON
{
  "timescale": number,
  "values": [],
}
Campi
timescale number

Timescale è il numero di unità al secondo (int) Valore previsto: 1000 per HLS (millisecondi) 90000 per video DASH (PTS) Frequenza di campionamento audio per audio DASH.
values number

Array di durate dei segmenti int, in unità di scala temporale.

DASHRepresentation

DASHRepresentation descrive i nodi di rappresentazione da sottoporre a rendering nei manifest DASH.
Rappresentazione JSON
{
  "codecs": string,
  "bandwidth": number,
  "width": number,
  "height": number,
  "frame_rate": string,
  "audio_sampling_rate": number,
  "audio_channel_config": object(SchemeIDURIAndValue),
}
Campi
codecs string

Codec della rappresentazione.
bandwidth number

Larghezza di banda della rappresentazione.
width number

Larghezza della rappresentazione.
height number

Altezza della rappresentazione.
frame_rate string

Frequenza fotogrammi della rappresentazione.
audio_sampling_rate number

Frequenza di campionamento audio della rappresentazione.
audio_channel_config object(SchemeIDURIAndValue)

Configurazione del canale audio della rappresentazione.

DASHAdaptationSet

DASHAdaptationSet descrive i nodi AdaptationSet da eseguire il rendering nei manifest DASH.
Rappresentazione JSON
{
  "content_type": string,
  "mime_type": string,
  "role": object(SchemeIDURIAndValue),
  "inband_event_stream": object(SchemeIDURIAndValue),
  "min_frame_rate": string,
  "max_frame_rate": string,
  "scan_type": string,
  "start_with_sap": string,
  "segment_alignment": boolean,
  "representations": [],
}
Campi
content_type string

Tipo di contenuti del set di adattamento.
mime_type string

Tipo MIME del set di adattamento.
role object(SchemeIDURIAndValue)

Ruolo del set di adattamento.
inband_event_stream object(SchemeIDURIAndValue)

Flusso di eventi in banda del set di adattamento.
min_frame_rate string

Frequenza frame minima del set di adattamento.
max_frame_rate string

Frequenza massima fotogrammi del set di adattamento.
scan_type string

Tipo di scansione del set di adattamento.
start_with_sap string

Inizia con SAP del set di adattamento.
segment_alignment boolean

Allineamento dei segmenti del set di adattamento.
representations string

Rappresentazioni del set di adattamento.

SchemeIDURIAndValue

SchemeIDURIAndValue è una coppia costituita da un ID schema e dal relativo valore.
Rappresentazione JSON
{
  "scheme_id_uri": string,
  "value": string,
}
Campi
scheme_id_uri string

URI dell'ID schema del valore.
value string

Valore dell'URI dell'ID schema.

Icona

L'icona contiene informazioni su un'icona VAST.
Rappresentazione JSON
{
  "click_data": object(ClickData),
  "creative_type": string,
  "click_fallback_images": [object(FallbackImage)],
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "x_position": string,
  "y_position": string,
  "program": string,
  "alt_text": string,
}
Campi
click_data object(ClickData)

creative_type string

click_fallback_images [object(FallbackImage)]

height int32

width int32

resource string

type string

x_position string

y_position string

program string

alt_text string

ClickData

ClickData contiene informazioni su un clickthrough di un'icona.
Rappresentazione JSON
{
  "url": string,
}
Campi
url string

FallbackImage

FallbackImage contiene informazioni su un'immagine di riserva VAST.
Rappresentazione JSON
{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}
Campi
creative_type string

height int32

width int32

resource string

alt_text string

Wrapper

Il wrapper contiene informazioni su un annuncio wrapper. Non include un ID deal se non esiste.
Rappresentazione JSON
{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}
Campi
system string

Identificatore del sistema pubblicitario.
ad_id string

ID annuncio utilizzato per l'annuncio wrapper.
creative_id string

ID creatività utilizzato per l'annuncio wrapper.
creative_ad_id string

ID annuncio creatività utilizzato per l'annuncio wrapper.
deal_id string

ID deal facoltativo per l'annuncio wrapper.

Verifica

La verifica contiene informazioni per Open Measurement, che facilita la misurazione della visibilità e della verifica di terze parti. Al momento sono supportate solo le risorse JavaScript. Visita la pagina https://iabtechlab.com/standards/open-measurement-sdk/
Rappresentazione JSON
{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}
Campi
vendor string

Il fornitore di soluzioni di verifica.
java_script_resources [object(JavaScriptResource)]

Elenco delle risorse JavaScript per la verifica.
tracking_events [object(TrackingEvent)]

Elenco degli eventi di monitoraggio per la verifica.
parameters string

Una stringa opaca passata al codice di verifica di bootstrap.

JavaScriptResource

JavaScriptResource contiene informazioni per la verifica tramite JavaScript.
Rappresentazione JSON
{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}
Campi
script_url string

URI del payload JavaScript.
api_framework string

APIFramework è il nome del framework video che esercita il codice di verifica.
browser_optional boolean

Indica se questo script può essere eseguito al di fuori di un browser.

TrackingEvent

TrackingEvent contiene URL che devono essere pingati dal client in determinate situazioni.
Rappresentazione JSON
{
  "event": string,
  "uri": string,
}
Campi
event string

Il tipo di evento di monitoraggio.
uri string

L'evento di monitoraggio a cui inviare il ping.

UniversalAdID

UniversalAdID viene utilizzato per fornire un identificatore univoco della creatività che viene mantenuto nei sistemi pubblicitari.
Rappresentazione JSON
{
  "id_value": string,
  "id_registry": string,
}
Campi
id_value string

L'ID annuncio universale della creatività selezionata per l'annuncio.
id_registry string

Una stringa utilizzata per identificare l'URL del sito web del registro in cui è catalogato l'ID annuncio universale della creatività selezionata.

Complementare

Companion contiene informazioni sugli annunci companion che potrebbero essere visualizzati insieme all'annuncio.
Rappresentazione JSON
{
  "click_data": object(ClickData),
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "ad_slot_id": string,
  "api_framework": string,
  "tracking_events": [object(TrackingEvent)],
}
Campi
click_data object(ClickData)

I dati sui clic per questa creatività companion.
creative_type string

L'attributo CreativeType nel nodo <StaticResource> del tag VAST se si tratta di una companion di tipo statico.
height int32

L'altezza in pixel di questo annuncio companion.
width int32

La larghezza in pixel di questo annuncio companion.
resource string

Per i companion statici e iframe, questo sarà l'URL da caricare e visualizzare. Per i companion HTML, questo sarà lo snippet HTML da mostrare come companion.
type string

Tipo di questa creatività companion. Può essere statico, iframe o HTML.
ad_slot_id string

L'ID slot per questo annuncio companion.
api_framework string

Il framework API per questo componente aggiuntivo.
tracking_events [object(TrackingEvent)]

Elenco degli eventi di monitoraggio per questo annuncio companion.

InteractiveFile

InteractiveFile contiene informazioni per la creatività interattiva (ad es. SIMID) che devono essere visualizzate durante la riproduzione dell'annuncio.
Rappresentazione JSON
{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}
Campi
resource string

L'URL della creatività interattiva.
type string

Il tipo MIME del file fornito come risorsa.
variable_duration boolean

Indica se questa creatività può richiedere l'estensione della durata.
ad_parameters string

Il valore del nodo <AdParameters> nel tag VAST.