Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# PRE\_ADS\_REQUEST
<a name="monetization-functions-hooks-pre-ads"></a>

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

MediaTailor esegue la funzione mappata `PRE_ADS_REQUEST` una volta per interruzione pubblicitaria, immediatamente prima di inviare la richiesta all'ADS. La funzione viene eseguita ogni volta che viene rilevata un'opportunità pubblicitaria durante l'elaborazione del manifesto.

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

Tutti i campi di `PRE_SESSION_INITIALIZATION` `avail.*``scte.*`, plus e `adsRequest.*` (url, method, headers, body). Per tutti i campi disponibili, vedi[Riferimento al campo di input](monetization-functions-hooks.md#monetization-functions-hooks-input-ref).

## Namespace di output consentito
<a name="monetization-functions-hooks-pre-ads-output"></a>


| Namespace | Tipi accettati | Come viene utilizzato l'output | 
| --- | --- | --- | 
| player\_params.\* | Stringhe, numeri, valori booleani | Sostituisce i parametri del player di sessione per questa interruzione pubblicitaria. Disponibile per l'URL della richiesta ADS tramite. [MediaTailor variabili pubblicitarie dinamiche per le richieste ADS](variables.md) | 
| session.\* | Stringhe, numeri, valori booleani | Sostituisce le variabili di sessione per questa interruzione pubblicitaria. Disponibile per l'URL della richiesta ADS tramite la sostituzione dinamica delle variabili. | 
| avail.\* | Stringhe, numeri, valori booleani | Sostituisce le variabili di utilizzo per questa interruzione pubblicitaria. Disponibile per l'URL della richiesta ADS tramite la sostituzione dinamica delle variabili. | 
| scte.\* | Stringhe, numeri, valori booleani | Sostituisce le variabili SCTE per questa interruzione pubblicitaria. Disponibile per l'URL della richiesta ADS tramite la sostituzione dinamica delle variabili. | 
| adsRequest.\* | Stringa | Sostituisce la richiesta ADS solo per questa interruzione pubblicitaria. Campi supportati:url,,method,headers.<name>. body Il url valore viene trattato come un modello e viene supportato [MediaTailor variabili pubblicitarie dinamiche per le richieste ADS](variables.md) dopo l'esecuzione della funzione. Non persistente. | 

**Nota**  
Tutti gli output dell'`PRE_ADS_REQUEST`hook sono sostituzioni temporanee: si applicano solo alla richiesta ADS dell'interruzione pubblicitaria corrente e non vengono mantenute nella sessione.

**Esempio: riscrittura della richiesta 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%}"
    }
}
```

Questo sostituisce l'URL ADS e aggiunge un'intestazione personalizzata per l'interruzione pubblicitaria corrente.

## Casi d'uso tipici
<a name="monetization-functions-hooks-pre-ads-use-cases"></a>
+ Riscrivi l'URL della richiesta ADS per instradare il traffico tra diversi server pubblicitari a scopo di A/B test.
+ Aggiungi dati di arricchimento (segmenti di pubblico, token di identità) all'URL o alle intestazioni della richiesta ADS.
+ Modifica in modo condizionale i parametri della richiesta ADS in base ai dati del segnale o all'indice di disponibilità SCTE-35 .

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

Se una funzione collegata a `PRE_ADS_REQUEST` fallisce per qualsiasi motivo, MediaTailor scarta l'output della funzione e procede come se non fosse collegata alcuna funzione. La richiesta ADS viene inviata utilizzando i parametri della sessione e della richiesta originali senza modifiche.