View a markdown version of this page

PRE_ADS_REQUEST - AWS Elemental MediaTailor
Cuando se disparaInputSe permite el espacio de nombres de salidaCasos 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.

PRE_ADS_REQUEST

Cuando se dispara

MediaTailor ejecuta la función asignada a PRE_ADS_REQUEST una vez por pausa publicitaria, inmediatamente antes de enviar la solicitud al ADS. La función se ejecuta cada vez que se encuentra una oportunidad publicitaria durante el procesamiento del manifiesto.

Input

Todos los campos dePRE_SESSION_INITIALIZATION, más avail.*scte.*, y adsRequest.* (url, método, encabezados, cuerpo). 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
player_params.* Cadenas, números, valores booleanos Anula los parámetros del reproductor de sesión para esta pausa publicitaria. Disponible a través MediaTailor variables de anuncios dinámicos para solicitudes de ADS de la URL de solicitud de ADS.
session.* Cadenas, números, valores booleanos Anula las variables de sesión de esta pausa publicitaria. Disponible en la URL de solicitud de ADS mediante la sustitución dinámica de variables.
avail.* Cadenas, números, valores booleanos Anula las variables disponibles para esta pausa publicitaria. Disponible en la URL de solicitud de ADS mediante la sustitución dinámica de variables.
scte.* Cadenas, números, valores booleanos Anula las variables SCTE para esta pausa publicitaria. Disponible para la URL de solicitud de ADS mediante la sustitución dinámica de variables.
adsRequest.* Cadena Anula la solicitud de ADS únicamente para esta pausa publicitaria. Campos admitidos:url,, methodheaders.<name>,body. El url valor se trata como una plantilla y se admite una MediaTailor variables de anuncios dinámicos para solicitudes de ADS vez ejecutada la función. No persistió.
nota

Todos los resultados del PRE_ADS_REQUEST enlace son anulaciones transitorias: solo se aplican a la solicitud de ADS de la pausa publicitaria actual y no se conservan durante la sesión.

Ejemplo: reescribir la solicitud de ADS:

{
    "Output": {
        "adsRequest.url": "{%'https://ads.example.com/v1/vast?sid=' & session.id & '&genre=' & player_params.genre%}",
        "adsRequest.headers.X-Custom-Token": "{%player_params.auth_token%}"
    }
}

Esto sustituye a la URL de ADS y añade un encabezado personalizado para la pausa publicitaria actual.

Casos de uso típicos

  • Vuelva a escribir la URL de la solicitud de ADS para redirigir el tráfico entre diferentes servidores de anuncios para A/B realizar pruebas.

  • Añada datos de enriquecimiento (segmentos de audiencia, identificadores de identidad) a la URL o a los encabezados de la solicitud de ADS.

  • Modifique condicionalmente los parámetros de las solicitudes de ADS en función de los datos de la SCTE-35 señal o del índice de disponibilidad.

Comportamiento de error

Si una función asociada a PRE_ADS_REQUEST falla por cualquier motivo, MediaTailor descarta la salida de la función y procede como si no hubiera ninguna función asociada. La solicitud ADS se envía utilizando los parámetros originales de sesión y solicitud sin modificaciones.