Mulai

Dokumen ini ditujukan bagi developer yang ingin menggunakan AdSense Management API untuk mendapatkan informasi tentang akun AdSense mereka. Dokumen ini mengasumsikan bahwa Anda sudah familier dengan konsep pemrograman web dan format data web.

Sebelum memulai

Membuat 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 coba gunakan UI AdSense sebelum mulai membuat kode.

Memilih library klien

Di halaman Library Klien dan Contoh, Anda akan menemukan informasi tentang library dan contoh yang tersedia. Klik tab untuk bahasa yang Anda pilih, lalu 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 pilihan Anda, yang biasanya ditemukan dalam file README di direktori utama repositori.

Jika penerapan Anda memiliki kebutuhan khusus, seperti menggunakan bahasa yang tidak didukung, Anda dapat membuat permintaan langsung ke API, bukan menggunakan library klien.

Daftarkan aplikasi Anda

Untuk menggunakan AdSense Management API, Anda harus mendaftarkan aplikasi yang sedang dikembangkan dengan membuat project dan membuat Client-ID.

Mendaftarkan aplikasi

Edit file konfigurasi untuk project library klien Anda dengan kredensial baru yang baru saja dibuat. Periksa dokumentasi library klien untuk mengetahui detail selengkapnya.

Catatan: Akun Google yang digunakan untuk pendaftaran harus merupakan akun developer, yaitu akun yang Anda inginkan dilihat oleh pengguna aplikasi sebagai developer aplikasi. Akun ini tidak perlu dikaitkan dengan login AdSense, karena pengguna akan memberikan akses ke akunnya 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 saat pengguna AdSense mengautentikasi dan memberi otorisasi untuk project Anda.

    Klien iklan mewakili 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 tempat mereka dapat memilih untuk memberikan akses. Setelah diberi otorisasi, mereka akan dialihkan ke URL callback yang ditentukan di Konsol API Google.
    2. Aplikasi yang terpasang memiliki cara kerja yang serupa. Library klien akan mencoba membuka jendela browser dan menggunakan kode otorisasi. Untuk aplikasi Android, Chrome, dan iOS, metode ini berbeda untuk setiap platform.
  2. Gunakan Penjelajah Google API untuk reports.generate guna meminta laporan berikut:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    Laporan memberi Anda insight tentang jumlah yang Anda peroleh, serta apa saja yang memengaruhi penghasilan tersebut. Iklan ini dapat dijalankan di seluruh akun atau pada sebagian 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 untuk iklan yang dikonfigurasi pengguna, yang menentukan beberapa properti untuk iklan yang sedang 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 khusus atau URL, atau gabungkan beberapa filter.

    Saluran adalah alat yang memungkinkan Anda melacak performa sebagian unit iklan. Ada dua jenis saluran: URL dan kustom. Iklan pertama memungkinkan Anda melacak performa di halaman atau domain tertentu, sedangkan yang kedua membantu Anda melacak performa grup unit iklan tertentu yang dipilih pengguna.

Anda siap untuk memulai implementasi dengan mempelajari sisa panggilan dan resource yang tersedia dalam dokumentasi referensi.