Panduan pengembangan aplikasi dan pemutar DAI

Gunakan informasi berikut untuk merencanakan dan mengelola pengembangan aplikasi dan pemutar untuk Penyisipan Iklan Dinamis (DAI).

Langsung ke bagian yang spesifik

  Dukungan platform DAI
  Dukungan untuk kontrol pemutar video
  Mengganti tag iklan default
  Mengganti parameter varian streaming
  Pertanyaan umum (FAQ)

Membandingkan jenis penerapan pemutar DAI.

Dukungan platform

Dukungan untuk Dynamic Ad Insertion ditampilkan di bawah, termasuk platform tempat DAI tidak didukung. Anda dapat mengklik untuk melihat aplikasi sampel dan informasi selengkapnya tentang setiap platform.

Aplikasi sampel dasar hanya mendemonstrasikan peristiwa pelacakan video. Opsi ini cocok untuk penayang yang hanya menggunakan pre-roll.

Aplikasi sampel tingkat lanjut mendemonstrasikan semua fungsi aplikasi dasar serta pembuatan bookmark, snapback, subtitel, scrubbing, dan penghitung mundur. Opsi ini cocok bagi penayang yang memonetisasi konten yang panjang.

Platform	Dukungan SSB	IMA SDK berkemampuan DAI	Aplikasi sampel	Dokumentasi tambahan
iOS	Ya	IMA SDK iOS	Aplikasi sampel iOS	Panduan memulai iOS Referensi iOS
Android atau FireTV	Ya	IMA SDK Android	Aplikasi sampel Android	Panduan memulai Android Referensi Android
tvOS (Apple TV)	Ya	IMA SDK tvOS	Aplikasi sampel tvOS	Panduan memulai tvOS Referensi tvOS
Roku	Ya	SDK yang didownload saat runtime	Aplikasi contoh Roku	Panduan memulai Roku
Chromecast	Ya	SDK yang didownload saat runtime	Aplikasi penerima sampel Secara umum, Anda juga harus memiliki aplikasi iOS atau Android yang dapat melakukan "transmisi" ke perangkat Chromecast. Anda dapat merujuk ke aplikasi "contoh lanjutan" untuk iOS dan Android untuk melihat contohnya.	Panduan memulai Chromecast
HTML5	Ya	SDK yang didownload saat runtime	Aplikasi contoh HTML5 Pemutar HTML5 demo DAI	Panduan memulai HTML5

Dukungan untuk kontrol pemutar video

Kontrol pemutar video hanya didukung jika IMA SDK diaktifkan. Semua aplikasi sampel lanjutan mendemonstrasikan fungsi fitur di berbagai platform yang didukung. Fitur informasi titik tanda juga dapat ditunjukkan di aplikasi contoh dasar.

• Total Hitung Mundur Iklan dan Per Hitung Mundur Iklan: Kemampuan menambahkan hitung mundur untuk menyatakan jumlah waktu yang tersisa untuk total jumlah iklan.

  iOS dan Android: IMA SDK menyediakan fitur opsional ini.

  Roku dan tvOS: Dalam IMA SDK, aplikasi sampel tingkat lanjut dilengkapi dengan contoh fitur ini. Anda perlu menyertakan kode khusus jika fitur ini diwajibkan.

• Subtitel: Kemampuan untuk menambahkan pemberian teks tertutup dalam streaming konten. Program subtitel yang didukung meliputi:

  Timed Text Markup Language (TTML) (side-car): TTML ditujukan untuk digunakan dalam transcoding atau pertukaran informasi teks berwaktu pada format konten distribusi lama yang saat ini digunakan untuk fungsi pemberian subtitel dan teks.

  WebVTT (side-car): File WebVTT menyediakan teks atau subtitel untuk konten video, deskripsi video tekstual, bab untuk navigasi konten, dan secara lebih umum, segala bentuk metadata yang disinkronkan berdasarkan waktu dengan konten audio atau video.

• Pemberian bookmark: Pemberian bookmark merupakan kemampuan untuk menyimpan dan memulihkan poin tertentu dalam streaming konten. Misalnya, setelah menonton konten streaming video selama lima menit, pengguna menutupnya, lalu membukanya kembali. Fitur pemberian bookmark akan menyimpan posisi pengguna yang memungkinkan streaming dilanjutkan pada posisi terakhir yang dilihat, sehingga memberikan pengalaman yang lancar bagi penonton.
• Snapback: Snapback adalah kemampuan untuk mengembalikan pengguna ke awal jeda iklan yang dicari sebelumnya, lalu mengembalikannya ke lokasi pencarian setelah jeda iklan selesai.
• Scrubbing: Merupakan fitur yang biasanya digunakan untuk konten yang panjang, yang memberikan kemampuan untuk melihat bingkai pertama konten saat pengguna melakukan scroll pada kolom konten.

Mengganti tag iklan default

Saat menentukan sumber konten untuk VOD atau live streaming linier DAI di Ad Manager, Anda perlu menentukan tag iklan video default.

