Mengirim sinyal Google Ad Manager melalui server iklan pihak ketiga

Jika Anda menggunakan server iklan pihak ketiga dengan penyisipan iklan sisi server (SSAI) Google Ad Manager, IMA mendukung monetisasi inventaris tambahan melalui Google Ad Manager dengan mengirimkan nonce yang dienkripsi melalui server iklan pihak ketiga ke Ad Manager. Panduan ini menunjukkan cara mengirim sinyal ini menggunakan IMA SDK.

Istilah Penting: Untuk panduan ini, "server iklan pihak ketiga" adalah server iklan non-Google Ad Manager.

Panduan ini menggunakan contoh tag iklan: https://youradserver.com. Anda perlu memperbarui tag iklan agar berfungsi dengan server iklan yang sebenarnya.

Prasyarat

• IMA HTML5 SDK v3.523.0 atau yang lebih baru.

• Selesaikan Panduan memulai.

1. Mengonfigurasi aplikasi Anda untuk mengirim nonce ke server DAI Google

Tetapkan enableNonce ke true agar IMA DAI SDK mengirim nonce terenkripsi ke server DAI.

const streamRequest = new LiveStreamRequest();
streamRequest.enableNonce = true;

2. Memperbarui tag iklan dengan makro untuk mengisi nonce

Tambahkan makro [GOOGLE_INSTREAM_VIDEO_NONCE] ke tag server iklan di UI Ad Manager. Saat server DAI mengisi jeda iklan dengan URL server iklan pihak ketiga, Ad Manager akan mengisi makro secara dinamis dengan nonce yang dienkripsi. Hasilnya akan terlihat seperti tag iklan contoh berikut, yang menggunakan kunci yang harus dikonfigurasi di server pihak ketiga:

https://youradserver.com?ad_manager_nonce=[GOOGLE_INSTREAM_VIDEO_NONCE]

Tag iklan ini menggunakan ad_manager_nonce sebagai contoh kunci, tetapi Anda harus mengonfirmasi dengan server iklan pihak ketiga tentang cara server tersebut menerima nilai nonce.

Untuk memperbarui tag server iklan di Ad Manager, buka Video > Live Stream, lalu pilih live stream yang aktif atau buat yang baru.

Sekarang, tambahkan makro ke tag iklan yang dikonfigurasi dalam aliran data yang dipilih. Tetapkan tag di Setelan Jeda Iklan > Tag Iklan Master.

3. Mengonfigurasi permintaan server iklan pihak ketiga untuk Ad Manager

Konfigurasikan server iklan pihak ketiga untuk menyertakan nonce dalam permintaan server ke Ad Manager. Berikut adalah contoh tag iklan yang dikonfigurasi di dalam server iklan pihak ketiga:

https://pubads.g.doubleclick.net/gampad/ads?givn=%%custom_key_for_google_nonce%%&iu=/21775744923/external/single_ad_samples&sz=640x480

Ad Manager mencari givn= untuk mengidentifikasi nilai nonce. Server iklan pihak ketiga harus mendukung beberapa makronya sendiri, seperti %%custom_key_for_google_nonce%%, dan menggantinya dengan parameter kueri nonce yang Anda berikan pada langkah sebelumnya. Informasi selengkapnya tentang cara melakukannya akan tersedia di dokumentasi server iklan pihak ketiga.

Catatan: Panduan ini menggunakan dua makro.

1. Permintaan iklan ke server iklan pihak ketiga Anda harus berisi makro [GOOGLE_INSTREAM_VIDEO_NONCE]. Tag iklan ini disimpan di UI Ad Manager. IMA SDK melakukan penelusuran (dengan pencocokan persis yang peka huruf besar/kecil) dan mengganti makro ini dengan nonce terenkripsi.
2. Makro kedua, %%custom_key_for_google_nonce%%, digunakan oleh server iklan pihak ketiga untuk mengisi nonce terenkripsi untuk permintaan ke Google Ad Manager. Makro ini adalah contoh, dan dapat dikonfigurasi ke string apa pun yang diterima oleh server iklan pihak ketiga.

Selesai. Sekarang Anda harus memiliki parameter nonce yang disebarkan dari IMA DAI SDK melalui server DAI, ke server iklan pihak ketiga, dan kembali ke Ad Manager. Hal ini memungkinkan monetisasi yang lebih baik melalui Google Ad Manager.