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

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

Servicio: dai.google.com

La ruta de acceso del método stream es relativa a https://dai.google.com.

Método: transmisión

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 los siguientes parámetros:

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene un nuevo Stream. Para las transmisiones de píxeles contadores del servidor, este Stream solo contiene los campos stream_id y stream_manifest.

Open Measurement

El campo Verifications contiene información para la verificación de Open Measurement en transmisiones que no usan píxeles contadores del servidor. Verifications contiene uno o más elementos Verification que enumeran los recursos y los metadatos que necesitas para verificar la reproducción de las creatividades con el 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

Después de encontrar un identificador de contenido multimedia de anuncio durante la reproducción, realiza una solicitud de inmediato con el media_verification_url del extremo stream. media_verification_url es una ruta de acceso absoluta. Las solicitudes de verificación de contenido multimedia no son necesarias para las transmisiones de píxeles contadores del servidor, en las que el servidor inicia la verificación de contenido multimedia.

Las solicitudes al extremo media verification son idempotentes.

Solicitud HTTP

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

Cuerpo de la respuesta

media verification muestra las siguientes respuestas:

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

IDs de medios de anuncios (HLS)

Los identificadores de contenido multimedia del anuncio se codificarán en los metadatos de tiempo HLS con la clave TXXX, reservada para los fotogramas de "información de texto definida por el usuario". El contenido del fotograma no estará encriptado y siempre comenzará con el texto "google_".

Todo el contenido de texto del marco se debe agregar a la media_verification_url para cada solicitud de verificación de anuncios.

IDs de medios de anuncios (DASH)

Los identificadores de medios de anuncios se insertarán en el manifiesto a través del elemento EventStream de DASH.

Cada EventStream tendrá un URI de ID de esquema de urn:google:dai:2018. Contendrán eventos con el atributo messageData que contiene un ID de media de anuncio que comienza con “google_”. Todo el contenido del atributo messageData se debe agregar a media_verification_url para cada solicitud de verificación de anuncios.

Datos de respuesta

Transmisión

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

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