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:
offline_conversion_upload_client_summary
menggabungkan diagnostik upload di tingkat akun.offline_conversion_upload_conversion_action_summary
(hanya tersedia di v17 atau yang lebih baru) menggabungkan diagnostik upload di tingkat tindakan konversi.
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 menurutOfflineConversionError
.
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
, danpending_count
permintaan upload dari 7 hari terakhir, dikelompokkan menurut uploaddate
.job_summaries
successful_count
,failed_count
, danpending_count
dari 7 video paling banyak permintaan upload terbaru, yang dikelompokkan menurutjob_id
.job_id
adalah kolom opsional dariUploadClickConversionsRequest
danUploadConversionAdjustmentsRequest
. Anda bisa menyeteljob_id
ke angka non-negatif kurang dari2^31
atau biarkan Google Ads API menetapkan ID pekerjaan yang dibuat sistem terhadap permintaan Anda. Terlepas dari opsi mana yang ingin Anda pilih,UploadClickConversionsResponse
atauUploadConversionAdjustmentsResponse
menampilkanjob_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 menetapkanjob_id
pada setiap permintaan tersebut ke nilai yang sama, maka Anda dapat mengambil satu entri untuk pekerjaan darijob_summaries
. Jika alih-alih Anda mengizinkan Google Ads API menetapkan kejob_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 padaalerts
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 untukclient
. Jika hal ini tidak diinginkan, maka tinjau kembali proses yang melakukan upload dengan menggunakan klien tersebut.Misalnya, jika
status
untukGOOGLE_ADS_API
adalahNO_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
, danpending_count
daridaily_summaries
danjob_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 PermintaansearchStream
atausearch
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 dengancustomer_id
pengelola yang Anda gunakan dalam upload.Google Ads memperlakukan
CLICK_NOT_FOUND
kesalahan dari konversi yang disempurnakan untuk prospek sebagai peringatan. Sebagai maka, jikaalerts
berisi entri untuk error ini, parameter yang sesuai masih dianggap berhasil dan termasuk dalamsuccessful_event_count
.