View a markdown version of this page

Pre-ads solicitud - 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 solicitud

Cuando se dispara

MediaTailor ejecuta la función asignada 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 de PRE_SESSION_INITIALIZATIONavail.*, más scte.*asset.*, 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 la solicitud de ADS.
session.* Cadenas, números, valores booleanos Anula las variables de sesión para esta pausa publicitaria. Está disponible para la URL de solicitud de ADS mediante la sustitución dinámica de variables.
avail.* Cadenas, números y valores booleanos Anula las variables disponibles para esta pausa publicitaria. Está disponible para la URL de solicitud de ADS mediante la sustitución dinámica de variables.
scte.* Cadenas, números y valores booleanos Anula las variables SCTE para esta pausa publicitaria. Está disponible para la URL de solicitud de ADS mediante la sustitución dinámica de variables.
asset.* Cadenas, números y valores booleanos Anula las variables de metadatos de los activos (de las EXT-X-ASSET etiquetas) para esta pausa publicitaria. Está disponible para la URL de solicitud de ADS mediante la sustitución dinámica de variables. Para obtener más información sobre los marcadores de anuncios HLS, consulte los marcadores de anuncios HLS.
adsRequest.* Cadena Solo anula la solicitud de ADS para esta pausa publicitaria. Campos compatibles: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 que se ejecuta la función. No ha persistido.
nota

Todos los resultados del PRE_ADS_REQUEST enlace son anulaciones transitorias, es decir, se aplican únicamente a la solicitud de ADS de la pausa publicitaria actual y no persisten 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 reemplaza la URL del 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ñade datos de enriquecimiento (segmentos de audiencia, tokens de identidad) a la URL o a los encabezados de la solicitud de ADS.

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

Comportamiento de error

Si una función adjunta PRE_ADS_REQUEST falla por cualquier motivo, MediaTailor descarta el resultado de la función y continúa como si no hubiera ninguna función adjunta. La solicitud ADS se envía con los parámetros de sesión y solicitud originales sin modificaciones.