Pihak ketiga bukan pengguna langsung Ad Manager, karena mereka mungkin tidak memiliki jaringan Ad Manager sendiri. Sebagai gantinya, mereka membuat layanan atau integrasi dengan Ad Manager untuk kliennya, yang merupakan pelanggan Ad Manager. Panduan ini membahas dasar-dasar integrasi pihak ketiga dengan memberikan praktik terbaik, tips, dan trik.
Panduan ini mengasumsikan bahwa Anda memiliki pengetahuan yang berfungsi tentang Ad Manager API. Jika Anda belum memahami Ad Manager API, harap lihat dokumentasi memulai.
Memulai sebagai pihak ketiga
Untuk menggunakan Ad Manager API guna mengakses jaringan pelanggan Ad Manager, cukup ikuti panduan di bawah. Tidak ada persetujuan tambahan dari Google yang diperlukan, tetapi perlu diketahui bahwa dengan mengakses dan/atau menggunakan Ad Manager API, Anda menyetujui persyaratan dan ketentuan Ad Manager API.
Cara menguji integrasi Ad Manager sebagai pihak ketiga
Sebagai pihak ketiga, Anda mungkin ingin tahu cara menguji integrasi Ad Manager sebelum menjalankan jaringan produksi klien. Pendekatan yang direkomendasikan adalah membuat jaringan pengujian. Anda tidak perlu menjadi pelanggan Ad Manager untuk melakukannya. Siapa pun dengan akun Google dapat membuat jaringan pengujian.
Namun, perhatikan perbedaan antara jaringan pengujian dan produksi. Jaringan pengujian tidak dapat menayangkan iklan. Jaringan pengujian juga tidak harus berisi semua fitur yang mungkin tersedia oleh klien Anda di jaringan produksi mereka. Jika Anda perlu melakukan pengujian terhadap fitur Ad Manager yang tidak tersedia di jaringan pengujian, salah satu opsinya adalah membeli akses ke jaringan non-pengujian melalui reseller Ad Manager.
Selain itu, Anda harus menjelaskan kepada klien tentang fitur yang perlu disediakan di jaringan produksi mereka agar aplikasi Anda berfungsi dengan baik. Aplikasi Anda harus menangani kasus saat fitur mungkin tidak ada dengan menangkap pengecualian dan gagal secara halus, atau menyimpan daftar klien dan fitur apa saja yang dimiliki atau tidak dimiliki setiap klien. Klien Anda bertanggung jawab untuk bekerja sama dengan kontak mereka di Google guna mengelola fitur di jaringan mereka.
Autentikasi: Cara mengakses jaringan Ad Manager klien dengan benar
Agar aplikasi Anda dapat mengakses jaringan Ad Manager klien, Anda harus menyiapkan alur kerja autentikasi dengan cara yang aman.
Hal ini melibatkan dua langkah:
- Buat alamat email dari Akun Google yang akan Anda gunakan untuk mengakses jaringan klien.
- Minta klien menambahkan akun ini sebagai pengguna ke jaringan Ad Manager-nya.
Untuk langkah 1, Anda dapat membuat Akun Google terpisah untuk setiap klien, atau akun utama yang akan digunakan untuk semua klien. Opsi pertama lebih aman jika salah satu akun Anda disusupi. Artinya, Anda hanya perlu melakukan langkah 1 satu kali.
Apa pun yang Anda lakukan pada langkah 1, pada langkah 2, Anda harus meminta setiap klien baru untuk menambahkan Akun Google yang sesuai yang Anda buat untuk mereka sebagai pengguna ke jaringan Ad Manager mereka.
1. Membuat akun Google
Ada berbagai cara untuk membuat Akun Google yang dapat ditambahkan ke jaringan Ad Manager.
Opsi 1: Buat akun layanan OAuth2, yang menghasilkan alamat email akun layanan untuk Anda yang bertindak sebagai Akun Google. Petunjuk untuk membuat akun layanan baru.
Opsi 2: Anda dapat membuat Akun Google reguler (akun Gmail") dengan mendaftar sebagai pengguna baru. Jika Anda sudah memiliki Akun Google, selesaikan pendaftaran ini di jendela samaran atau sesi browser baru. Atau, jika perusahaan Anda menggunakan Google Workspace, Anda dapat membuat Akun Google di domain perusahaan dan menggunakannya. Untuk tujuan panduan ini, kami akan menyebut keduanya sebagai akun Google "reguler".
2. Minta klien untuk menambahkan Akun Google Anda ke jaringan mereka
Setelah Anda mendapatkan Akun Google untuk mengakses jaringan klien, minta mereka untuk menambahkan akun tersebut sebagai pengguna baru di jaringan Ad Manager miliknya.
Jika Anda memberi pengguna alamat email akun layanan OAuth2, minta mereka menambahkannya ke jaringan.
Jika Anda memberi mereka Akun Google reguler, minta mereka menambahkan akun Anda sebagai pengguna ke jaringan mereka.
Apa pun rute yang Anda ambil, pastikan untuk berdiskusi dengan klien tentang peran dan izin yang harus dimiliki akun Anda sehingga aplikasi dapat mengakses data yang diperlukan di jaringan klien.
Sekarang Anda dapat mulai melakukan panggilan API ke jaringan Ad Manager klien. Pastikan Anda menetapkan header SOAP networkCode ke kode jaringan klien yang digunakan untuk membuat panggilan API. Semua library klien kami memungkinkan penyetelan ini secara terprogram. Misalnya, dalam library klien Java iklan, Anda dapat menetapkan kode jaringan secara terprogram saat membuat instance DfpSession.
Mengikuti perkembangan API
Anda harus selalu mengetahui info terbaru tentang versi API yang tidak digunakan lagi atau dihentikan dan kapan versi baru dirilis. Anda tidak ingin lengah ketika sebuah versi dihentikan dan berisiko merusak klien Anda. Kami tidak selalu dapat menghubungi pihak ketiga terkait penghentian atau penghentian yang akan kami lakukan dalam waktu dekat, seperti yang kami lakukan untuk pelanggan. Dengan demikian, Anda bertanggung jawab untuk berlangganan salah satu dari tiga saluran utama kami untuk update API dan menyesuaikan setelan notifikasi:
Kami juga menyediakan jadwal penghentian di situs developer kami yang harus Anda pantau secara rutin.
Mendapatkan dukungan
Jika Anda mengalami masalah dengan integrasi Ad Manager, kami menawarkan saluran dukungan berikut, bergantung pada masalah Anda. Jika Anda memiliki pertanyaan tingkat produk, harap tuliskan ke forum produk Ad Manager. Jika Anda memiliki pertanyaan khusus API, harap tuliskan pertanyaan tersebut ke forum Ad Manager API. Lihat postingan blog ini untuk tips tentang membedakan apakah sesuatu merupakan pertanyaan tingkat produk atau pertanyaan khusus API.