Laporan Inkremental

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.