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.
Funktionen Lebenszyklus-Hooks
Ein Lifecycle-Hook definiert, wann Ihre Funktion während der Wiedergabe MediaTailor ausgeführt wird. Diese Seite ist eine vollständige Referenz für Eingabefelder, Ausgabe-Namespaces und die Regeln, die den Datenfluss bei jedem Hook regeln.
-Übersicht
MediaTailor unterstützt zwei Lifecycle-Hooks:
-
PRE_SESSION_INITIALIZATIONwird einmal ausgelöst, wenn ein Betrachter eine neue Sitzung startet. Verwenden Sie es für einmalige Einrichtungsarbeiten wie das Abrufen von Zielgruppensegmenten. Zu diesem Zeitpunkt ist noch keine Werbeunterbrechung aufgetreten, sodass der Kontext für die Werbeunterbrechung nicht verfügbar ist. -
PRE_ADS_REQUESTwird vor jeder ADS-Anfrage (Ad Decision Server) ausgelöst — einmal pro Werbeunterbrechung im Stream. Verwenden Sie es, um die ADS-Anfrage mit Targeting-Daten anzupassen, die ADS-URL zu ändern oder Header hinzuzufügen.
Der Hauptunterschied liegt im Timing: Wird einmal PRE_SESSION_INITIALIZATION ausgeführt und richtet Daten ein, die für die gesamte Sitzung bestehen bleiben, während es wiederholt PRE_ADS_REQUEST ausgeführt wird und jede ADS-Anfrage an die jeweilige Werbeunterbrechung angepasst werden kann.
Referenz zum Eingabefeld
| Feld | Typ | PRE_SESSION_INITIALIZATION | PRE_ADS_REQUEST |
|---|---|---|---|
session.id |
Long | ✓ | ✓ |
session.uuid |
Zeichenfolge | ✓ | ✓ |
session.client_ip |
Zeichenfolge | ✓ | ✓ |
session.user_agent |
Zeichenfolge | ✓ | ✓ |
session.referer* |
Zeichenfolge | ✓ | ✓ |
session.avail_duration_secs |
Long | ✗ | ✓ |
session.avail_duration_ms |
Long | ✗ | ✓ |
player_params.* |
Zeichenfolge | ✓ | ✓ |
event.id |
Zeichenfolge | ✓ | ✓ |
event.hook |
Zeichenfolge | ✓ | ✓ |
event.timestamp |
Zeichenfolge | ✓ | ✓ |
avail.index |
Int | ✗ | ✓ |
avail.random |
Long | ✗ | ✓ |
avail.source_content_time_epoch_ms |
Long | ✗ | ✓ |
scte.event_id |
Int | ✗ | ✓ |
scte.avail_num |
Int | ✗ | ✓ |
scte.segmentation_event_id |
Int | ✗ | ✓ |
scte.segmentation_type_id |
Int | ✗ | ✓ |
scte.segmentation_upid |
Zeichenfolge | ✗ | ✓ |
scte.segmentation_upid.assetId |
Zeichenfolge | ✗ | ✓ |
scte.segmentation_upid.cueData.key |
Zeichenfolge | ✗ | ✓ |
scte.segmentation_upid.cueData.value |
Zeichenfolge | ✗ | ✓ |
scte.unique_program_id |
Int | ✗ | ✓ |
scte.archive_allowed_flag |
Boolesch | ✗ | ✓ |
scte.delivery_not_restricted_flag |
Boolesch | ✗ | ✓ |
scte.device_restrictions |
Int | ✗ | ✓ |
scte.no_regional_blackout_flag |
Boolesch | ✗ | ✓ |
scte.segment_num |
Int | ✗ | ✓ |
scte.segments_expected |
Int | ✗ | ✓ |
scte.sub_segment_num |
Int | ✗ | ✓ |
scte.sub_segments_expected |
Int | ✗ | ✓ |
scte.avails_expected |
Long | ✗ | ✓ |
adsRequest.url |
Zeichenfolge | ✗ | ✓ |
adsRequest.method |
Zeichenfolge | ✗ | ✓ |
adsRequest.headers.<key> |
Zeichenfolge | ✗ | ✓ |
adsRequest.body |
Zeichenfolge | ✗ | ✓ |
* session.referer ist nur vorhanden, wenn ein Referer-Header in der Anfrage zur Sitzungsinitialisierung enthalten ist. Wird verwendet$exists(session.referer), um dies vor dem Zugriff zu überprüfen.
