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

L'API di inserimento di annunci dinamici consente di richiedere e monitorare i live streaming con inserimento di annunci dinamici.

Servizio: dai.google.com

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

Metodo: stream

Richiesta HTTP

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

Parametri del percorso

Corpo della richiesta

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

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 la pagina IAB Tech Lab e la specifica VAST 4.1.

Metodo: segmento del pod

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 di query

Note a piè di pagina

1. sd non è obbligatorio per i segmenti di inizializzazione. ↩
2. pd non è obbligatorio per gli eventi in cui sono abilitate le interruzioni pubblicitarie senza durata. ↩

Esempio

https://dai.google.com/linear/pods/v1/seg/2/2/1.2.2.com/linear/pods/v1/seg/2/2/1.2.2.com/linear/pods/v1/seg/2/2/(1.2.2.com/line/pods/v1./seg/2./1.2.2.2.2./...

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 del pod HLS

Recupera il manifest di un pod di annunci HLS di un live streaming pronto per il caricamento e la riproduzione da un video player client.

Richiesta HTTP

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

Parametri del percorso

Parametri di query

Corpo della risposta

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

Metodo: manifest del pod DASH

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

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 di query

Corpo della risposta

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

Metodo: modello di periodo del pod 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 di query

Corpo della risposta

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

Metodo: verifica dei contenuti multimediali

Dopo aver rilevato un identificatore del supporto pubblicitario durante la riproduzione, invia immediatamente una richiesta utilizzando l'URL media_verification_url ottenuto dall'endpoint stream riportato sopra. Queste richieste non sono necessarie per gli stream con beacon lato server, in cui è il server ad avviare la verifica dei contenuti multimediali.

Le richieste all'endpoint media verification sono idempotenti.

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 va a buon fine e tutti i ping vengono inviati.
• HTTP/1.1 404 Not Found se la richiesta non può verificare i contenuti multimediali a causa di una formattazione dell'URL o una scadenza non corrette.
• HTTP/1.1 404 Not Found se una richiesta di verifica precedente 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 dell'annuncio

Gli identificatori dei contenuti multimediali degli annunci verranno codificati in un canale dei metadati separato: metadati con temporizzazione per il flusso di trasporto HLS o emsg per i file MP4. Gli identificatori dei contenuti multimediali degli annunci inizieranno sempre con la stringa google_.

L'intero contenuto del testo delle voci di metadati deve essere aggiunto all'URL di verifica dell'annuncio prima di effettuare ogni richiesta di verifica dell'annuncio.

Metodo: metadata

L'endpoint di metadati in 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 degli elementi multimediali 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 annuncio breaks. L'entry point nei dati è la sezione tags. Da qui, esegui l'iterazione dei tag e trova la prima voce il cui nome è un prefisso per l'ID media dell'annuncio trovato nello stream video. Ad esempio, potresti avere un ID media dell'annuncio simile al seguente:

google_1234567890

Poi trovi un oggetto tag denominato google_12345. In questo caso, corrisponde all'ID media dell'annuncio. Una volta trovato l'oggetto prefisso multimediale 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 di risposta

Stream

{
  "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,
}

PodMetadata

{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}

TagSegment

{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}

AdBreak

{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}

Annuncio

{
  "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),
}

PodTemplateResponse

{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}

Icona

{
  "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

{
  "url": string,
}

FallbackImage

{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}

Wrapper

{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}

Verifica

{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}

JavaScriptResource

{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}

TrackingEvent

{
  "event": string,
  "uri": string,
}

UniversalAdID

{
  "id_value": string,
  "id_registry": string,
}

Companion

{
  "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)],
}

InteractiveFile

{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}