View a markdown version of this page

Pre-ads Anfrage - AWS Elemental MediaTailor
Wenn es feuertInputAusgabe-Namespace zulässigTypische AnwendungsfälleVerhalten bei Ausfällen

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 Anfrage

Wenn es feuert

MediaTailor führt die Funktion aus, der PRE_ADS_REQUEST einmal pro Werbeunterbrechung zugeordnet ist, 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, plusavail.*, scte.*asset.*, und adsRequest.* (URL, Methode, Header, Text). Alle verfügbaren Felder finden Sie unterReferenz zum Eingabefeld.

Ausgabe-Namespace zulässig

Namespace Zulässige Typen Wie wird die Ausgabe verwendet
player_params.* Zeichenketten, Zahlen, Boolesche Werte Überschreibt die Session-Player-Parameter für diesen Werbeblock. 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 Werbeunterbrechung. Verfügbar für die ADS-Anforderungs-URL durch dynamische Variablenersetzung.
avail.* Zeichenketten, Zahlen, boolesche Werte Überschreibt die verfügbaren Variablen für diesen Werbeblock. Verfügbar für die ADS-Anforderungs-URL durch dynamische Variablenersetzung.
scte.* Zeichenketten, Zahlen, boolesche Werte Überschreibt SCTE-Variablen für diese Werbeunterbrechung. Verfügbar für die ADS-Anforderungs-URL durch dynamische Variablenersetzung.
asset.* Zeichenketten, Zahlen, boolesche Werte Überschreibt Asset-Metadatenvariablen (aus EXT-X-ASSET Tags) für diese Werbeunterbrechung. Verfügbar für die ADS-Anforderungs-URL durch dynamische Variablenersetzung. Weitere Informationen zu HLS-Anzeigenmarkern finden Sie unter HLS-Anzeigenmarkierungen.
adsRequest.* Zeichenfolge Überschreibt die ADS-Anfrage nur für diese Werbeunterbrechung. Unterstützte Felder:url,, methodheaders.<name>,body. Der url Wert wird als Vorlage behandelt und MediaTailor dynamische Anzeigenvariablen für ADS-Anfragen nach der Ausführung der Funktion unterstützt. Nicht beibehalten.
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 Werbeunterbrechung und werden nicht in der Sitzung gespeichert.

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 den aktuellen Werbeblock hinzugefügt.

Typische Anwendungsfälle

  • Schreiben Sie die URL der ADS-Anfrage neu, um den Traffic zu A/B Testzwecken zwischen verschiedenen Anzeigenservern weiterzuleiten.

  • Hängen Sie Anreicherungsdaten (Zielgruppensegmente, Identitätstoken) an die URL oder die Header der ADS-Anfrage an.

  • Ändern Sie die ADS-Anforderungsparameter unter bestimmten Bedingungen auf der Grundlage der SCTE-35 Signaldaten oder des Verfügbarkeitsindex.

Verhalten bei Ausfällen

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