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 Lifecycle-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 an jedem Hook regeln.
-Übersicht
MediaTailor unterstützt zwei Lifecycle-Hooks:
-
PRE_SESSION_INITIALIZATIONwird einmal ausgelöst, wenn ein Zuschauer 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 ihn, um die ADS-Anfrage mit Targeting-Daten anzupassen, die ADS-URL zu ändern oder Header hinzuzufügen.
Der entscheidende Unterschied liegt im Timing: PRE_SESSION_INITIALIZATION Wird einmal ausgeführt und richtet Daten ein, die für die gesamte Sitzung bestehen bleiben, während sie wiederholt PRE_ADS_REQUEST ausgeführt wird und jede ADS-Anfrage an die spezifische Werbeunterbrechung anpassen 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 | ✗ | ✓ |
asset.* |
Zeichenfolge | ✗ | ✓ |
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 $exists(session.referer) zur Überprüfung vor dem Zugriff verwendet.
