Memantau diagnostik data offline

Gunakan Google Ads API untuk mengambil diagnostik data offline, yang berisi informasi tentang kualitas keseluruhan proses upload konversi dan penyesuaian Anda.

Untuk mengambil diagnostik data offline terbaru untuk akun Anda, kirim kueri berikut untuk resource offline_conversion_upload_client_summary menggunakan GoogleAdsService:

SELECT
  customer.id,
  offline_conversion_upload_client_summary.alerts,
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.daily_summaries,
  offline_conversion_upload_client_summary.job_summaries,
  offline_conversion_upload_client_summary.last_upload_date_time,
  offline_conversion_upload_client_summary.resource_name,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.success_rate,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.total_event_count
FROM offline_conversion_upload_client_summary

Kueri di atas menampilkan OfflineConversionUploadClientSummary terpisah untuk setiap jenis klien yang digunakan dalam upload terbaru. Misalnya, jika Anda baru saja mengupload menggunakan Google Ads API dan UI Google Ads, hasilnya akan berisi entri terpisah untuk nilai client GOOGLE_ADS_API dan GOOGLE_ADS_WEB_CLIENT.

Setiap OfflineConversionUploadClientSummary memiliki kolom status yang mencerminkan kondisi keseluruhan upload untuk client. Ini juga berisi jumlah total peristiwa yang diterima, jumlah peristiwa yang berhasil diproses, dan kolom alerts yang memberikan ringkasan error, yang dikelompokkan oleh OfflineConversionError. Semua kolom ini berisi informasi dari hari kalender lengkap terbaru upload. Gunakan informasi ini untuk menilai kondisi upload Anda saat ini.

Selain itu, setiap OfflineConversionUploadClientSummary berisi dua jenis laporan yang berbeda:

daily_summaries

Permintaan upload sebanyak successful_count dan failed_count dari 7 hari terakhir, dikelompokkan menurut date upload.

job_summaries

successful_count dan failed_count dari 7 permintaan upload terbaru, yang dikelompokkan menurut job_id. job_id adalah kolom opsional untuk UploadClickConversionsRequest dan UploadConversionAdjustmentsRequest. Anda dapat menetapkan job_id ke angka yang tidak negatif yang kurang dari 2^31 atau mengizinkan Google Ads API menetapkan ID tugas yang dihasilkan sistem untuk permintaan Anda. Terlepas dari opsi yang Anda pilih, UploadClickConversionsResponse atau UploadConversionAdjustmentsResponse akan menampilkan job_id.

Salah satu skenario ketika menetapkan job_id sendiri adalah saat Anda memiliki satu tugas atau proses yang mengupload sejumlah besar konversi menggunakan beberapa permintaan. Jika Anda menetapkan job_id pada setiap permintaan tersebut ke nilai yang sama, Anda dapat mengambil satu entri untuk tugas dari job_summaries. Jika Anda mengizinkan Google Ads API menetapkan nilai yang dihasilkan sistem ke job_id dari setiap permintaan, job_summaries akan berisi entri terpisah untuk setiap permintaan, yang dapat membuat analisis kesehatan keseluruhan pekerjaan Anda menjadi lebih menantang.

Cara menggunakan ringkasan

Untuk memastikan proses upload Anda mencatat konversi dan peningkatan seperti yang diharapkan, ambil ringkasan untuk setiap akun secara berkala. Jika status dari ringkasan apa pun bukan EXCELLENT, gunakan daftar error di bagian alerts untuk memandu Anda memodifikasi proses upload guna mengurangi atau menghilangkan error tersebut.

Contoh:

• Jika statusnya adalah NEEDS_ATTENTION, berarti sebagian besar operasi upload Anda akan gagal. Tinjau error pada bagian alerts dan ubah proses upload Anda untuk mengurangi atau menghilangkan error tersebut.

• Jika statusnya NO_RECENT_UPLOADS, berarti Google Ads belum menerima upload terbaru untuk client. Jika hal ini tidak diharapkan, tinjau proses yang melakukan upload menggunakan klien tersebut.

  Misalnya, jika status untuk GOOGLE_ADS_API adalah NO_RECENT_UPLOADS, hal ini dapat menunjukkan bahwa proses upload Anda yang menggunakan Google Ads API berhenti berjalan baru-baru ini.

• Periksa successful_count dan failed_count dari daily_summaries dan job_summaries untuk mengetahui apakah ada tugas atau tanggal upload tertentu yang mengirimkan peristiwa dalam jumlah besar yang tidak berhasil diproses.

Batasan

Perhatikan hal-hal berikut saat mengambil ringkasan upload:

• Google Ads API hanya menampilkan diagnostik data offline jika customer_id dari permintaan searchStream atau search adalah pelanggan yang sama dengan yang baru-baru ini Anda gunakan untuk mengupload konversi.

  Misalnya, akun klien yang menggunakan tracking konversi lintas-akun mungkin tidak berisi diagnostik apa pun. Namun, Anda dapat mengambil diagnostik dengan mengirimkan permintaan yang customer_id cocok dengan customer_id akun pengelola yang Anda gunakan dalam upload.

• Google Ads memperlakukan error CLICK_NOT_FOUND dari upload konversi yang disempurnakan untuk prospek sebagai peringatan. Akibatnya, jika alerts berisi entri untuk error ini, operasi yang sesuai masih dianggap berhasil dan disertakan dalam successful_event_count.