Memantau diagnostik data offline

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

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

Diagnostik tingkat akun

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

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 mengembalikan nilai OfflineConversionUploadClientSummary baris untuk setiap jenis klien yang digunakan dalam upload terbaru. Misalnya, jika Anda diupload menggunakan Google Ads API dan UI Google Ads, hasilnya 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 data OfflineConversionUploadConversionActionSummary baris untuk setiap jenis klien yang digunakan dalam upload terbaru. Misalnya, jika Anda diupload menggunakan Google Ads API dan UI Google Ads, hasilnya 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 upload untuk client. File ini juga berisi informasi berikut:

  • Jumlah total peristiwa yang diterima.
  • Jumlah peristiwa yang berhasil diproses.
  • Jumlah peristiwa yang tertunda (peristiwa yang masih diproses).
  • Kolom alerts, yang berisi ringkasan error, yang dikelompokkan menurut 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 atau OfflineConversionUploadConversionActionSummary berisi dua jenis jenis laporan:

daily_summaries
successful_count, failed_count, dan pending_count permintaan upload dari 7 hari terakhir, dikelompokkan menurut upload date.
job_summaries

successful_count, failed_count, dan pending_count dari 7 video paling banyak permintaan upload terbaru, yang dikelompokkan menurut job_id. job_id adalah kolom opsional dari UploadClickConversionsRequest dan UploadConversionAdjustmentsRequest. Anda bisa menyetel job_id ke angka non-negatif kurang dari 2^31 atau biarkan Google Ads API menetapkan ID pekerjaan yang dibuat sistem terhadap permintaan Anda. Terlepas dari opsi mana yang ingin Anda pilih, UploadClickConversionsResponse atau UploadConversionAdjustmentsResponse menampilkan job_id.

Salah satu skenario ketika menetapkan job_id sendiri akan berguna adalah saat Anda memiliki satu tugas atau proses yang mengupload banyak konversi menggunakan beberapa permintaan. Jika Anda menetapkan job_id pada setiap permintaan tersebut ke nilai yang sama, maka Anda dapat mengambil satu entri untuk pekerjaan dari job_summaries. Jika alih-alih Anda mengizinkan Google Ads API menetapkan ke job_id setiap permintaan, job_summaries berisi ID entri untuk setiap permintaan, yang dapat membuat analisis kesehatan Anda secara keseluruhan pekerjaan yang lebih menantang.

Cara menggunakan ringkasan

Untuk memastikan proses upload Anda mencatat konversi dan peningkatan sebagai diharapkan, mengambil 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 untuk mengurangi atau menghilangkan {i>error<i} tersebut.

Contoh:

  • Jika statusnya adalah NEEDS_ATTENTION, maka sebagian besar operasi upload gagal. Tinjau error pada alerts dan ubah error upload untuk mengurangi atau menghilangkan error tersebut.

  • Jika statusnya adalah NO_RECENT_UPLOADS, berarti Google Ads belum menerima notifikasi file yang diupload untuk client. Jika hal ini tidak diinginkan, maka tinjau kembali proses yang melakukan upload dengan menggunakan klien tersebut.

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

  • Untuk menentukan apakah ada tanggal upload atau pekerjaan tertentu yang mengirim banyak jumlah peristiwa yang gagal diproses, periksa successful_count, failed_count, dan pending_count dari daily_summaries dan job_summaries. Semua peristiwa dalam status tertunda dapat memerlukan waktu hingga 24 jam untuk diselesaikan.

Pembatasan

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 Anda gunakan baru-baru ini untuk mengupload konversi.

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

  • Google Ads memperlakukan CLICK_NOT_FOUND kesalahan dari konversi yang disempurnakan untuk prospek sebagai peringatan. Sebagai maka, jika alerts berisi entri untuk error ini, parameter yang sesuai masih dianggap berhasil dan termasuk dalam successful_event_count.

Sebelumnya
Variabel konversi khusus
Berikutnya
Memetakan ke metrik UI