Mempersiapkan aplikasi klien Anda agar berfungsi dengan Google Ad Manager

Mengumpulkan informasi yang diperlukan untuk permohonan klien Anda

Anda harus memiliki informasi berikut yang diperlukan oleh Google Ad Manager untuk membuat sesi aset VOD:

KolomDeskripsi
projectNumberNomor project Google Cloud yang digunakan untuk membuat sesi yang mengaktifkan Ad Manager; atau, Anda dapat menggunakan project ID.
region Region yang Anda inginkan untuk digunakan IMA SDK untuk membuat sesi VOD.
sourceUriURI aset VOD Anda untuk digabungkan dengan iklan.
adTagUriTag iklan untuk menandai jumlah iklan yang harus digabungkan beserta waktunya. Lihat Membuat tag iklan untuk sesi VOD.
networkCodeID numerik untuk jaringan Ad Manager Anda.
OAuth tokenToken OAuth berumur singkat untuk akun layanan dengan peran Video Stitcher User. Lihat Membuat token OAuth yang berumur pendek.

Tabel 1. Informasi yang diperlukan untuk sesi aset VOD yang diaktifkan Ad Manager

Membuat tag iklan untuk sesi VOD

Lakukan langkah-langkah berikut di akun Ad Manager Anda:

  1. Tambahkan unit iklan baru.
  2. Aktifkan aturan iklan.
  3. Buat aturan iklan baru. Sebagai bagian dari langkah ini, cari bagian Penargetan > Inventaris di Ad Manager. Pilih unit iklan baru dari langkah sebelumnya.

  4. Buat tag iklan yang valid dengan mengikuti langkah-langkah di artikel Membuat tag iklan video dan audio dengan modifikasi berikut:

    • Untuk jenis Player SDK, pilih Google IMA SDK.
    • Tambahkan parameter ad_rule=1 ke tag (misalnya, tambahkan &ad_rule=1 ke bagian akhir).
    • Tambahkan parameter vid_d=<vod_asset_duration_in_secs> ke tag (misalnya, tambahkan &vid_d=1800 ke bagian akhir untuk aset VOD berdurasi 30 menit).
    • Ubah parameter output=vast menjadi output=xml_vmap1. Spesifikasi Playlist Multi-Iklan (VMAP) Video adalah satu-satunya jenis output yang didukung.

Membuat token OAuth yang memiliki masa aktif singkat untuk pengujian

Untuk membuat token OAuth berumur singkat yang terkait dengan akun layanan dengan peran Video Stitcher User, ikuti langkah-langkah berikut:

  1. Ganti PATH_TO_YOUR_SERVICE_KEY dengan jalur ke file JSON yang telah Anda download ke komputer lokal.
    gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
  2. Ambil token pemilik OAuth 2.0 dari akun layanan:
    gcloud auth print-access-token

Karena ini adalah token berumur singkat, Anda harus membuatnya lagi secara berkala dengan perintah gcloud auth print-access-token dan mengirim token baru ke aplikasi klien Anda. Lihat bagian berikut untuk mengetahui informasi selengkapnya tentang cara mem-build layanan produksi untuk menyediakan token yang memiliki masa aktif singkat.

Membuat layanan untuk memberikan informasi ke aplikasi klien Anda

Buat layanan yang dapat memberikan informasi yang diperlukan untuk diteruskan ke klien. Jika aplikasi meminta informasi dari layanan Anda mengenai cara memutar aset VOD, layanan harus menampilkan informasi yang dijelaskan dalam Tabel 1.

Secara khusus, layanan tersebut harus dapat menyediakan token OAuth untuk aplikasi klien dengan cara yang aman. Konfigurasi layanan ini menggunakan dua akun layanan, salah satunya meniru identitas yang lain. Satu akun layanan memiliki peran Service Token Creator dan membuat token OAuth untuk akun layanan yang memiliki peran Video Stitcher User. Misalnya:

  • Akun layanan 1: Ini adalah akun layanan pemanggil. Akun ini memiliki izin Service Token Creator di akun layanan 2 dan meniru akun layanan 2 untuk aplikasi klien.
  • Akun layanan 2: Ini adalah akun layanan yang memiliki hak istimewa yang memiliki peran Pengguna Penggabung Video untuk membuat sesi.

Untuk mengetahui informasi tentang cara menyediakan token OAuth dari layanan Anda, termasuk contoh kode library klien, lihat Membuat token akses berumur pendek.