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: flusso

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 il parametro 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 Verifications. Questo campo contiene uno o più Verification elemento che elenca le risorse e i metadati richiesti per l'esecuzione codice di misurazione di terze parti al fine di verificare la riproduzione della creatività. Solo JavaScriptResource è supportato. Per ulteriori informazioni, consulta IAB Tech Lab e il Specifiche VAST 4.1.

Metodo: segmento pod

Richiesta HTTP

GET https://dai.google.com//linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/pod/{pod_id}/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 con annuncio senza durata. siano attivate. ↩

Corpo della risposta

In caso di esito positivo, il corpo della risposta sarà un segmento dello stream riproducibile che corrisponde alla il formato e i parametri specificati nella richiesta.

Metodo: modello periodo 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 PodTemplateResponse.

Metodo: verifica dei media

Dopo aver trovato un identificatore multimediale dell'annuncio durante la riproduzione, crea immediatamente una la richiesta utilizzando il valore media_verification_url ottenuto dallo stream dell'endpoint, qui sopra. Queste richieste non sono necessarie per il beaconing lato server in cui il server avvia 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 ha esito positivo e tutti i ping vengono inviate.
• HTTP/1.1 404 Not Found se la richiesta non può verificare i contenuti multimediali a causa di a causa della formattazione o della scadenza dell'URL.
• HTTP/1.1 404 Not Found se una richiesta di verifica precedente per questo ID riuscito.
• HTTP/1.1 409 Conflict se un'altra richiesta sta già inviando ping a questo nel tempo.

ID elementi multimediali dell'annuncio

Gli identificatori multimediali degli annunci verranno codificati in una traccia di metadati separata, a tempo metadati per lo stream di trasporto HLS o emsg per i file mp4. Identificatori degli elementi multimediali degli annunci inizierà sempre con la stringa google_.

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

Metodo: metadati

L'endpoint dei metadati in metadata_url restituisce le informazioni utilizzate per creare un annuncio nell'interfaccia utente. L'endpoint dei metadati non è disponibile per i flussi di beaconing lato server. in cui il server è responsabile di avviare la 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 includono tre sezioni distinte: tags, ads e breaks annuncio. Voce nei dati è la sezione tags. Da qui, ripeti i tag e trova la prima voce il cui nome è un prefisso per ID elemento multimediale annuncio trovato nello stream video. Ad esempio, potrebbe avere un ID elemento multimediale annuncio simile a:

google_1234567890

Quindi, trovi un oggetto tag denominato google_12345. In questo caso, corrisponde ID elemento multimediale annuncio. Una volta trovato l'oggetto corretto per il prefisso di contenuti multimediali dell'annuncio, puoi cercare ID annunci, ID interruzioni pubblicitarie e tipo di evento. Gli ID annuncio vengono quindi utilizzati per indicizzare Per indicizzare gli oggetti breaks vengono utilizzati ads oggetti e ID di interruzioni pubblicitarie.

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