Menangani pelacakan iklan klien VOD

Jika pelacakan iklan klien diaktifkan, pemutar bertanggung jawab untuk memicu peristiwa pelacakan iklan. Anda dapat menemukan informasi pelacakan sisi klien di objek interstisial yang ditampilkan saat sesi VOD dibuat.

Objek interstisial menyertakan metadata dan informasi pelacakan iklan untuk iklan pengiring yang diuraikan dari permintaan tag iklan. Untuk memeriksa iklan mana yang digabungkan, lihat Memeriksa sesi VOD.

Sebelum memulai

Pastikan Anda mengetahui langkah-langkah untuk membuat sesi VOD menggunakan Video Stitcher API. Untuk mengetahui informasi selengkapnya, lihat Membuat sesi VOD.

Interstisial

Informasi pelacakan iklan dikelompokkan berdasarkan jeda iklan di objek interstitials.

Jeda iklan dapat memiliki peristiwa progres yang menentukan URI peristiwa dan offset waktu yang relatif terhadap waktu mulai jeda untuk setiap peristiwa yang telah diaktifkan. Untuk mengetahui detail selengkapnya tentang peristiwa progres, lihat dokumentasi referensi ProgressEvent.

Jeda iklan juga dapat memiliki peristiwa aktivitas dan iklan pengiring. Untuk detail selengkapnya tentang iklan pengiring, lihat dokumentasi referensi CompanionAds.

Contoh interstisial dapat ditemukan di bawah ini:

{
  "adBreaks": [
    {
      "progressEvents": [
        {
          "timeOffset": "0s",
          "events": [
            {
              "type": "IMPRESSION",
              "uri": "https://example.com/impression"
            },
            {
              "type": "START",
              "uri": "https://example.com/start"
            }
          ]
        },
        {
          "timeOffset": "1.250s",
          "events": [
            {
              "type": "FIRST_QUARTILE",
              "uri": "https://example.com/firstquartile"
            }
          ]
        }
      ],
      "ads": [
        {
          "duration": "5s",
          "activityEvents": [
            {
              "type": "PAUSE",
              "uri": "https://example.com/pause"
            }
          ],
          "companionAds": {
            "required": "all",
            "companions": [
              {
                "width": 200,
                "height": 100,
                "staticResource": {
                  "uri": "https://example.com/static.png",
                  "creativeType": "image/png"
                }
              }
            ]
          }
        },
        {
          "duration": "10s"
        }
      ],
      "startTimeOffset": "0s",
      "endTimeOffset": "15.000s"
    }
  ],
  "sessionContent": {
      "duration": "120.000s"
  }
}

Pada contoh di atas, ada satu jeda iklan pre-roll dengan dua iklan yang digabungkan menjadi aset VOD. Durasi iklan pertama adalah 5 detik dan durasi iklan kedua adalah 10 detik. Total durasi video yang digabungkan adalah 120 detik, seperti yang diidentifikasi oleh kolom duration di sessionContent .

Saat menerima objek ini, klien harus melakukan hal berikut:

  • Buat permintaan ke https://example.com/start di awal jeda iklan.
  • Buat permintaan ke https://example.com/impression di awal jeda iklan.
  • Buat permintaan ke https://example.com/pause setiap kali penonton menjeda video selama iklan pertama.
  • Buat permintaan ke https://example.com/firstQuartile 1,25 detik sebelum iklan pertama.
  • Muat iklan pengiring https://example.com/static.png selama iklan pertama.

Untuk detail selengkapnya tentang interstisial, lihat dokumentasi referensi interstisial.