

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\_SESSION\_INITIALIZATION
<a name="monetization-functions-hooks-pre-session"></a>

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

MediaTailor führt die zugeordnete Funktion `PRE_SESSION_INITIALIZATION` einmal zu Beginn einer neuen Wiedergabesitzung aus. Die Funktion wird ausgeführt, bevor die erste MediaTailor Manifestantwort erstellt wird.

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

`session.*`, `player_params.*` und `event.*`. Alle verfügbaren Felder 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-session-output"></a>


| Namespace | Zulässige Typen | 
| --- | --- | 
| player\_params.\* | Zeichenketten, Zahlen, Boolesche Werte | 

Werte, in die geschrieben wurde, `player_params.*` werden in der Sitzung gespeichert. Sie sind verfügbar:
+ Als Eingabe beim `PRE_ADS_REQUEST` Lifecycle-Hook über `player_params.*`
+ In ADS fordern Sie URLs an über [MediaTailor dynamische Anzeigenvariablen für ADS-Anfragen](variables.md) (zum Beispiel`[player_params.deviceType]`)
+ Für die gesamte Dauer der Sitzung für alle Werbeunterbrechungen

**Anmerkung**  
Die Gesamtgröße aller `player_params` Ausgabeschlüssel und Werte in serialisierter Form darf 1.000 Zeichen nicht überschreiten. Wenn die Summe diesen Grenzwert überschreitet, wird die Funktionsausgabe verworfen. Weitere Informationen finden Sie unter [Grenzwerte für Funktionen](monetization-functions-limits.md).

## Typische Anwendungsfälle
<a name="monetization-functions-hooks-pre-session-use-cases"></a>
+ Ruft Identitäts- oder Zielgruppendaten von einem externen Dienst ab und speichert sie in Player-Parametern, um sie in späteren ADS-Anfragen zu verwenden.
+ Klassifizieren Sie den Gerätetyp anhand des Benutzeragenten und schreiben Sie die Klassifizierung in einen Player-Parameter.
+ Legen Sie Standardwerte für Player-Parameter fest, auf die sich die nachfolgende Verarbeitung von Werbeunterbrechungen stützt.
+ Speichern Sie Werte in Player-Parametern, die über in der ADS-URL enthalten sind[MediaTailor dynamische Anzeigenvariablen für ADS-Anfragen](variables.md).

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

Wenn eine an angehängte Funktion aus irgendeinem Grund `PRE_SESSION_INITIALIZATION` fehlschlägt, wird die Ausgabe der MediaTailor Funktion verworfen und der Vorgang wird so fortgesetzt, als ob keine Funktion angehängt wäre. Die Sitzung startet normal ohne die Player-Parameterwerte der Funktion.