API de metadatos de anuncios del programa en vivo de Brightcove

Introducción

El esquema de metadatos de anuncios (ad_server_data) admite una sintaxis JSON plana sin elementos anidados (solo pares clave-valor). Los datos del servidor de anuncios establecidos a través de la API se utilizan para todas las pausas publicitarias recibidas después de la actualización hasta que los datos se sobrescriben o se restablecen. Los clientes pueden actualizar y / o restablecer los datos en cualquier momento durante su transmisión en vivo.

Estos metadatos no persisten entre activaciones de Steam. Los metadatos de anuncios que deben persistir entre las activaciones de transmisiones deben establecerse en la configuración de anuncios de la aplicación SSAI. El conjunto de datos a través de la API se puede configurar para su uso como macros en el servidor de anuncios y el reemplazo de balizas del lado del servidor.

Los metadatos del programa publicitario se envían al sistema SSAI a través de etiquetas de lista de reproducción personalizadas y siguen la precedencia del parámetro dinámico de anuncios (DAP) existente en el sistema SSAI. Los datos del servidor de anuncios enviados en un punto de referencia tienen prioridad sobre los metadatos asignados al trabajo. Si se producen colisiones de claves entre los datos de los puntos de referencia y los metadatos del anuncio en el trabajo, los valores de los puntos de referencia se consideran de mayor prioridad y se utilizan en la colección fusionada.

Los metadatos de anuncios proporcionados en un punto de referencia solo se utilizan para ese punto de referencia y no persisten para las inserciones de puntos de referencia posteriores. Solo los metadatos de anuncios establecidos a través de la API de metadatos de anuncios del programa persistirán para todas las pausas publicitarias recibidas posteriormente hasta que se actualicen o restablezcan.

Puntos finales

Para obtener detalles completos de los puntos finales, consulte la Referencia de API en vivo.

Agregar / actualizar

Para agregar o actualizar metadatos de anuncios de programas en vivo, envíe un POST solicitud de:

https://api.bcovlive.io/v1/jobs/{job_id}/cuepointdata

{
  "ad_server_data": {
  	"one":"won",
  	"two":2,
  	"three":false
  }
}

Borrar

Para eliminar metadatos de anuncios de programas en vivo, envíe un DELETE solicitud de:

https://api.bcovlive.io/v1/jobs/{job_id}/cuepointdata