AdSense Management API memiliki panggilan untuk membuat laporan baru dan tersimpan. Laporan tersebut dapat berisi analisis sederhana seperti penghasilan per hari atau tabel rasio klik-tayang yang sangat kompleks per saluran khusus per negara. Panduan ini menyajikan daftar kasus ekstrem yang harus ditangani dengan benar untuk integrasi yang kuat dengan API.
Struktur laporan
Hasil laporan ditampilkan sebagai objek ReportResult. Lihat
referensi
respons laporan untuk mengetahui detail lengkapnya.
Menggunakan dimensi kronologis: DATE, WEEK, dan MONTH
Laporan dapat kosong atau memiliki celah
Jika tidak ada aktivitas selama jangka waktu yang ditentukan dalam permintaan, tidak ada permintaan iklan yang dibuat dan layanan laporan tidak akan menampilkan baris untuk jangka waktu tersebut. Hal ini penting jika Anda, misalnya, sedang merencanakan grafik.
Lihat Panduan Mengisi Tanggal untuk informasi selengkapnya.
Meminta dimensi MONTH dan WEEK dalam laporan yang sama
Laporan ini dapat memiliki konsekuensi negatif atau tidak terduga. Jika seminggu terdiri dari dua bulan yang berbeda, laporan akan menampilkan dua baris untuk minggu yang sama, satu baris untuk setiap bulan.
Contoh
| Dimensi | Metrik | Tanggal mulai | Tanggal akhir |
|---|---|---|---|
WEEKMONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
Retur:
MONTH | WEEK* | CLICKS |
|---|---|---|
| 2014-04 | 2014-04-27 | 50 |
| 2014-05 | 2014-04-27 | 43 |
* hari pertama
Solusi
Hapus MONTH dari laporan.
WEEK | CLICKS |
|---|---|
| 2014-04-27 | 93 |
Menggabungkan nilai dimensi
Saat meminta dimensi seperti dimensi yang terkait dengan, misalnya, platform (desktop, perangkat seluler kelas atas, dll.), hanya platform dengan aktivitas yang akan ditampilkan. Jika hari, minggu, atau bulan tertentu tidak memiliki kunjungan dari perangkat seluler kelas atas, data tidak akan memiliki informasi untuk kategori tersebut.
Contoh
| Dimensi | Metrik | Tanggal mulai | Tanggal akhir |
|---|---|---|---|
PLATFORM_TYPE_NAMEMONTH |
AD_REQUESTS |
2014-02-01 | 2014-03-31 |
Retur:
| MONTH | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Desktop | 100 |
| 2014-03 | Perangkat seluler kelas atas | 5 |
| 2014-04 | Desktop | 75 |
Solusi
Saat memproses hasil laporan, asumsikan nilai nol untuk nilai dimensi apa pun yang tidak muncul dalam hasil:
| MONTH | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Desktop | 100 |
| 2014-03 | Perangkat seluler kelas atas | 5 |
| 2014-04 | Desktop | 75 |
| 2014-04 | Perangkat seluler kelas atas | 0 |
Menggabungkan beberapa laporan yang berurutan
Terkadang, laporan terlalu besar untuk dibuat sekaligus dan harus digabungkan dalam batch. Jika aplikasi Anda melakukannya, pertimbangkan kasus berikut:
- Jika Anda menggunakan dimensi
WEEKatauMONTHdan memisahkan laporan di pertengahan minggu atau bulan, setiap laporan akan memiliki entri duplikat dengan data yang berbeda. - Pastikan semua laporan memiliki metrik dan dimensi yang sama, karena data mungkin tidak dapat digabungkan menggunakan dimensi yang berbeda.
Akun khusus
Beberapa pengguna mungkin memiliki akun AdSense dengan atribut yang tidak Anda harapkan atau ketahui. Pastikan untuk mempertimbangkan:
- Penayang dengan ribuan domain atau situs
- Penayang dengan ribuan unit iklan atau saluran khusus
- Penayang yang ingin melaporkan beberapa klien iklan (AdSense untuk Penelusuran, AdSense untuk Video, dll.)
Beberapa akun
Pengguna dapat memiliki akses ke lebih dari satu akun AdSense. ID akun harus
ditentukan untuk setiap panggilan ke API karena alasan ini. Panggilan ke
accounts.list akan mengambil daftar akun dan dialog
pemilih akun akan ditampilkan kepada pengguna. Hal ini dapat diabaikan jika
jumlah akun yang diambil adalah satu.
Perubahan zona waktu
Penayang AdSense dapat mengubah zona waktu mereka kapan saja dan hal ini dapat menghasilkan lonjakan atau penurunan dalam laporan. Baca panduan Pelaporan Zona Waktu Lokal untuk informasi selengkapnya.