Mengirim notifikasi jeda iklan awal

Penyisipan Iklan Dinamis (DAI) Google mendukung live stream pada tingkat koeksistensi yang tinggi. Notifikasi Jeda Iklan Awal (EABN) adalah permintaan untuk Google DAI agar menjadwalkan jeda iklan mendatang atau segera memulai keputusan iklan, yang mengoptimalkan rasio pengisian iklan dan waktu pemuatan.

Untuk memulai notifikasi jeda iklan awal untuk layanan lengkap, penayangan pod, atau penyisipan iklan yang dipandu server, gunakan resource AdBreaks. Resource ini dapat membuat dan mengelola jeda iklan untuk semua live stream yang Anda buat melalui UI Google Ad Manager, atau LiveStreamEventService API SOAP Google Ad Manager.

Halaman ini membahas cara menjadwalkan jeda iklan sebagai notifikasi jeda iklan awal.

Prasyarat

Untuk membuat atau mengelola jeda iklan, Anda memerlukan kunci aset atau kunci aset kustom yang dibuat oleh sistem live stream. Anda juga dapat menemukan kunci ini di halaman detail live stream. Lihat Menyiapkan live stream untuk DAI menggunakan UI Google Ad Manager.

Menjadwalkan jeda iklan

Anda dapat menjadwalkan jeda iklan saat jumlah penonton streaming meningkat. Untuk setiap peristiwa live stream, jadwalkan satu jeda iklan satu per satu hingga enam jam sebelumnya menggunakan metode layanan Create. Sertakan perkiraan waktu mulai dan ID jeda iklan Anda. DAI memulai keputusan iklan mendekati waktu yang dijadwalkan. Untuk keputusan jeda iklan langsung, hapus waktu mulai jeda iklan yang diperkirakan.

Agar Google DAI segera memulai keputusan iklan, Anda dapat menghapus waktu mulai jeda iklan yang diharapkan saat memanggil Create.

Contoh berikut menjadwalkan jeda iklan untuk acara live stream jenis Linear yang akan dimulai pada 6 Maret 2025 pukul 16.00 Waktu Universal Terkoordinasi (UTC):

cURL Node.js 
curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN' \
  -H 'content-type: application/json' \
  --data-raw '{"adBreakId":"mid-roll-1","assetKey":"ASSET_KEY","duration":"30s","expectedStartTime":"2025-03-06T16:00:00Z"}'

fetch("https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks", {
    "headers": {
      "authorization":
        "Bearer ACCESS_TOKEN",
        "Content-Type": "application/json",
    },
  "body": JSON.stringify({
    "adBreakId": "mid-roll-1",
    "duration": "30s",
    "expectedStartTime": "2025-03-06T16:00:00Z"
  }),
  "method": "POST"
});

Jika berhasil, Anda akan melihat respons JSON berikut:

{
  "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
  "adBreakId": "mid-roll-1",
  "assetKey": "...",
  "expectedStartTime": "2025-03-06T16:00:00Z",
  "duration": "30s",
  "breakState": "SCHEDULED"
}

Untuk membuat kueri jeda iklan, gunakan metode List. Untuk memeriksa detail jeda iklan, gunakan metode Get.

Contoh berikut mencantumkan semua jeda iklan untuk peristiwa live stream:

cURL Node.js 
curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN'

fetch(
  "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks",
  {
    "headers": {
      "authorization": "Bearer ACCESS_TOKEN",
    },
    "method": "GET"
  }
);

Jika berhasil, Anda akan melihat respons JSON berikut:

{
  "adBreaks": [
    {
      "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
      "adBreakId": "mid-roll-1",
      "assetKey": "...",
      "expectedStartTime": "2025-03-06T16:00:00Z",
      "duration": "30s",
      "breakState": "DECISIONED",
      "breakSequence": "1"
    }
  ]
}

Jika Anda ingin menjadwalkan ulang jeda iklan saat ini lebih cepat, gunakan metode Patch untuk mengubah waktu mulai yang diharapkan. Jika Anda ingin membatalkan jeda iklan saat ini, gunakan metode Delete sebelum statusnya menjadi COMPLETED.

Untuk membuat jeda iklan lain, tunggu hingga status jeda iklan saat ini COMPLETED.