Pihak ketiga bukanlah pengguna langsung Ad Manager, karena mereka mungkin tidak memiliki jaringan Ad Manager sendiri. Sebagai gantinya, mereka membuat layanan atau integrasi dengan Ad Manager untuk klien mereka, 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 dasar tentang Ad Manager API. Jika Anda belum memahami Ad Manager API, lihat dokumentasi memulai penggunaan kami.
Mulai menggunakan fitur pihak ketiga
Untuk menggunakan Ad Manager API guna mengakses jaringan pelanggan Ad Manager, cukup ikuti pedoman di bawah. Tidak diperlukan persetujuan tambahan dari Google, tetapi perhatikan 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 bertanya-tanya cara menguji integrasi Ad Manager sebelum menjalankan kampanye di jaringan produksi klien Anda. Pendekatan yang direkomendasikan adalah membuat jaringan pengujian. Anda tidak harus menjadi pelanggan Ad Manager untuk melakukannya. Siapa saja yang memiliki Akun Google dapat membuat jaringan pengujian.
Namun, perhatikan perbedaan antara jaringan pengujian dan produksi. Jaringan pengujian tidak dapat menayangkan iklan. Jaringan pengujian juga tidak selalu berisi semua fitur yang mungkin tersedia di jaringan produksi klien Anda. Jika Anda perlu menguji fitur Ad Manager yang tidak tersedia di jaringan pengujian, salah satu opsi adalah membeli akses ke jaringan non-pengujian melalui reseller Ad Manager.
Selain itu, Anda harus menjelaskan kepada klien tentang fitur yang harus tersedia 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 dengan baik atau menyimpan daftar klien Anda dan fitur yang dimiliki atau tidak dimiliki oleh setiap klien. Klien Anda bertanggung jawab untuk menghubungi 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 Akun Google yang akan Anda gunakan untuk mengakses jaringan klien Anda.
- Minta klien menambahkan akun ini sebagai pengguna ke jaringan Ad Manager mereka.
Untuk langkah 1, Anda dapat membuat Akun Google terpisah untuk setiap klien, atau akun utama yang akan Anda gunakan untuk semua klien. Opsi pertama lebih aman jika salah satu akun Anda disusupi. Yang terakhir berarti Anda hanya perlu melakukan langkah 1 sekali.
Apa pun yang Anda lakukan untuk 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 akan membuat alamat email akun layanan untuk Anda yang berfungsi 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 inkognito atau sesi browser baru. Atau, jika perusahaan Anda menggunakan Google Workspace, Anda dapat membuat Akun Google di domain perusahaan Anda dan menggunakannya. Untuk tujuan panduan ini, kami akan menyebut keduanya sebagai Akun Google "biasa".
2. Minta klien untuk menambahkan Akun Google Anda ke jaringan mereka
Setelah Anda mendapatkan Akun Google untuk mengakses jaringan klien, minta klien tersebut untuk menambahkan akun tersebut sebagai pengguna baru di jaringan Ad Manager miliknya.
Jika Anda memberi mereka alamat email akun layanan OAuth2, minta mereka menambahkannya ke jaringan mereka.
Jika Anda memberi mereka Akun Google reguler, minta mereka menambahkan akun Anda sebagai pengguna ke jaringan mereka.
Apa pun jalur yang Anda pilih, pastikan Anda mendiskusikan dengan klien Anda peran dan izin yang harus dimiliki akun Anda agar aplikasi Anda dapat mengakses data yang diperlukan di jaringan klien Anda.
Sekarang Anda dapat mulai melakukan panggilan API ke jaringan Ad Manager klien Anda. Pastikan Anda menyetel header SOAP networkCode ke kode jaringan klien yang Anda gunakan untuk melakukan panggilan API. Semua library klien kami memungkinkan setelan ini secara terprogram. Misalnya, di library klien Java iklan, Anda dapat menetapkan kode jaringan secara terprogram saat membuat instance DfpSession.
Mendapatkan info terbaru tentang API
Anda harus selalu mengetahui versi API mana yang tidak digunakan lagi atau dihentikan dan kapan versi baru dirilis. Anda tidak ingin terkejut saat versi dihentikan dan berisiko merusak klien Anda. Kami tidak selalu dapat menghubungi pihak ketiga terkait penghentian dan peniadaan yang akan terjadi seperti yang kami lakukan untuk pelanggan kami. Oleh karena itu, Anda bertanggung jawab untuk berlangganan salah satu dari tiga saluran utama kami untuk mendapatkan info terbaru API dan menyesuaikan setelan notifikasi Anda:
Kami juga menyediakan jadwal penghentian penggunaan di situs developer kami yang harus Anda pantau secara rutin.