Resource: AdBreak
Metadata jeda iklan yang digunakan untuk menentukan iklan untuk jeda iklan dalam acara video live.
| Representasi JSON |
|---|
{ "name": string, "createTime": string, "expectedDuration": string, "customParams": string, "scte35CueOut": string, "podTemplateName": string, "breakState": enum ( |
| Kolom | |
|---|---|
name |
Hanya output. Nama resource Jeda Iklan. Kolom ini akan memiliki format "networks/ network_code adalah kode jaringan di Google Ad Manager yang memiliki konten ini. asset_key adalah kunci Acara Live Stream di Google Ad Manager yang digunakan untuk membuat Jeda Iklan. adBreakId adalah kunci Jeda Iklan. OUTPUT ONLY. |
createTime |
Hanya output. Waktu pembuatan Jeda Iklan. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
expectedDuration |
Wajib. Perkiraan durasi jeda. Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
customParams |
Opsional. Pasangan nilai kunci yang akan disertakan dalam permintaan iklan untuk jeda ini bagi penargetan kriteria kustom di Ad Manager. Contoh: 'key1=value&key2=value2,value22' Tidak digunakan lagi: Tetapkan penargetan kriteria kustom menggunakan kunci "cust_params" di breakParams.ad_tag_params. |
scte35CueOut |
Opsional. Data yang dienkode base 64 dari cue out scte35. Dapat menyertakan perintah splice_insert() atau time_signal(). Contoh: - dengan time_signal(): “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” - dengan splice_insert(): "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo=" |
podTemplateName |
Opsional. Nama template pod Google Ad Manager. Tidak digunakan lagi: Tetapkan nama template pod menggunakan kunci "ptpln" di breakParams.ad_tag_params. |
breakState |
Hanya output. Status Jeda Iklan saat ini. |
expectedStartTime |
Opsional. Perkiraan waktu mulai Jeda Iklan. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
expireDuration |
Opsional. Mengakhiri Jeda Iklan pada expectedStartTime + expireDuration. Jika expectedStartTime tidak ditetapkan, Jeda Iklan akan berakhir setelah expireDuration sejak keputusan dimulai. Memerlukan penjadwalan multi-jeda iklan untuk diaktifkan di acara live stream. Default: 30m Minimum: 5m Maksimum: 6h Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
breakSequence |
Hanya output. ID urutan mid-roll Jeda Iklan. Beberapa jeda iklan mungkin memiliki breakSequence yang sama jika ditentukan secara eksplisit melalui breakParams.ad_tag_params dengan kunci mridx. Tindakan ini akan menautkan dua jeda iklan GAM secara efektif. |
breakParams |
Opsional. Parameter jeda yang akan disertakan pada panggilan iklan untuk jeda ini. |
matchParams |
Opsional. Digunakan untuk DAI Gabungan guna menentukan cara Jeda Iklan yang dibuat melalui API dicocokkan dengan jeda iklan dalam manifes. Memerlukan penjadwalan multi-jeda iklan untuk diaktifkan di acara live stream. Saat jeda baru terdeteksi dalam manifes, fungsi pencocokan akan dijalankan terhadap semua jeda iklan untuk acara yang memiliki breakState
Untuk mencegah perilaku "cocokkan semua" yang tidak disengaja (yang akan terjadi dengan matchParams yang kosong tetapi ada), matchParams tidak boleh kosong jika ditetapkan. Jika kolom ada dalam permintaan, setidaknya salah satu kolomnya harus ditetapkan. Jeda Iklan diperiksa dalam urutan ini: 1. dengan matchParams, diurutkan berdasarkan expectedStartTime menaik, createTime menaik, dengan Jeda Iklan tanpa expectedStartTime diprioritaskan saat diurutkan 2. tanpa matchParams, diurutkan berdasarkan expectedStartTime menaik, createTime menaik, dengan Jeda Iklan tanpa expectedStartTime diprioritaskan saat diurutkan Jika semua Jeda Iklan yang tertunda tidak cocok, DAI akan kembali ke perilaku keputusan JIT. |
servedBreak |
Hanya output. Hal ini mencerminkan informasi sebenarnya dari jeda iklan yang ditayangkan. Hanya ditetapkan untuk jeda iklan dengan breakState |
adTag |
Opsional. Mengganti tag iklan default acara untuk jeda iklan ini. |
Metode |
|
|---|---|
|
API untuk membuat Jeda Iklan dalam live stream. |
|
API untuk mencantumkan Jeda Iklan dalam live stream. |