Menggunakan parameter jeda iklan

Ad Break API memungkinkan Anda menetapkan parameter tag iklan menggunakan parameter jeda iklan, yang meningkatkan akurasi penargetan iklan dan integrasi dengan server iklan.

Mengganti parameter tag iklan

Untuk mengganti parameter tag iklan dari streaming DAI Google, tetapkan kolom breakParams.adTagParams jeda iklan. Untuk mengetahui informasi selengkapnya, lihat Menyediakan parameter penargetan ke streaming Anda dan Semua parameter tag iklan VAST.

Contoh berikut menunjukkan tag iklan streaming DAI yang berisi parameter kueri mridx (nomor mid-roll):

https://pubads.g.doubleclick.net/gampad/live/ads?mridx=3&…

Contoh permintaan berikut membuat jeda iklan yang menggantikan nilai penargetan mridx:

curl -X POST "https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -d '{
    "expectedDuration": "30s",
    "expectedStartTime": "2025-06-03T15:00:00Z",
    "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
    "customParams": "param1=value1&param2=value2",
    "podTemplateName": "podtemplate",
    "breakParams": {
      "adTagParams": [{"key": "mridx", "value": "7"}]
    }
  }'

Ganti kode berikut:

NETWORK_CODE: kode jaringan Google Ad Manager Anda. Untuk mengetahui informasi selengkapnya, lihat Kode jaringan Ad Manager.
ASSET_KEY: kunci aset acara livestream Anda. Untuk mengetahui informasi selengkapnya, lihat Menemukan URL streaming linear live dan kunci aset.
OAUTH_TOKEN: token akses Anda. Untuk informasi selengkapnya, lihat Mengautentikasi dengan OAuth2.

Memperluas tag iklan dengan makro DAI

DAI Google mendukung makro tag iklan dalam format %%DAI_PATTERN:MACRO_NAME%%. Nama makro harus dalam format UPPER_CASE, yang hanya berisi huruf besar, angka, dan garis bawah.

Anda dapat menyisipkan makro ini di tag iklan streaming DAI Google atau permintaan streaming DAI untuk menetapkan makro dengan nilai di kolom breakParams.macros.

Contoh berikut menunjukkan tag iklan streaming DAI Google yang berisi makro BREAK_TYPE:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%DAI_PATTERN:BREAK_TYPE%%&…

Permintaan berikut memperbarui jeda iklan dan menetapkan nilai makro BREAK_TYPE:

curl -X PATCH 'https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks/AD_BREAK_ID' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer OAUTH_TOKEN' \
  -d '{
  "name": "networks/…/assets/…/adBreaks/bcc402a6-9880-4b8b-8e4a-a8cd3688f854",
  "expectedDuration": "30s",
  "expectedStartTime": "2025-06-03T15:10:00Z",
  "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
  "customParams": "param1=value1&param2=value2",
  "podTemplateName": "podtemplate"
  "breakState": "BREAK_STATE_SCHEDULED",
  "breakParams": {
    "macros": [{"key": "BREAK_TYPE", "value": "national"}]
  }
}'

Ganti AD_BREAK_ID dengan ID jeda iklan Anda.

DAI Google menyelesaikan tag iklan dengan makro sebagai berikut:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&…

Memperluas tag iklan dengan makro SCTE-35

Saat menyiapkan acara live stream DAI Google, Anda dapat menempatkan makro SCTE-35 di tag iklan utama.

Saat acara live stream dimulai, Anda dapat menyisipkan data SCTE-35 dalam manifes konten atau memanggil API Jeda Iklan DAI dengan data SCTE-35 yang disertakan dalam parameter scte35CueOut. DAI Google menggunakan data yang didekode untuk mengisi makro SCTE-35 dalam tag iklan.

Contoh berikut menggunakan makro %%TIME_SIGNAL_UPID_RAW%%:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%TIME_SIGNAL_UPID_RAW%%&…

Contoh berikut menggunakan JSON untuk menggambarkan data sinyal berwaktu SCTE-35:

{
  "splice_info_section": {
    …
    "splice_command": {
      "command_name": "time_signal",
      "splice_time": {
        "time_specified_flag": 1,
        "pts_time": "123456789"
      }
    },
    "splice_descriptors": [
      {
        …
        "segmentation_upid": {
          "raw_hex": "0x6E6174696F6E616C", // UTF8 value: national
          …
        }
      }
    ]
  }
}

DAI Google menyelesaikan tag iklan dengan makro SCTE-35 sebagai berikut:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&…