Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Fungsi kait siklus hidup
Pengait siklus hidup menentukan kapan MediaTailor menjalankan fungsi Anda selama pemutaran. Halaman ini adalah referensi lengkap untuk bidang input, ruang nama keluaran, dan aturan yang mengatur aliran data di setiap hook.
Ikhtisar
MediaTailor mendukung dua kait siklus hidup:
-
PRE_SESSION_INITIALIZATIONdiaktifkan sekali saat pemirsa memulai sesi baru. Gunakan untuk pekerjaan penyiapan satu kali seperti mengambil segmen audiens. Pada titik ini, tidak ada jeda iklan yang terjadi, sehingga konteks jeda iklan tidak tersedia. -
PRE_ADS_REQUESTdiaktifkan sebelum setiap permintaan server keputusan iklan (ADS) — sekali per jeda iklan di streaming. Gunakan untuk menyesuaikan permintaan ADS dengan data penargetan, mengubah URL ADS, atau menambahkan header.
Perbedaan utamanya adalah pengaturan waktu: PRE_SESSION_INITIALIZATION berjalan sekali dan menyiapkan data yang bertahan untuk seluruh sesi, sementara PRE_ADS_REQUEST berjalan berulang kali dan dapat menyesuaikan setiap permintaan ADS dengan jeda iklan tertentu.
Referensi bidang masukan
| Bidang | Tipe | PRE_SESSION_INISIALISASI | PRE_ADS_REQUEST |
|---|---|---|---|
session.id |
Panjang | ✓ | ✓ |
session.uuid |
String | ✓ | ✓ |
session.client_ip |
String | ✓ | ✓ |
session.user_agent |
String | ✓ | ✓ |
session.referer* |
String | ✓ | ✓ |
session.avail_duration_secs |
Panjang | ✗ | ✓ |
session.avail_duration_ms |
Panjang | ✗ | ✓ |
player_params.* |
String | ✓ | ✓ |
event.id |
String | ✓ | ✓ |
event.hook |
String | ✓ | ✓ |
event.timestamp |
String | ✓ | ✓ |
avail.index |
Int | ✗ | ✓ |
avail.random |
Panjang | ✗ | ✓ |
avail.source_content_time_epoch_ms |
Panjang | ✗ | ✓ |
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 |
String | ✗ | ✓ |
scte.segmentation_upid.cueData.key |
String | ✗ | ✓ |
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 |
Panjang | ✗ | ✓ |
adsRequest.url |
String | ✗ | ✓ |
adsRequest.method |
String | ✗ | ✓ |
adsRequest.headers.<key> |
String | ✗ | ✓ |
adsRequest.body |
String | ✗ | ✓ |
* hanya session.referer hadir ketika header Referer disertakan dalam permintaan inisialisasi sesi. Gunakan $exists(session.referer) untuk memeriksa sebelum mengakses.
