View a markdown version of this page

Post-ads Antwort - AWS Elemental MediaTailor
Wenn es feuertInputAusgabe-Namespace zulässigWas dieser Hook nicht siehtTypische 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.

Post-ads Antwort

Wenn es feuert

MediaTailor führt die zugeordnete Funktion aus, POST_ADS_RESPONSE nachdem sie eine Antwort vom ADS empfangen und analysiert hat, einschließlich der Auflösung von VAST-Wrapper-Weiterleitungen. Die Funktion sieht die geparsten Anzeigen, bevor sie die einzufügenden Anzeigen MediaTailor auswählt. Die hier vorgenommenen Änderungen wirken sich also darauf aus, welche Anzeigen die Werbeunterbrechung füllen.

Der Hook wird für alle Streaming-Protokolle (HLS und DASH) und alle Wiedergabemodi (Live, VOD und Pre-Roll) ausgelöst. Er wird in der Regel einmal pro Werbepause ausgelöst. Bei ADS-Antworten, die mehrere Werbeunterbrechungen gleichzeitig abdecken (z. B. VMAP-Antworten), und bei vorab abgerufenen Anzeigenantworten wird der Hook ausgelöst, wenn die Antwort MediaTailor verarbeitet wird, und der avail eingegebene Namespace ist nicht vorhanden. Wird zur Überprüfung verwendet$exists(avail), bevor auf verfügbare Felder zugegriffen wird.

Input

event.*,session.*, undadsRequest.*, plusadsResponse.*, avail.* wenn sich die Antwort auf eine einzelne Werbeunterbrechung bezieht. Alle verfügbaren Felder finden Sie unterReferenz zum Eingabefeld.

Ausgabe-Namespace zulässig

Namespace Zulässige Typen Wie wird die Ausgabe verwendet
adsResponse.ads Reihe von Werbeobjekten Ersetzt die analysierte Anzeigenliste für diese Antwort. MediaTailor ordnet jede zurückgegebene Anzeige den ursprünglichen Anzeigen von zu adId und fährt mit der zurückgegebenen Liste zur Anzeigenauswahl fort.
temp.* Beliebig Temporäre Daten für die Übergabe von Werten zwischen Schritten in einem Executor. Nicht persistent.

Schreiben Sie die geänderte Anzeigenliste zurück zuadsResponse.ads. Sie können:

  • Filter — gibt eine Teilmenge der ursprünglichen Anzeigen zurück. Anzeigen, die Sie auslassen, werden für die Schaltung nicht berücksichtigt, und die Dauer, für die sie genutzt wurden, wird für andere Anzeigen verfügbar.

  • Neu anordnen — Die Anzeigen werden in einer anderen Reihenfolge zurückgegeben. Die Reihenfolge bestimmt, welche Anzeigen die Werbeunterbrechung zuerst ausfüllen.

  • Ändern — Ändern Sie durationSecondsadSystem, adTitlemediaFiles, oder trackingEvents an einer Anzeige. Unverändert zurückgegebene Anzeigen behalten alle ihre ursprünglichen VAST-Metadaten bei.

  • Einfügen — fügt Anzeigen hinzu, die nicht in der ursprünglichen Antwort enthalten waren. Ein neuer Eintrag muss adIddurationSeconds, und mediaFiles enthalten. Eine Ausnahme bilden Anzeigen, die mit einer VAST_REQUEST Funktion innerhalb desselben Hook-Aufrufs abgerufen werden. Das Anhängen einer solchen Anzeige um ihre Zahl adId ist ausreichend, da die vollständigen analysierten VAST-Daten der Anzeige MediaTailor wiederhergestellt werden. Weitere Informationen finden Sie unter RIESIGE Anfrage.

Wichtig

Verwenden Sie beim Filtern immer einen JSONata-Array-Konstruktor oder einen Array-Zwang. Ein Filterausdruck wie beispielsweise adsResponse.ads[adSystem != 'BLOCKED'] erzeugt ein einzelnes Objekt, wenn genau eine Anzeige übereinstimmt. Es erzeugt überhaupt keinen Wert, wenn keine Anzeigen übereinstimmen. In diesem Fall wird der Ausgabeschlüssel weggelassen und der Filter hat keine Wirkung. Setzen Sie den Ausdruck in Klammern oder fügen [] Sie Folgendes an:

{
    "Output": {
        "adsResponse.ads": "{%adsResponse.ads[adSystem != 'BLOCKED'][]%}"
    }
}

Die folgenden Regeln gelten für die zurückgegebene Anzeigenliste:

  • Wenn sich zwei Einträge eine teilenadId, gewinnt der erste Eintrag.

  • Ungültige Einträge werden einzeln zurückgewiesen. Gültige Einträge in derselben Ausgabe gelten weiterhin.

  • Wenn ein eingefügter Eintrag mit einer Anzeige aus der ADS-Antwort adId kollidiert, wird die ursprüngliche Anzeige als Grundlage verwendet und Ihre Feldänderungen werden darüber hinaus angewendet.

Was dieser Hook nicht sieht

Dieser Hook wird vor der Anzeigenauswahl ausgeführt, sodass er keine Anzeigen sieht, die später von anderen MediaTailor Funktionen bereitgestellt werden, und er kann nicht bestimmen, welche Anzeigen letztendlich eingefügt werden, da die Entscheidung über den Transkodierungsstatus und die Füllung erst im Nachhinein getroffen wird. Bei Prefetch-Anzeigen wird der Hook ausgelöst, wenn die Prefetch-Antwort selbst MediaTailor verarbeitet wird. Bei einer späteren Werbeunterbrechung werden die zuvor vorab abgerufenen Anzeigen zusammengeführt, nachdem dieser Hook ausgeführt wurde, sodass der Hook sie dort nicht sieht. Um auf das endgültige Anzeigenset zu reagieren, verwenden Sie. PRE_MANIFEST_INSERTION

Typische Anwendungsfälle

  • Filtern Sie Anzeigen nach Metadaten, z. B. indem Sie Anzeigen aus konkurrierenden Anzeigensystemen entfernen, sodass sie nicht in derselben Werbeunterbrechung erscheinen (Trennung von Wettbewerbern).

  • Rufen Sie zusätzliche Anzeigen von einem sekundären Anzeigenserver mit einer VAST_REQUEST Funktion ab, wenn die primäre Antwort kurz ist, und hängen Sie sie an die Anzeigenliste an.

  • Ordnen Sie Anzeigen neu an, sodass bevorzugte Anzeigen zuerst die Werbeunterbrechung füllen.

  • Ändern Sie Tracking-Ereignisse oder Anzeigenmetadaten vor der Schaltung.

Verhalten bei Fehlern

Wenn eine an angehängte Funktion aus irgendeinem Grund POST_ADS_RESPONSE fehlschlägt, z. B. aufgrund eines Timeouts, eines Ausdrucksfehlers oder einer ungültigen Ausgabe, wird die Ausgabe MediaTailor der Funktion verworfen. Die Anfrage wird mit der ursprünglichen ADS-Antwort fortgesetzt, als ob keine Funktion angehängt wäre. Wenn die serialisierte Eingabe die Größenbeschränkung für die Eingabe überschreitet, wird der Hook-Aufruf MediaTailor vollständig übersprungen. Die geltenden Grenzwerte finden Sie unter. Einschränkungen