View a markdown version of this page

Payload EICM: Pengayaan metadata kontekstual - MediaLive
Muatan EICM versi 1Penggunaan hilir

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Payload EICM: Pengayaan metadata kontekstual

Payload fitur EICM (Metadata Kontekstual Inferensi Elemental) membawa informasi yang dibutuhkan konsumen hilir untuk menanyakan AWS Elemental Inference untuk metadata kontekstual pada waktu keputusan iklan.

Untuk informasi tentang mengaktifkan fitur ini di saluran Anda, lihatPengayaan metadata kontekstual.

Payload ini mengikuti header amplop AWSE 9-byte (untuk skema versi 1). Yang ada feature_id di dalam amplop adalah"EICM". Lihat Amplop AWSE UPID untuk struktur amplop.

Muatan EICM versi 1

Payload EICM dimulai dengan feature_version byte yang mengidentifikasi versi struktur payload. Untuk versi 1 (feature_version = 0x01), bidang yang tersisa berisi pengenal umpan Inferensi Elemental, URL bidang data untuk GetMetadata kueri, dan PTS pada timeline kondisioner yang sesuai dengan isyarat.

Bidang muncul dalam urutan yang ditunjukkan.

Bidang Ukuran Tipe Deskripsi
feature_version 1 byte uint8 Mengidentifikasi versi struktur muatan EICM. Saat ini, hanya 0x01 valid; bidang untuk versi 1 dijelaskan di baris yang tersisa dari tabel ini. Perubahan pada nilai ini akan menunjukkan perubahan struktural ke bidang yang tersisa.
feed_id_length 1 byte uint8 Panjang N feed_id bidang.
feed_id N byte ASCII Pengidentifikasi umpan Inferensi Elemental (tidak ada terminator NUL).
inference_query_url_length 1 byte uint8 Panjang M inference_query_url lapangan.
inference_query_url M byte ASCII URL bidang data Inferensi Elemental untuk GetMetadata kueri (tidak ada terminator NUL, tidak ada garis miring).
inference_query_pts 8 byte int64 BE PTS dari isyarat pada garis waktu kondisioner Inferensi Elemental.
inference_query_timescale 4 byte uint32 BE Basis waktu inference_query_pts (misalnya, 90000).

Ukuran muatan total EICM v1 adalah byte. 15 + N + M Total ini mencakup satu bidang versi 1-byte, dua bidang panjang 1-byte, dua string panjang variabel, satu bidang PTS 8-byte, dan satu bidang skala waktu 4-byte. Dikombinasikan dengan header amplop 9-byte (untuk skema versi 1), lengkapnya segmentation_upid_length adalah24 + N + M.

penting

inference_query_timescaleNilai inference_query_pts dan mungkin berbeda dari format PTS yang digunakan output Anda. Sistem hilir harus menggunakan nilai-nilai ini hanya untuk menanyakan API Inferensi GetMetadata Elemental.

Penggunaan hilir

Konsumen hilir, seperti sistem keputusan iklan (misalnya, AWS Elemental MediaTailor), mengurai muatan EICM dan menggunakan bidang untuk menanyakan Inferensi Elemental:

  1. Temukan segmentation_descriptor dengan segmentation_type_id = 0x01 dan UPID yang format_identifier ada"AWSE".

  2. Veri feature_id = "EICM" fikasi danfeature_version = 0x01.

  3. Ekstra feed_id kinference_query_url,inference_query_pts,, daninference_query_timescale.

  4. Panggil GetMetadata API Inferensi Elemental di URL yang diekstrak, meneruskan ID umpan dan nilai PTS.