Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

## Wenn es feuert
<a name="monetization-functions-hooks-pre-ads-when"></a>

MediaTailor führt die zugeordnete Funktion `PRE_ADS_REQUEST` einmal pro Werbeunterbrechung aus, unmittelbar bevor die Anfrage an das ADS gesendet wird. Die Funktion wird jedes Mal ausgeführt, wenn während der Manifestverarbeitung auf eine Werbechance gestoßen wird.

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

Alle Felder von`PRE_SESSION_INITIALIZATION`, plus `avail.*``scte.*`, und `adsRequest.*` (URL, Methode, Kopfzeilen, Hauptteil). Informationen zu allen verfügbaren Feldern finden Sie unter[Referenz zum Eingabefeld](monetization-functions-hooks.md#monetization-functions-hooks-input-ref).

## Ausgabe-Namespace zulässig
<a name="monetization-functions-hooks-pre-ads-output"></a>


| Namespace | Zulässige Typen | Wie wird die Ausgabe verwendet | 
| --- | --- | --- | 
| player\_params.\* | Zeichenketten, Zahlen, Boolesche Werte | Setzt die Session-Player-Parameter für diese Werbepause außer Kraft. Verfügbar für die ADS-Anforderungs-URL über[MediaTailor dynamische Anzeigenvariablen für ADS-Anfragen](variables.md). | 
| session.\* | Zeichenketten, Zahlen, Boolesche Werte | Überschreibt die Sitzungsvariablen für diese Werbepause. Verfügbar für die ADS-Anforderungs-URL durch dynamische Variablenersetzung. | 
| avail.\* | Zeichenketten, Zahlen, Boolesche Werte | Überschreibt verfügbare Variablen für diesen Werbeblock. Verfügbar für die ADS-Anforderungs-URL durch dynamische Variablenersetzung. | 
| scte.\* | Zeichenketten, Zahlen, Boolesche Werte | Überschreibt die SCTE-Variablen für diesen Werbeblock. Verfügbar für die ADS-Anforderungs-URL durch dynamische Variablenersetzung. | 
| adsRequest.\* | Zeichenfolge | Überschreibt die ADS-Anfrage nur für diesen Werbeblock. Unterstützte Felder:url,, methodheaders.<name>,body. Der url Wert wird als Vorlage behandelt und unterstützt, [MediaTailor dynamische Anzeigenvariablen für ADS-Anfragen](variables.md) nachdem die Funktion ausgeführt wurde. Nicht persistiert. | 

**Anmerkung**  
Bei allen Ausgaben des `PRE_ADS_REQUEST` Hooks handelt es sich um vorübergehende Überschreibungen. Sie gelten nur für die ADS-Anfrage der aktuellen Werbepause und werden nicht für die Sitzung beibehalten.

**Beispiel — Umschreiben der ADS-Anfrage:**

```
{
    "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%}"
    }
}
```

Dadurch wird die ADS-URL ersetzt und ein benutzerdefinierter Header für die aktuelle Werbepause hinzugefügt.

## Typische Anwendungsfälle
<a name="monetization-functions-hooks-pre-ads-use-cases"></a>
+ Schreiben Sie die URL der ADS-Anfrage neu, um den Traffic zwischen verschiedenen Anzeigenservern zu A/B Testzwecken weiterzuleiten.
+ Hängen Sie Anreicherungsdaten (Zielgruppensegmente, Identitätstoken) an die URL oder die Header der ADS-Anfrage an.
+ Ändern Sie die ADS-Anforderungsparameter bedingt auf der Grundlage von SCTE-35 Signaldaten oder Verfügbarkeitsindex.

## Verhalten bei Fehlern
<a name="monetization-functions-hooks-pre-ads-failure"></a>

Wenn eine an angehängte Funktion aus irgendeinem Grund `PRE_ADS_REQUEST` fehlschlägt, wird die Ausgabe der MediaTailor Funktion verworfen und der Vorgang wird so fortgesetzt, als ob keine Funktion angehängt wäre. Die ADS-Anfrage wird unter Verwendung der ursprünglichen Sitzungs- und Anforderungsparameter ohne Änderung gesendet.