API per l'inserimento di annunci dinamici Linear

L'API di inserimento di annunci dinamici consente di richiedere e monitorare l'inserimento di annunci dinamici in live streaming lineari (DAL VIVO).

Servizio: dai.google.com

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

Metodo: flusso

Richiesta HTTP

POST https://dai.google.com/linear/v1/hls/event/{assetKey}/stream

Intestazione della richiesta

Authorization: DCLKDAI key="<api-key>"

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 Stream Per gli stream di beaconing lato server, Stream contiene solo i campi stream_id e stream_manifest.

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: 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 vengono inviati tutti i ping.
• 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 precedente richiesta di verifica per questo ID ha esito positivo.
• HTTP/1.1 409 Conflict se un'altra richiesta sta già inviando ping in questo momento.

ID elementi multimediali annuncio (HLS)

Gli identificatori degli elementi multimediali dell'annuncio verranno codificati nei metadati temporizzati HLS utilizzando la chiave TXXX, riservato alle "informazioni di testo definite dall'utente" i frame. La i contenuti del frame non verranno criptati e inizieranno sempre con il testo "google_".

L'intero contenuto testuale del frame deve essere aggiunto alla verifica dell'annuncio 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

Utilizzo 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,
  "stream_manifest": string,
  "hls_master_playlist": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "polling_frequency": number,
}

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

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