Saat pemutar video meminta streaming, tag iklan ini akan digunakan sama persis seperti yang ditetapkan di UI. Namun, Anda memiliki kemampuan untuk mengganti parameter tag tersebut di permintaan streaming Anda.

Pelajari cara menyediakan parameter penargetan ke streaming Anda.

Mengganti parameter varian streaming

Urutan playlist HLS default ditetapkan oleh penayang.

Penggantian pilihan varian dan parameter urutan dapat ditetapkan selama waktu pembuatan streaming. Tindakan tersebut memungkinkan Anda menentukan sub-bagian varian yang sebaiknya disertakan dalam respons ke permintaan playlist master dan urutan varian tersebut. Subbagian dan urutan varian akan tetap sama selama masa aktif streaming, kecuali jika diganti secara eksplisit.

Pelajari cara mengganti parameter varian streaming.

Pertanyaan umum (FAQ)

Luaskan semua  Ciutkan semua

Bagaimana cara menampilkan iklan pre-roll?

Di streaming VOD, Anda dapat mengonfigurasi apakah akan menampilkan iklan pre-roll menggunakan aturan iklan.

Di streaming live linear, Anda dapat mengonfigurasi Ad Manager untuk menampilkan iklan pre-roll. Secara opsional, pemutar video Anda dapat membuat permintaan iklan Ad Manager sisi klien untuk menampilkan pre-roll kepada pengguna sebelum meminta live stream DAI Ad Manager.

Menyiapkan reses iklan

---

Di live streaming linier, Anda dapat menggunakan fitur "penghentian sementara iklan" agar tidak langsung menampilkan iklan DAI kepada penonton setelah mereka menonton iklan pre-roll.

Ada dua bagian dalam menerapkan penghentian sementara iklan:

1. Tentukan "Durasi penghentian sementara iklan" saat Anda menyiapkan live stream untuk DAI.
2. Teruskan parameter dai-ah yang ditetapkan menjadi 1 di array adtagparameters pada permintaan pembuatan streaming Anda. Ini adalah array yang sama yang digunakan saat mengganti parameter tag iklan Ad Manager dan saat menetapkan parameter varian streaming.

Bagaimana cara menayangkan konten video on demand dari beberapa CDN?

Saat membuat konfigurasi CDN untuk konten video on demand, Anda memiliki opsi untuk menentukan konfigurasi CDN default, dan setelan penayangan CDN tambahan. Hal ini memungkinkan Anda menyiapkan lebih dari satu CDN dan memilih tempat penayangan CDN secara dinamis pada awal sesi dengan menggunakan nilai kunci.

Setelah Anda menyiapkan dan menyimpan konfigurasi CDN, Ad Manager akan memberikan nama untuk setiap konfigurasi. Nama ini harus diteruskan ke permintaan pembuatan streaming sebagai nilai parameter dai-dlid. *

Untuk SSB, parameternya hanya akan diteruskan sebagai dai-dlid=AaBbC1aaBa0obA1BABaaBA (AaBbC1aaBa0obA1BABaaBA adalah nama yang ditampilkan di Ad Manager).

Saat menggunakan IMA SDK, parameter harus diteruskan ke dalam permintaan pembuatan streaming menggunakan parameter tag iklan.

_{* Jika tidak ada nama yang diteruskan ke permintaan, Ad Manager akan menggunakan CDN default.}

Bagaimana cara meminta streaming video on demand di aplikasi contoh?

Permintaan streaming VOD berisi cmsid dan vid, yang memungkinkan Anda menargetkan iklan ke konten video.

Bagaimana jika terjadi masalah saat mengambil konten video dari Ad Manager?

Jika aplikasi mendeteksi masalah saat menerima respons dari Ad Manager, sebaiknya Anda mengenkode logika untuk memutar konten mentah tanpa iklan. Untuk streaming VOD, ini adalah ingestUrl yang ditentukan untuk Ad Manager di feed MRSS sumber konten Anda. Untuk live streaming linier, ini adalah URL untuk streaming dari encoder Anda. Pelajari praktik terbaik untuk streaming cadangan DAI lebih lanjut.

Mengapa saya sebaiknya beralih dari Server-Side Beaconing (SSB) ke IMA SDK?

IMA SDK memungkinkan penayang memperkuat sinyal untuk pelaporan dan menjadikan pelacakan peristiwa lebih akurat. Pelajari lebih lanjut tentang Server-Side Beaconing untuk DAI.

Bagaimana cara memecahkan masalah streaming sisi server?

Setiap kali pemutar video Anda meminta streaming dari DAI Ad Manager, streaming tersebut akan ditampilkan dengan ID sesi. Sebaiknya pastikan bahwa Anda dapat melihat ID streaming ini dari dalam aplikasi saat perlu melakukan debug iklan di streaming Anda. Anda dapat menggunakan ID streaming ini untuk memantau dan memecahkan masalah aktivitas streaming.

Untuk mengatasi persoalan terkait pemecahan masalah atau pemadaman DAI, hubungi dukungan penayang.