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á.

# SOLICITAÇÃO PRÉVIA DE ANÚNCIOS
<a name="monetization-functions-hooks-pre-ads"></a>

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

MediaTailor executa a função mapeada `PRE_ADS_REQUEST` uma vez por intervalo de anúncio, imediatamente antes de enviar a solicitação ao ADS. A função é executada sempre que uma oportunidade de anúncio é encontrada durante o processamento do manifesto.

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

Todos os campos de`PRE_SESSION_INITIALIZATION`, mais`avail.*`,`scte.*`, e `adsRequest.*` (url, método, cabeçalhos, corpo). 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-ads-output"></a>


| Namespace | Tipos aceitos | Como a saída é usada | 
| --- | --- | --- | 
| player\_params.\* | Cadeias de caracteres, números, booleanos | Substitui os parâmetros do player da sessão para esse intervalo publicitário. Disponível para o URL de solicitação do ADS por meio de[MediaTailor variáveis dinâmicas de anúncios para solicitações de ADS](variables.md). | 
| session.\* | Cadeias de caracteres, números, booleanos | Substitui as variáveis de sessão desse intervalo publicitário. Disponível para o URL de solicitação do ADS por meio da substituição dinâmica de variáveis. | 
| avail.\* | Cadeias de caracteres, números, booleanos | Substitui as variáveis disponíveis para esse intervalo publicitário. Disponível para o URL de solicitação do ADS por meio da substituição dinâmica de variáveis. | 
| scte.\* | Cadeias de caracteres, números, booleanos | Substitui as variáveis SCTE para esse intervalo de anúncio. Disponível para o URL de solicitação do ADS por meio da substituição dinâmica de variáveis. | 
| adsRequest.\* | String | Substitui a solicitação do ADS somente para esse intervalo publicitário. Campos suportados:url,method,headers.<name>,body. O url valor é tratado como um modelo e é suportado [MediaTailor variáveis dinâmicas de anúncios para solicitações de ADS](variables.md) após a execução da função. Não persistiu. | 

**nota**  
Todas as saídas do `PRE_ADS_REQUEST` gancho são substituições transitórias — elas se aplicam somente à solicitação de ADS do intervalo publicitário atual e não persistem na sessão.

**Exemplo — reescrever a solicitação do 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%}"
    }
}
```

Isso substitui o URL do ADS e adiciona um cabeçalho personalizado para o intervalo publicitário atual.

## Caso de uso típico
<a name="monetization-functions-hooks-pre-ads-use-cases"></a>
+ Reescreva o URL de solicitação do ADS para rotear o tráfego entre diferentes servidores de anúncios para A/B testes.
+ Anexe dados de enriquecimento (segmentos de público, tokens de identidade) ao URL ou aos cabeçalhos da solicitação do ADS.
+ Modifique condicionalmente os parâmetros de solicitação do ADS com base nos dados SCTE-35 do sinal ou no índice de disponibilidade.

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

Se uma função anexada `PRE_ADS_REQUEST` falhar por qualquer motivo, MediaTailor descarta a saída da função e procede como se nenhuma função estivesse anexada. A solicitação do ADS é enviada usando os parâmetros originais da sessão e da solicitação sem modificação.