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.

# INICIALIZACIÓN PREVIA A LA SESIÓN
<a name="monetization-functions-hooks-pre-session"></a>

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

MediaTailor ejecuta la función asignada `PRE_SESSION_INITIALIZATION` una vez, al inicio de una nueva sesión de reproducción. La función se ejecuta antes de MediaTailor construir la respuesta manifiesta inicial.

## Input
<a name="monetization-functions-hooks-pre-session-input"></a>

`session.*`, `player_params.*` y `event.*`. 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-session-output"></a>


| Namespace | Tipos aceptados | 
| --- | --- | 
| player\_params.\* | Cadenas, números, valores booleanos | 

Los valores en los que `player_params.*` se escribe se conservan en la sesión. Están disponibles:
+ Como entrada al `PRE_ADS_REQUEST` ciclo de vida, enganche a través de `player_params.*`
+ En ADS, solicite las URL a través de [MediaTailor variables de anuncios dinámicos para solicitudes de ADS](variables.md) (por ejemplo,`[player_params.deviceType]`)
+ Durante toda la sesión y en todas las pausas publicitarias

**nota**  
El tamaño total serializado de todas las claves y valores de `player_params` salida no debe superar los 1000 caracteres. Si el total supera este límite, se descarta la salida de la función. Para obtener más información, consulte [Límites de funciones](monetization-functions-limits.md).

## Casos de uso típicos
<a name="monetization-functions-hooks-pre-session-use-cases"></a>
+ Obtenga datos de identidad o audiencia de un servicio externo y guárdelos en los parámetros del reproductor para usarlos en solicitudes de ADS posteriores.
+ Clasifique el tipo de dispositivo en función del agente de usuario y escriba la clasificación en un parámetro del reproductor.
+ Defina los valores de los parámetros del reproductor predeterminados en los que se basa el procesamiento posterior y de pausa.
+ Guarde los valores en los parámetros del reproductor que se incluyen en la URL de ADS mediante[MediaTailor variables de anuncios dinámicos para solicitudes de ADS](variables.md).

## Comportamiento de error
<a name="monetization-functions-hooks-pre-session-failure"></a>

Si una función asociada `PRE_SESSION_INITIALIZATION` falla por cualquier motivo, MediaTailor descarta el resultado de la función y procede como si no hubiera ninguna función asociada. La sesión comienza normalmente sin los valores de los parámetros del reproductor de la función.