View a markdown version of this page

PRE_ADS_REQUEST - AWS Elemental MediaTailor
Wenn es feuertInputAusgabe-Namespace zulässigTypische AnwendungsfälleVerhalten bei Fehlern

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

Wenn es feuert

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

Alle Felder vonPRE_SESSION_INITIALIZATION, plus avail.*scte.*, und adsRequest.* (URL, Methode, Kopfzeilen, Hauptteil). Informationen zu allen verfügbaren Feldern finden Sie unterReferenz zum Eingabefeld.

Ausgabe-Namespace zulässig

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 überMediaTailor dynamische Anzeigenvariablen für ADS-Anfragen.
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 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

  • 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

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.