Dokumen ini ditujukan untuk developer yang ingin menggunakan AdSense Management API untuk mendapatkan informasi tentang akun AdSense mereka. Dokumen ini mengasumsikan bahwa Anda telah memahami konsep pemrograman web dan format data web.
Sebelum memulai
Mendapatkan akun AdSense
Daftar atau login ke akun AdSense Anda untuk memulai.
Pahami AdSense
Jika Anda belum memahami konsep AdSense, baca informasi pengantar tentang AdSense dan lakukan eksperimen dengan UI AdSense sebelum memulai coding.
Memilih library klien
Di halaman Library dan Contoh Klien, Anda akan menemukan informasi tentang library dan contoh yang tersedia. Klik tab untuk bahasa yang dipilih dan ikuti link untuk mendownload sumber. Library klien menangani hal berikut untuk Anda:
- autentikasi
- penemuan layanan
- membuat permintaan ke API
- penguraian respons
Baca petunjuk untuk menginstal dan mengonfigurasi library klien yang Anda pilih, biasanya ditemukan dalam file README di direktori utama repositori.
Jika implementasi Anda memiliki kebutuhan khusus, seperti menggunakan bahasa yang tidak didukung, Anda dapat membuat permintaan langsung ke API, bukan menggunakan library klien.
Mendaftarkan aplikasi Anda
Untuk menggunakan AdSense Management API, Anda harus mendaftarkan aplikasi yang Anda kembangkan dengan membuat project dan membuat Client-ID.
Mendaftarkan aplikasiEdit file konfigurasi untuk project library klien Anda dengan kredensial baru yang baru saja Anda buat. Periksa dokumentasi library klien untuk mengetahui detail selengkapnya.
Catatan: Akun Google yang digunakan untuk pendaftaran harus merupakan akun developer Anda, yaitu akun yang ingin dilihat oleh pengguna aplikasi sebagai developer aplikasi. Akun ini tidak perlu dikaitkan dengan login AdSense, karena pengguna akan memberikan akses ke akun mereka sendiri saat menggunakan aplikasi.
Tutorial mulai cepat
Ikuti langkah-langkah di bawah ini untuk membuat permintaan pertama Anda. Perhatikan bahwa langkah-langkah ini mungkin sedikit berbeda, bergantung pada library atau bahasa yang Anda gunakan:
- Gunakan contoh yang sesuai untuk mengambil daftar klien iklan dari akun AdSense. Permintaan ini memulai proses satu kali di mana pengguna AdSense mengautentikasi dan memberikan otorisasi pada project Anda.
Klien iklan menunjukkan pengaitan antara akun AdSense dan produk AdSense, seperti Iklan Konten atau Iklan Penelusuran. Akun AdSense dapat memiliki satu atau beberapa klien iklan.
- Untuk aplikasi web, pengguna akan dialihkan ke situs yang dapat mereka pilih untuk memberikan akses. Setelah diotorisasi, pengguna akan dialihkan ke URL callback yang ditentukan dalam konsol API.
- Aplikasi terinstal memiliki cara kerja serupa. Library klien akan mencoba membuka jendela browser dan menggunakan kode otorisasi. Untuk aplikasi Android, Chrome, dan iOS, metode ini khusus untuk platform.
- Gunakan
Penjelajah API untuk
reports.generate
guna meminta laporan berikut:date_range: YESTERDAY
dimensions: DATE
metrics: ESTIMATED_EARNINGS
Laporan memberi Anda insight tentang hal yang Anda peroleh, serta apa yang memengaruhi penghasilan tersebut. Iklan ini dapat dijalankan di seluruh akun atau di subkumpulan unit iklan, melalui penggunaan saluran.
- Coba minta laporan yang sama dari aplikasi Anda.
- Anda dapat memfilter laporan menurut unit iklan. Ambil daftar unit iklan menggunakan
adunits.list
. Perhatikan bahwa client ID iklan diperlukan (dapatkan dari langkah 1). Setelah Anda memilih unit iklan, gunakan ID-nya dalam parameter filter untukreports.generate
:Unit Iklan adalah placeholder yang dikonfigurasi pengguna untuk iklan, yang menentukan beberapa properti untuk iklan yang ditampilkan (seperti ukuran dan bentuk).
date_range: YESTERDAY
dimensions: DATE
metrics: ESTIMATED_EARNINGS
filter: AD_UNIT_ID==ca-pub-123456789:987654321
- Coba filter menurut saluran URL atau kustom, atau gabungkan beberapa filter.
Saluran adalah alat yang memungkinkan Anda melacak performa sebagian unit iklan. Ada dua jenis saluran: URL dan kustom. Tag pertama memungkinkan Anda melacak performa di seluruh halaman atau domain tertentu, sedangkan yang kedua membantu Anda melacak performa pada grup unit iklan tertentu yang dipilih pengguna.
Anda siap memulai penerapan dengan mempelajari panggilan dan resource lainnya yang tersedia dalam dokumentasi referensi.