API de VOD de inserción de anuncios dinámicos

La API de inserción de anuncios dinámicos te permite solicitar DAI y hacerle un seguimiento transmisiones de video on demand (VOD). Se admiten las transmisiones HLS y DASH.

Servicio: dai.google.com

La ruta del método stream está relacionada con https://dai.google.com

Método: stream

Solicitud 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

Encabezado de la solicitud

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

Parámetros de ruta

Cuerpo de la solicitud

El cuerpo de la solicitud es de tipo application/x-www-form-urlencoded y contiene la siguiente información: los siguientes parámetros:

Cuerpo de la respuesta

Si el proceso es satisfactorio, el cuerpo de la respuesta contiene un nuevo Stream Para las transmisiones de píxeles contadores del servidor, esta Stream Contiene solo los campos stream_id y stream_manifest.

Open Measurement

El campo Verifications contiene información para abrir Verificación de mediciones para transmisiones que no son de balizas del servidor. Verifications contiene uno o más elementos Verification que enumeran los recursos y metadatos que necesita para verificar la reproducción de creatividades con un código de medición de terceros. Solo se admite JavaScriptResource. Para obtener más información, consulta IAB Tech Lab. y la especificación de VAST 4.1.

Método: verificación de contenido multimedia

Cuando encuentres un identificador de contenido multimedia durante la reproducción, crea una solicitud con el media_verification_url de stream extremo. media_verification_url es una ruta de acceso absoluta. Las solicitudes de verificación de medios no son necesarias para las transmisiones con balizas del servidor donde el servidor inicia la verificación de medios.

Las solicitudes al extremo media verification son idempotentes.

Solicitud HTTP

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

Cuerpo de la respuesta

media verification devuelve las siguientes respuestas:

• Es HTTP/1.1 204 No Content si la verificación de medios se realiza correctamente y se envían todos los pings.
• Se utiliza HTTP/1.1 404 Not Found si la solicitud no puede verificar el contenido multimedia debido a un vencimiento o formato de URL incorrectos.
• HTTP/1.1 404 Not Found si se realiza correctamente una solicitud de verificación anterior para este ID.
• Es HTTP/1.1 409 Conflict si otra solicitud ya está enviando pings en este momento.

IDs de medios de anuncios (HLS)

Los identificadores multimedia de anuncios se codificarán en metadatos temporizados de HLS con la clave TXXX. reservados para "información de texto definida por el usuario" o los fotogramas. El contenido del marco no estarán encriptadas y siempre comenzará con el texto "google_".

Todo el contenido de texto del marco se debe anexar al media_verification_url para cada solicitud de verificación de anuncio.

ID de medios del anuncio (DASH)

Los identificadores multimedia del anuncio se insertarán en el manifiesto mediante Elemento EventStream de DASH.

Cada EventStream tendrá un URI de ID de esquema de urn:google:dai:2018. Incluirán eventos con el atributo messageData que contienen un ID de medios del anuncio que comienza con “google_” Todo el contenido de messageData debe agregarse a la media_verification_url de cada anuncio solicitud de verificación.

Datos de respuesta

Transmitir

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

Anuncio

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

Subtítulo

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

SkipMetadata

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

Ícono

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

Verificación

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