As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# INICIALIZAÇÃO DA PRÉ-SESSÃO
<a name="monetization-functions-hooks-pre-session"></a>

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

MediaTailor executa a função mapeada para `PRE_SESSION_INITIALIZATION` uma vez, no início de uma nova sessão de reprodução. A função é executada antes de MediaTailor construir a resposta inicial do manifesto.

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

`session.*`, `player_params.*` e `event.*`. Para ver todos os campos disponíveis, consulte[Referência do campo de entrada](monetization-functions-hooks.md#monetization-functions-hooks-input-ref).

## Namespace de saída permitido
<a name="monetization-functions-hooks-pre-session-output"></a>


| Namespace | Tipos aceitos | 
| --- | --- | 
| player\_params.\* | Cadeias de caracteres, números, booleanos | 

Os valores `player_params.*` gravados são mantidos na sessão. Eles estão disponíveis:
+ Como entrada no `PRE_ADS_REQUEST` ciclo de vida, gancho via `player_params.*`
+ No ADS, solicite URLs por meio de [MediaTailor variáveis dinâmicas de anúncios para solicitações de ADS](variables.md) (por exemplo,`[player_params.deviceType]`)
+ Durante toda a duração da sessão em todos os intervalos publicitários

**nota**  
O tamanho total serializado de todas as chaves e valores de `player_params` saída não deve exceder 1.000 caracteres. Se o total exceder esse limite, a saída da função será descartada. Para obter mais informações, consulte [Limites de funções](monetization-functions-limits.md).

## Caso de uso típico
<a name="monetization-functions-hooks-pre-session-use-cases"></a>
+ Obtenha dados de identidade ou público de um serviço externo e armazene-os nos parâmetros do player para uso em solicitações posteriores do ADS.
+ Classifique o tipo de dispositivo com base no agente do usuário e grave a classificação em um parâmetro do player.
+ Defina os valores padrão dos parâmetros do player nos quais o processamento posterior do anúncio depende.
+ Armazene valores nos parâmetros do player que estão incluídos no URL do ADS por meio de[MediaTailor variáveis dinâmicas de anúncios para solicitações de ADS](variables.md).

## Comportamento com falha
<a name="monetization-functions-hooks-pre-session-failure"></a>

Se uma função anexada `PRE_SESSION_INITIALIZATION` falhar por qualquer motivo, MediaTailor descarta a saída da função e procede como se nenhuma função estivesse anexada. A sessão começa normalmente sem os valores dos parâmetros do player da função.