Panduan penerapan sisi server

Fitur ini hanya tersedia untuk jaringan yang memiliki Account Manager Google khusus, dan mungkin tidak diaktifkan untuk jaringan Anda. Hubungi Account Manager Anda untuk informasi selengkapnya. Jika tidak memiliki Account Manager, jaringan Anda tidak memenuhi syarat untuk fitur ini.

Anda mungkin memerlukan kemampuan untuk mengirim permintaan iklan ke Ad Manager dari server pribadi atau pihak ketiga, penggabung video iklan dinamis, atau penyedia penyisipan sisi server. Selesaikan hal berikut untuk mengirim permintaan iklan sisi server ke Ad Manager dan melaporkan tayangan, klik, dan konversi yang diatribusikan secara akurat.

1. Membagikan petunjuk integrasi kepada partner teknologi sisi server

Agar Ad Manager dapat mengautentikasi panggilan sisi server dari server pihak ketiga (misalnya, penyedia penyisipan iklan dinamis atau penggabung video sisi server), server pihak ketiga harus terhubung ke server Ad Manager menggunakan sertifikat SSL yang diterbitkan oleh Ad Manager.

Minta partner teknologi sisi server Anda untuk menyelesaikan langkah-langkah yang dijelaskan di halaman ini.

Campaign Manager 360 dengan permintaan iklan sisi server juga memerlukan penginstalan sertifikat SSL. Partner teknologi sisi server Anda harus mengikuti petunjuk integrasi Campaign Manager 360 jika materi iklan video akan diminta melalui panggilan sisi server.

2. Membuat tag iklan sisi server

Penayang yang memanfaatkan server pihak ketiga untuk mengirim permintaan iklan ke Ad Manager bertanggung jawab untuk membuat tag video dengan salah satu dari dua cara berikut:

Di antarmuka Ad Manager

Pelajari cara membuat tag video dari Ad Manager 

Membuat URL tag iklan video secara manual

Lihat parameter URL wajib dan opsional yang didukung pada tag iklan video VAST dan persyaratan tambahan untuk mencatat penayangan, konversi, dan klik.

URL tag iklan sisi server yang merujuk ke /gampad/ads atau /gampad/live/ads harus menggunakan serverside.doubleclick.net (bukan pubads.g.doubleclick.net). Anda mungkin perlu memodifikasi URL tag iklan secara manual untuk memenuhi persyaratan ini.

3. Membuat permintaan iklan sisi server

Setelah tag iklan dibuat, partner teknologi yang bertanggung jawab untuk mengirimkan permintaan iklan sisi server ke Ad Manager harus:

• Meneruskan sumber penggabungan sisi server sebagai nilai parameter ssss dalam permintaan Ad Manager.

  Nilai parameter ssss peka huruf besar/kecil. Jika penayang diberi nilai examplesource, penerusan ssss=examplesource adalah tindakan yang benar, sedangkan ssss=ExampleSource adalah tidak benar.
  Vendor teknologi penggabungan video yang menggunakan integrasi server ke server dengan Google diberi nilai ini dari Google dan dapat memberikannya kepada Anda. Anda dapat menghubungi Account Manager Google jika memiliki pertanyaan tentang nilai yang ditetapkan ke parameter ini.

• Meneruskan alamat IP secara dinamis dari perangkat klien menggunakan header X-Forwarded-For atau sebagai nilai parameter ip di permintaan Ad Manager. Hanya teruskan nilai menggunakan salah satu metode ini, bukan keduanya.

  Kegagalan meneruskan alamat IP lengkap perangkat klien di salah satu dari dua metode ini dapat menyebabkan masalah penayangan dan penayangan iklan.

• Meneruskan header HTTP lengkap dari perangkat/lingkungan klien, termasuk:

  • Agen Pengguna: Program ini harus berupa keseluruhan string yang tidak diubah yang dilaporkan oleh browser pengguna.  Untuk iklan seluler yang dirender di WebView atau browser seluler native, agen pengguna yang digunakan oleh platform seluler untuk webview atau browser (misalnya, agen pengguna Mobile Safari untuk iOS) harus diteruskan. Jika iklan dirender di aplikasi seluler native, agen pengguna harus mengikuti Panduan Aplikasi Seluler.

    String agen pengguna yang dihasilkan oleh kelas koneksi URL platform seluler (misalnya, "Dalvik" di Android atau "CFNetwork" di iOS) tidak valid.

  • Menerima Encoding: Nilai parameter ini harus ditetapkan ke gzip,deflate agar Ad Manager dapat mengompresi respons. Hal ini wajib dilakukan karena respons yang tidak dikompresi berukuran 20 kali lebih besar.

Satu-satunya header yang tidak boleh diteruskan dalam permintaan iklan sisi server adalah header cookie.

Persyaratan tambahan untuk mencatat penayangan, konversi, dan klik

Sebaiknya semua penayangan dan konversi dikirim dari klien, bukan dari server. Penayang harus mengirim ping konversi dan tayangan dari klien. Dalam kasus tertentu, penayang dapat diberi kemampuan untuk mencatat penayangan, konversi, dan klik dari server.

Jika penyiapan teknis mengharuskan Anda mengirim penayangan, konversi, dan klik dari server, Anda harus menyertakan ipe=ssb pada permintaan iklan awal yang dikirim dari lingkungan sisi server.

Praktik terbaik lain yang direkomendasikan untuk memastikan Ad Manager dapat memproses permintaan iklan dan konversi dari penerapan sisi server yang terukur:

• Kirim semua peristiwa klik, konversi, dan penayangan dalam urutan peristiwa tersebut terjadi. Misalnya, jangan mengirim peristiwa klik sebelum peristiwa tayangan karena pengguna tidak akan dapat mengklik peristiwa sebelum tayangan diaktifkan dan iklan dirender.
• Jangan mengirim peristiwa secara massal. Sebagai gantinya, kirim peristiwa pada saat peristiwa tersebut terdaftar.

Traffic ini hanya berlaku untuk permintaan reservasi dan tidak akan terakreditasi MRC, kecuali jika ditentukan lain berdasarkan ketentuan perjanjian Beta.