Memantau diagnostik data offline

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

Untuk mengambil diagnostik data offline terbaru untuk akun Anda, gunakan salah satu referensi berikut:

• offline_conversion_upload_client_summary menggabungkan diagnostik impor di tingkat akun.
• offline_conversion_upload_conversion_action_summary menggabungkan diagnostik impor di tingkat tindakan konversi.

Diagnostik tingkat akun

Untuk mengambil diagnostik upload konversi tingkat akun, gunakan kueri GAQL berikut:

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.pending_event_count,
  offline_conversion_upload_client_summary.pending_rate,
  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 ini menampilkan baris OfflineConversionUploadClientSummary terpisah untuk setiap jenis klien yang digunakan dalam impor terbaru. Misalnya, jika Anda baru-baru ini mengimpor menggunakan Google Ads API dan UI Google Ads, hasilnya akan berisi entri terpisah untuk nilai client dari GOOGLE_ADS_API dan GOOGLE_ADS_WEB_CLIENT.

Diagnostik tingkat tindakan konversi

Untuk mengambil diagnostik upload konversi di tingkat tindakan konversi, gunakan kueri GAQL berikut:

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_name,
  offline_conversion_upload_conversion_action_summary.alerts,
  offline_conversion_upload_conversion_action_summary.client,
  offline_conversion_upload_conversion_action_summary.daily_summaries,
  offline_conversion_upload_conversion_action_summary.job_summaries,
  offline_conversion_upload_conversion_action_summary.last_upload_date_time,
  offline_conversion_upload_conversion_action_summary.pending_event_count,
  offline_conversion_upload_conversion_action_summary.status,
  offline_conversion_upload_conversion_action_summary.successful_event_count,
  offline_conversion_upload_conversion_action_summary.total_event_count
FROM offline_conversion_upload_conversion_action_summary
WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = < INSERT CONVERSION ACTION ID >

Mirip dengan diagnostik tingkat akun, kueri ini menampilkan baris OfflineConversionUploadConversionActionSummary terpisah untuk setiap jenis klien yang digunakan dalam impor terbaru. Misalnya, jika Anda baru-baru ini mengimpor menggunakan Google Ads API dan UI Google Ads, hasilnya akan berisi entri terpisah untuk nilai client dari GOOGLE_ADS_API dan GOOGLE_ADS_WEB_CLIENT.

Cara menafsirkan ringkasan ini

Setiap OfflineConversionUploadClientSummary atau OfflineConversionUploadConversionActionSummary memiliki kolom status, yang mencerminkan kesehatan keseluruhan impor untuk client. Selain itu, berisi informasi berikut:

• Jumlah total peristiwa yang diterima.
• Jumlah peristiwa yang berhasil diproses.
• Jumlah peristiwa yang menunggu keputusan (peristiwa yang masih diproses).
• Kolom alerts, yang memberikan ringkasan error, dikelompokkan berdasarkan OfflineConversionError.

Semua kolom ini berisi informasi dari impor hari kalender penuh terbaru. Gunakan informasi ini untuk menilai kualitas saat ini dari impor Anda.

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

daily_summaries

A successful_count, failed_count, dan pending_count permintaan impor dari 7 hari terakhir, yang dikelompokkan menurut impor date.

job_summaries

successful_count, failed_count, dan pending_count dari 7 permintaan impor terbaru, yang dikelompokkan menurut job_id. job_id adalah kolom opsional dari UploadClickConversionsRequest dan UploadConversionAdjustmentsRequest. Anda dapat menetapkan job_id ke angka non-negatif yang kurang dari 2^31 atau membiarkan Google Ads API menetapkan ID tugas yang dibuat sistem ke permintaan Anda. Terlepas dari opsi yang Anda pilih, UploadClickConversionsResponse atau UploadConversionAdjustmentsResponse akan menampilkan job_id.

Salah satu skenario saat penetapan job_id Anda sendiri berguna adalah saat Anda memiliki satu tugas atau proses yang mengimpor 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 membiarkan Google Ads API menetapkan nilai yang dibuat sistem ke job_id setiap permintaan, job_summaries akan berisi entri terpisah untuk setiap permintaan, yang dapat membuat analisis keseluruhan kondisi tugas Anda menjadi lebih sulit.

Cara menggunakan ringkasan

Untuk memastikan proses impor Anda mencatat konversi dan peningkatan seperti yang diharapkan, ambil ringkasan untuk setiap akun Anda secara berkala. Jika status ringkasan tidak EXCELLENT, gunakan daftar error di bagian alerts untuk memandu Anda mengubah proses impor guna mengurangi atau menghilangkan error tersebut.

Contoh:

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

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

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

• Untuk menentukan apakah ada tanggal atau tugas impor tertentu yang mengirimkan sejumlah besar peristiwa yang gagal diproses, periksa successful_count, failed_count, dan pending_count dari daily_summaries dan job_summaries. Setiap peristiwa dalam status tertunda dapat memerlukan waktu hingga 24 jam untuk diselesaikan.

Informasi selengkapnya tentang cara meningkatkan diagnostik data offline dapat ditemukan di Pusat bantuan.

Pembatasan

Perhatikan hal-hal berikut saat mengambil ringkasan impor:

• 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 mengimpor konversi.

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

• Google Ads memperlakukan error CLICK_NOT_FOUND dari impor 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.