API per l'inserimento di annunci dinamici Linear

L'API di inserimento di annunci dinamici consente di richiedere e monitorare stream lineari (LIVE) con DAI.

Servizio: dai.google.com

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

Metodo: streaming

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 i seguenti parametri:

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un nuovo Stream. Per gli stream con beaconing lato server, questo elemento Stream contiene solo i campi stream_id e stream_manifest.

Apri Measurement

L'API DAI contiene informazioni per la verifica di 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 delle creatività. È supportato solo JavaScriptResource. Per ulteriori informazioni, consulta IAB Tech Lab e la specifica VAST 4.1.

Metodo: verifica dei contenuti multimediali

Dopo aver incontrato un identificatore dei media pubblicitari durante la riproduzione, effettua immediatamente una richiesta utilizzando il valore media_verification_url ottenuto dall'endpoint stream sopra indicato. Queste richieste non sono necessarie per i flussi di 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 o scadenza dell'URL non corretta.
• HTTP/1.1 404 Not Found se una precedente richiesta di verifica per questo documento di identità è andata a buon fine.
• HTTP/1.1 409 Conflict se un'altra richiesta sta già inviando ping in questo momento.

ID elementi multimediali degli annunci (HLS)

Gli identificatori dei contenuti multimediali degli annunci verranno codificati nei metadati a tempo HLS utilizzando la chiave TXXX, riservata ai frame "informazioni di testo definite dall'utente". I contenuti del frame non saranno criptati e inizieranno sempre con il testo "google_".

L'intero contenuto del testo del frame deve essere aggiunto all'URL di 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'interfaccia utente pubblicitaria. L'endpoint dei metadati non è disponibile per gli stream con beaconing lato server, in cui il server è responsabile dell'avvio della verifica degli annunci multimediali.

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 hanno tre sezioni discrete: tags, ads e annuncio breaks. Il punto di ingresso nei dati è la sezione tags. Quindi, esegui l'iterazione dei tag e individua la prima voce il cui nome corrisponde a un prefisso per l' ID media dell'annuncio trovato nel video stream. Ad esempio, potresti avere un ID elemento multimediale dell'annuncio simile al seguente:

google_1234567890

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

Dati delle risposte

Trasmettere in live streaming

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

InteractiveFile

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