API Dynamic Ad Insert VOD

Com a API Dynamic Ad Insert, é possível solicitar e rastrear a DAI em transmissões ao vivo de vídeo on demand (VOD). Há suporte para streams HLS e DASH.

Serviço: dai.google.com

O caminho do método stream é relativo a https://dai.google.com.

Método: stream

Solicitação HTTP

POST https://dai.google.com/ondemand/v1/hls/content/{content-source}/vid/{video-id}/stream

POST https://dai.google.com/ondemand/v1/dash/content/{content-source}/vid/{video-id}/stream

Cabeçalho da solicitação

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

Parâmetros de caminho

Corpo da solicitação

O corpo da solicitação é do tipo application/x-www-form-urlencoded e contém a parâmetros a seguir:

Corpo da resposta

Se bem-sucedido, o corpo da resposta conterá uma nova Stream Para streams de beacon do lado do servidor, este Stream contém apenas os campos stream_id e stream_manifest.

Open Measurement

O campo Verifications contém informações para Open Verificação de medição para fluxos de beacon que não são do servidor. Verifications contém um ou mais elementos Verification que listam os recursos e os metadados necessários para verificar a reprodução de criativos com o código de medição de terceiros. Só há suporte para JavaScriptResource. Para mais informações, consulte o IAB Tech Lab e a especificação VAST 4.1.

Método: verificação de mídia

Depois de encontrar um identificador de mídia do anúncio durante a reprodução, faça uma solicitação usando o media_verification_url do stream endpoint do Google Cloud. O media_verification_url é um caminho absoluto. As solicitações de verificação de mídia não são necessárias para fluxos de beacon do servidor. em que o servidor inicia a verificação de mídia.

As solicitações para o endpoint media verification são idempotentes.

Solicitação HTTP

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

Corpo da resposta

media verification retorna as seguintes respostas:

• HTTP/1.1 204 No Content se a verificação de mídia for bem-sucedida e todos os pings forem enviados.
• HTTP/1.1 404 Not Found se a solicitação não puder verificar a mídia devido à formatação ou à expiração incorreta do URL.
• HTTP/1.1 404 Not Found se uma solicitação de verificação anterior para esse ID tiver sido bem-sucedida.
• HTTP/1.1 409 Conflict se outra solicitação já estiver enviando pings no momento.

IDs de mídia do anúncio (HLS)

Os identificadores de mídia do anúncio serão codificados em metadados com marcação de tempo HLS usando a chave TXXX, reservado para "informações de texto definidas pelo usuário" frames. O conteúdo do frame não será criptografado e sempre começará com o texto "google_".

Todo o conteúdo de texto do frame deve ser anexado ao media_verification_url para cada solicitação de verificação de anúncio.

IDs de mídia do anúncio (DASH)

Os identificadores de mídia do anúncio serão inseridos no manifesto usando o uso de: Elemento EventStream do DASH.

Cada EventStream terá um URI de ID de esquema de urn:google:dai:2018. Eles vão conter eventos com o atributo messageData que contém um ID da mídia do anúncio que começa com “google_”. Todo o conteúdo de messageData deve ser anexado ao media_verification_url de cada anúncio solicitação de verificação.

Dados de resposta

Stream

{
  "stream_id": string,
  "total_duration": number,
  "content_duration": number,
  "valid_for": string,
  "valid_until": string,
  "subtitles": [object(Subtitle)],
  "hls_master_playlist": string,
  "stream_manifest": string,
  "media_verification_url": string,
  "apple_tv": object(AppleTV),
  "ad_breaks": [object(AdBreak)],
}

AppleTV

{
  "interstitials_url": string,
}

AdBreak

{
  "type": string,
  "start": number,
  "duration": number,
  "ads": [object(Ad)],
}

Anúncio

{
  "seq": number,
  "start": 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,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "events": [object(Event)],
  "verifications": [object(Verification)],
  "universal_ad_id": object(UniversalAdID),
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
  "skip_metadata": object(SkipMetadata),
}

Evento

{
  "time": number,
  "type": string,
}

Legenda

{
  "language": string,
  "language_name": string,
  "ttml": string,
  "webvtt": string,
}

SkipMetadata

{
  "offset": number,
  "tracking_url": string,
}

Ícone

{
  "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ção

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

Complementar

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