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
<a name="monetization-functions-hooks-pre-ads"></a>

## Cuando se dispara
<a name="monetization-functions-hooks-pre-ads-when"></a>

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
<a name="monetization-functions-hooks-pre-ads-input"></a>

Todos los campos de`PRE_SESSION_INITIALIZATION`, más `avail.*``scte.*`, y `adsRequest.*` (url, método, encabezados, cuerpo). Para ver todos los campos disponibles, consulte[Referencia del campo de entrada](monetization-functions-hooks.md#monetization-functions-hooks-input-ref).

## Se permite el espacio de nombres de salida
<a name="monetization-functions-hooks-pre-ads-output"></a>


| 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](variables.md) 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](variables.md) 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
<a name="monetization-functions-hooks-pre-ads-use-cases"></a>
+ 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
<a name="monetization-functions-hooks-pre-ads-failure"></a>

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.