Mulai

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 aplikasi

Edit 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:

  1. 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.

    1. 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.
    2. 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.
  2. 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.

  3. Coba minta laporan yang sama dari aplikasi Anda.
  4. 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 untuk reports.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
  5. 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.