REST Resource: networks.customAssets.adBreaks

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 (BreakState),
  "expectedStartTime": string,
  "expireDuration": string,
  "breakSequence": string,
  "breakParams": {
    object (BreakParams)
  },
  "matchParams": {
    object (MatchParams)
  },
  "servedBreak": {
    object (ServedBreak)
  },
  "adTag": string
}
Kolom
name

string

Hanya output. Nama resource Jeda Iklan. Kolom ini akan memiliki format "networks//assets//adBreaks/".

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

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

expectedDuration

string (Duration format)

Wajib. Perkiraan durasi jeda.

Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan 's'. Contoh: "3.5s".

customParams
(deprecated)

string

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

string

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
(deprecated)

string

Opsional. Nama template pod Google Ad Manager. Tidak digunakan lagi: Tetapkan nama template pod menggunakan kunci "ptpln" di breakParams.ad_tag_params.

breakState

enum (BreakState)

Hanya output. Status Jeda Iklan saat ini.

expectedStartTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

expireDuration

string (Duration format)

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 's'. Contoh: "3.5s".

breakSequence

string (int64 format)

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

object (BreakParams)

Opsional. Parameter jeda yang akan disertakan pada panggilan iklan untuk jeda ini.

matchParams

object (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 SCHEDULED atau DECISIONED untuk memeriksa apakah semua parameter yang ditetapkan di matchParams Jeda Iklan cocok dengan jeda yang terdeteksi. Kecocokan terjadi jika salah satu kondisi berikut terpenuhi:

  1. Jeda Iklan memiliki kolom matchParams dan semua parameter yang ditetapkan di dalamnya cocok dengan jeda baru
  2. Jeda Iklan adalah DECISIONED dan tidak memiliki kolom matchParams

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

object (ServedBreak)

Hanya output. Hal ini mencerminkan informasi sebenarnya dari jeda iklan yang ditayangkan. Hanya ditetapkan untuk jeda iklan dengan breakState COMPLETE.

adTag

string

Opsional. Mengganti tag iklan default acara untuk jeda iklan ini.

Metode

create

API untuk membuat Jeda Iklan dalam live stream.

list

API untuk mencantumkan Jeda Iklan dalam live stream.