View a markdown version of this page

Post-ads respuesta - AWS Elemental MediaTailor
Cuando se disparaInputSe permite el espacio de nombres de salida¿Qué es lo que este gancho no veCasos de uso típicosComportamiento de error

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Post-ads respuesta

Cuando se dispara

MediaTailor ejecuta la función asignada POST_ADS_RESPONSE después de recibir y analizar una respuesta del ADS, incluida la resolución de los redireccionamientos del contenedor VAST. La función ve los anuncios analizados antes de MediaTailor seleccionar los anuncios que desea insertar, por lo que los cambios que se hagan aquí influyen en los anuncios que ocuparán la pausa publicitaria.

Esta función se activa en todos los protocolos de streaming (HLS y DASH) y en todos los modos de reproducción (en directo, VOD y preroll). Por lo general, se activa una vez por pausa publicitaria. En el caso de las respuestas de ADS que cubren varias pausas publicitarias a la vez (como las respuestas de VMAP) y en las respuestas a anuncios precapturados, el enlace se activa cuando se MediaTailor procesa la respuesta y no aparece el espacio avail de nombres introducido. Utilízalo $exists(avail) para comprobar antes de acceder a los campos disponibles.

Input

event.*,session.*,adsRequest.*, yadsResponse.*, además, avail.* cuando la respuesta se refiere a una única pausa publicitaria. Para ver todos los campos disponibles, consulteReferencia del campo de entrada.

Se permite el espacio de nombres de salida

Namespace Tipos aceptados Cómo se usa la salida
adsResponse.ads Matriz de objetos publicitarios Sustituye la lista de anuncios analizada de esta respuesta. MediaTailor relaciona cada anuncio devuelto con los anuncios originales adId y procede a la selección de anuncios con la lista devuelta.
temp.* Cualquiera Datos temporales para transferir valores entre los pasos de un ejecutor. No ha persistido.

Vuelve a escribir la lista de anuncios modificada enadsResponse.ads. Puedes hacer lo siguiente:

  • Filtrar: devuelve un subconjunto de los anuncios originales. Los anuncios que omitas no se tienen en cuenta para su inserción, y el tiempo que hayan ocupado pasa a estar disponible para que otros anuncios los rellenen.

  • Reordenar: devuelve los anuncios en un orden diferente. El orden afecta a los anuncios que ocupan primero la pausa publicitaria.

  • Modificar: cambiar durationSecondsadSystem,adTitle,mediaFiles, o trackingEvents en un anuncio. Los anuncios que se muestran sin cambios conservan todos sus metadatos VAST originales.

  • Inyectar: añadir anuncios que no estaban en la respuesta original. Una nueva entrada debe incluir adIddurationSeconds, ymediaFiles. Los anuncios que se obtienen con una VAST_REQUEST función en la misma invocación del enlace son una excepción: basta con añadir un anuncio de este tipo por sus adId letras, ya que MediaTailor restaura todos los datos VAST analizados del anuncio. Para obtener más información, consulte Solicitud VAST.

importante

Utilice siempre un constructor de matrices JSonata o un sistema de coerción de matrices al filtrar. Una expresión de filtro, por ejemplo, adsResponse.ads[adSystem != 'BLOCKED'] produce un único objeto cuando coincide exactamente con un anuncio. No produce ningún valor cuando ningún anuncio coincide. En ese caso, se omite la clave de salida y el filtro no tiene ningún efecto. Envuelva la expresión entre corchetes o [] añada:

{
    "Output": {
        "adsResponse.ads": "{%adsResponse.ads[adSystem != 'BLOCKED'][]%}"
    }
}

Las siguientes reglas se aplican a la lista de anuncios devuelta:

  • Si dos entradas comparten unaadId, gana la primera.

  • Las entradas no válidas se rechazan de forma individual. Las entradas válidas de la misma salida siguen siendo válidas.

  • Si una entrada insertada adId choca con un anuncio de la respuesta de la ADS, el anuncio original se utiliza como base y los cambios de campo se aplican sobre él.

¿Qué es lo que este gancho no ve

Este gancho se ejecuta antes de la selección de anuncios, por lo que no ve los anuncios con los que se MediaTailor han publicado otras funciones más adelante ni puede determinar qué anuncios se van a insertar en última instancia, ya que las decisiones sobre el estado de transcodificación y el llenado se toman después. En el caso de los anuncios precapturados, el enlace se activa cuando MediaTailor procesa la propia respuesta de captura previa. En una pausa publicitaria posterior, los anuncios previamente capturados se fusionan después de que se publique el gancho, por lo que el gancho no los ve allí. Para actuar sobre el conjunto de anuncios final, usa. PRE_MANIFEST_INSERTION

Casos de uso típicos

  • Filtra los anuncios por metadatos, por ejemplo, eliminándolos de los sistemas de anuncios de la competencia para que no aparezcan en la misma pausa publicitaria (separación competitiva).

  • Busca anuncios adicionales de un servidor de anuncios secundario con una VAST_REQUEST función cuando la respuesta principal sea corta y agrégalos a la lista de anuncios.

  • Reordena los anuncios para que los anuncios preferidos ocupen primero la pausa publicitaria.

  • Modifica los eventos de seguimiento o los metadatos de los anuncios antes de insertarlos.

Comportamiento de error

Si una función adjunta POST_ADS_RESPONSE falla por cualquier motivo (por ejemplo, porque se ha agotado el tiempo de espera, un error de expresión o un resultado no válido), MediaTailor descarta el resultado de la función. La solicitud continúa con la respuesta ADS original, como si no se hubiera adjuntado ninguna función. Si la entrada serializada supera el límite de tamaño de entrada, MediaTailor omite por completo la invocación del enlace. Para conocer los límites aplicables, consulte. Límites