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.