API lineal de inserción de anuncios dinámicos

La API de inserción de anuncios dinámicos te permite solicitar DAI y hacerle un seguimiento lineales (EN VIVO).

Servicio: dai.google.com

Todos los URI que aparecen a continuación están relacionados con https://dai.google.com

Método: stream

Solicitud HTTP

POST https://dai.google.com/linear/v1/hls/event/{assetKey}/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

La API de DAI contiene información para la verificación de Open Measurement en el Verifications. Este campo contiene uno o más Elementos Verification que enumeran los recursos y metadatos necesarios para la ejecución código de medición de terceros para verificar la reproducción de creatividades. Solo JavaScriptResource es compatible. Para obtener más información, consulta la IAB Tech Lab y el Especificaciones de VAST 4.1.

Método: verificación de contenido multimedia

Después de encontrar un identificador de contenido multimedia de anuncios durante la reproducción, crea una solicitud con la media_verification_url que se obtuvo de la transmisión extremo, como se muestra más arriba. Estas solicitudes no son necesarias para el contador de píxeles del servidor de transmisión, donde el servidor inicia la verificación de medios.

Las solicitudes al extremo media verification son idempotentes.

Solicitud HTTP

GET https://{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 usando la clave TXXX, reservado para "información de texto definida por el usuario" o los fotogramas. El el contenido del marco no se encriptará y siempre comenzará con el texto "google_"

Todo el contenido de texto del marco se debe agregar a la verificación de anuncios URL antes de realizar cada solicitud de verificación de anuncio.

Método: metadata

El extremo de metadatos en metadata_url muestra información usada para crear un anuncio de la IU de Google. El extremo de metadatos no está disponible para transmisiones de balizas del servidor en el que el servidor es responsable de iniciar la verificación de medios del anuncio.

Solicitud HTTP

GET https://{metadata_url}/{ad-media-id}

GET https://{metadata_url}

Cuerpo de la respuesta

Si no hay errores, la respuesta muestra una instancia de PodMetadata

Trabaja con metadatos

Los metadatos tienen tres secciones discretas: tags, ads y el anuncio breaks. Entrada los datos es la sección tags. A partir de ahí, itera las etiquetas. y busca la primera entrada cuyo nombre sea un prefijo para el ID de contenido multimedia del anuncio que se encuentra en la transmisión de video por Internet. Por ejemplo, podría tener un ID de medios de anuncios similar a este:

google_1234567890

Luego, encuentras un objeto de etiqueta llamado google_12345. En este caso, coincide con tu ID de medios de anuncios Una vez que encuentres el objeto del prefijo de medios de anuncios correcto, podrás buscar los IDs de anuncios, los de pausas publicitarias y el tipo de evento. Luego, los IDs de anuncios se usan para indexar Los objetos ads y los IDs de pausas publicitarias se usan para indexar los objetos breaks.

Datos de respuesta

Transmitir

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

Anuncio

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

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