本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
函數生命週期關聯
生命週期關聯定義 MediaTailor 在播放期間執行函數的時間。此頁面是輸入欄位、輸出命名空間以及管理每個勾點之資料流程的規則的完整參考。
概觀
MediaTailor 支援兩個生命週期掛鉤：
-
PRE_SESSION_INITIALIZATION當檢視器啟動新的工作階段時， 會觸發一次。將其用於一次性設定工作，例如擷取受眾客群。此時未發生廣告休息時間，因此廣告休息時間內容無法使用。 -
PRE_ADS_REQUEST會在每個廣告決策伺服器 (ADS) 請求之前觸發 - 串流中的每個廣告休息時間一次。使用它來自訂具有目標資料的 ADS 請求、修改 ADS URL 或新增標頭。
主要差異在於計時： PRE_SESSION_INITIALIZATION執行一次，並設定在整個工作階段中持續存在的資料，而 重複PRE_ADS_REQUEST執行，並且可以將每個 ADS 請求量身打造為特定的廣告休息時間。
輸入欄位參考
| 欄位 | Type | PRE_SESSION_INITIALIZATION | PRE_ADS_REQUEST |
|---|---|---|---|
session.id |
Long | ✓ | ✓ |
session.uuid |
String | ✓ | ✓ |
session.client_ip |
字串 | ✓ | ✓ |
session.user_agent |
字串 | ✓ | ✓ |
session.referer* |
String | ✓ | ✓ |
session.avail_duration_secs |
Long | ✗ | ✓ |
session.avail_duration_ms |
Long | ✗ | ✓ |
player_params.* |
String | ✓ | ✓ |
event.id |
字串 | ✓ | ✓ |
event.hook |
字串 | ✓ | ✓ |
event.timestamp |
String | ✓ | ✓ |
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 |
String | ✗ | ✓ |
scte.segmentation_upid.assetId |
字串 | ✗ | ✓ |
scte.segmentation_upid.cueData.key |
字串 | ✗ | ✓ |
scte.segmentation_upid.cueData.value |
String | ✗ | ✓ |
scte.unique_program_id |
Int | ✗ | ✓ |
scte.archive_allowed_flag |
Boolean | ✗ | ✓ |
scte.delivery_not_restricted_flag |
Boolean | ✗ | ✓ |
scte.device_restrictions |
Int | ✗ | ✓ |
scte.no_regional_blackout_flag |
Boolean | ✗ | ✓ |
scte.segment_num |
Int | ✗ | ✓ |
scte.segments_expected |
Int | ✗ | ✓ |
scte.sub_segment_num |
Int | ✗ | ✓ |
scte.sub_segments_expected |
Int | ✗ | ✓ |
scte.avails_expected |
Long | ✗ | ✓ |
adsRequest.url |
String | ✗ | ✓ |
adsRequest.method |
字串 | ✗ | ✓ |
adsRequest.headers.<key> |
字串 | ✗ | ✓ |
adsRequest.body |
String | ✗ | ✓ |
* session.referer 只有在工作階段初始化請求中包含參考標頭時才存在。使用 $exists(session.referer) 在存取之前檢查 。
