Search Ads 360 Reporting API versi sebelumnya akan dihentikan dan dinonaktifkan pada 30 Juni 2024. Perhatikan bahwa Search Ads 360 Conversion API tidak terpengaruh dan akan terus didukung. Semua pengembangan pelaporan baru harus menggunakan Search Ads 360 Reporting API versi baru.

Mulai April 2024, error supportedApiVersion akan ditampilkan saat meminta laporan. Lihat detailnya di sini.

Sebaiknya migrasikan juga penerapan Search Ads 360 yang ada ke API baru. Lihat Memulai dan Panduan Migrasi Search Ads 360 Reporting API versi baru untuk mendapatkan informasi selengkapnya.

Halaman ini diterjemahkan oleh Cloud Translation API.

Laporan Inkremental

Search Ads 360 Reporting API versi baru kini tersedia. API baru ini memberikan fleksibilitas yang lebih baik dalam membuat laporan kustom dan mengintegrasikan data ke dalam proses dan aplikasi pelaporan Anda. Pelajari lebih lanjut cara bermigrasi ke dan menggunakan Search Ads 360 Reporting API baru.

Daripada menerima dump semua data setiap kali Anda meminta laporan, Anda dapat secara berkala meminta hanya data yang telah berubah sejak laporan terakhir Anda. Laporan inkremental ini kemungkinan akan jauh lebih kecil daripada laporan lengkap.

Jika Anda meminta laporan tambahan, Anda harus memperhatikan hal-hal berikut:

Sebaiknya minta laporan lengkap sesekali, untuk berjaga-jaga jika ada beberapa perubahan inkremental yang hilang. Misalnya, jika Anda meminta laporan inkremental mingguan selama bulan Januari, pada akhir Februari Anda harus meminta laporan lengkap untuk bulan Januari guna memastikan Anda mendapatkan semua data bulan Januari.
Karena tidak selalu mungkin untuk menentukan apakah beberapa entitas telah berubah, laporan inkremental akan berisi entitas jika Search Ads 360 bahkan mencurigakan bahwa entitas tersebut telah berubah. Artinya, laporan inkremental mungkin berisi data yang tidak berubah.

Untuk meminta laporan inkremental, tentukan salah satu properti Reports.request.timeRange berikut:

changedMetricsSinceTimestamp=timestamp

Meminta metrik yang telah berubah sejak stempel waktu yang ditentukan. Karena metrik disimpan pada tingkat perincian harian dan dapat berubah untuk satu hari, tetapi tidak pada hari yang lain, permintaan tersebut harus disegmentasikan menurut hari (kolom date harus ada). Misalnya, laporan keyword dengan kolom clicks, actions, dan date, akan menampilkan baris untuk setiap kata kunci dan tanggal ketika jumlah klik atau tindakan yang tercatat telah berubah sejak stempel waktu yang diberikan.

Stempel waktu tidak boleh lebih awal dari 8 hari sebelum waktu permintaan. Untuk mencatat semua metrik yang berubah, pastikan untuk membuat permintaan changedMetricsSinceTimestamp setidaknya sekali setiap 7 hari, dan buat laporan lengkap untuk setiap tanggal setelah metrik selesai (lebih aman untuk menunggu minimal 7 hari). Contoh polanya adalah membuat dua laporan setiap hari: laporan inkremental untuk metrik yang telah berubah dalam 36 jam terakhir, dan laporan lengkap untuk metrik yang terjadi 8 hari yang lalu.

changedAttributesSinceTimestamp=timestamp

Meminta atribut yang telah berubah sejak stempel waktu yang ditentukan. Permintaan changedAttributesSinceTimestamp hanya dapat menyertakan kolom atribut (tanpa kolom metrik atau segmen), dan tidak berfungsi untuk laporan peristiwa mentah seperti laporan conversion. Misalnya, laporan campaign dengan kolom dailyBudget dan campaignStartDate akan menampilkan baris untuk setiap kampanye yang anggaran harian atau tanggal mulainya telah berubah sejak stempel waktu yang ditentukan.

Perhatikan bahwa perubahan pada atribut induk tidak dicatat dalam laporan changedAttributesSinceTimestamp. Misalnya, kata kunci dapat mewarisi strategi biddingnya dari grup iklan induk. Meskipun grup iklan diberi strategi bidding baru, kata kunci ini mungkin tidak muncul dalam laporan. Kolom atribut yang nilainya bergantung pada parent entity (dan dapat berubah tanpa diambil oleh laporan changedAttributesSinceTimestamp) biasanya memiliki awalan "efektif", seperti effectiveLabelIds atau effectiveBidStartegy.