Pemecahan masalah

Mengelola konversi memerlukan integrasi yang kompleks, yang sering kali melibatkan beberapa alat dan proses yang saling bergantung. Panduan ini menawarkan langkah-langkah mendetail yang dapat Anda lakukan untuk memecahkan masalah yang Anda alami, baik Anda mendapatkan error dari API yang tidak Anda pahami, atau jika Anda bingung dengan metrik atau diagnostik yang Anda lihat di UI.

Membaca metrik di UI Google Ads

Masalah dengan Konversi yang Disempurnakan untuk Prospek

Error yang biasa terjadi

Error
NO_CONVERSION_ACTION_FOUND

Tindakan konversi yang ditentukan tidak diaktifkan, atau tidak dapat diakses oleh akun klien yang ditentukan oleh kolom `client_id` dalam permintaan. Pastikan tindakan konversi dalam upload Anda diaktifkan dan dimiliki oleh pelanggan yang mengirim permintaan upload.

Error ini juga dapat terjadi jika GCLID dalam permintaan adalah milik akun klien yang tidak memiliki akses ke tindakan konversi yang ditentukan dalam permintaan. Anda dapat memverifikasi apakah GCLID milik akun klien menggunakan resource click_view, dengan mengirimkan kueri yang memfilter menurut click_view.gclid dan segments.date, dengan tanggal adalah tanggal klik terjadi.

INVALID_CONVERSION_ACTION_TYPE Tindakan konversi yang ditentukan memiliki jenis yang tidak valid untuk konversi yang disempurnakan untuk prospek. Pastikan ConversionAction yang ditentukan dalam permintaan upload Anda memiliki jenis UPLOAD_CLICKS.
CLICK_CONVERSION_ALREADY_EXISTS Konversi dengan conversion_date_time ini sudah ada untuk klik ini. Pastikan conversion_date_time bersifat unik untuk setiap peristiwa, lalu coba lagi.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Pastikan Anda telah mengaktifkan konversi yang disempurnakan untuk prospek di setelan konversi. Temukan petunjuk untuk melakukannya di panduan prasyarat.
DUPLICATE_ORDER_ID Peristiwa yang diimpor berisi beberapa konversi dengan ID Pesanan yang sama dan tidak diproses. Pastikan ID Pesanan bersifat unik lalu coba lagi.
CLICK_NOT_FOUND Tidak ada klik yang ditemukan yang cocok dengan ID pengguna yang diberikan. Google Ads API hanya menampilkan error ini jika debug_enabled adalah true di UploadClickConversionsRequest.

Jika konversi mengalami peringatan ini, Google Ads API akan menyertakannya dalam successful_event_count diagnostik data offline Anda. Google Ads API menyertakan entri untuk CLICK_NOT_FOUND dalam kumpulan alerts sehingga Anda dapat memantau frekuensi peringatan ini.

Error ini wajar terjadi jika klik tidak berasal dari kampanye Google Ads. Misalnya, data tersebut dapat berasal dari SA360 atau DV360. Kemungkinan penyebab lainnya adalah sebagai berikut:

Dalam kasus yang jarang terjadi, jika pelanggan yang mengupload berbeda dengan pelanggan konversi Google Ads, error ini dapat berarti bahwa pelanggan yang mengupload telah menyetujui persyaratan data pelanggan, tetapi pelanggan yang menayangkan belum.

Anda dapat menentukan apakah akun telah menyetujui persyaratan data pelanggan dengan membuat kueri resource customer dan memeriksa kolom customer.offline_conversion_tracking_info.accepted_customer_data_terms.

Perbedaan metrik

Perhatikan masalah umum berikut:

  • Konversi dapat dihapus oleh pipeline pemrosesan kami karena berbagai alasan, dan konversi tersebut tidak dapat dipulihkan. Lihat artikel Perbedaan data setelah upload yang berhasil untuk mengetahui informasi selengkapnya.

  • Periksa kembali apakah tag Google disiapkan dengan benar di halaman web Anda, dan diaktifkan saat pengiriman formulir prospek. Jika tag Anda tidak diaktifkan saat pengiriman formulir, atau jika tag tersebut mengirimkan data yang salah, Anda mungkin akan melihat atribusi yang rendah, atau tidak ada, dalam konversi yang diupload. Tinjau artikel Pusat Bantuan kami tentang cara mengonfigurasi Tag Google dan mengonfigurasi Google Tag Manager untuk konversi yang disempurnakan untuk prospek.

  • Jika menggunakan konversi yang disempurnakan untuk prospek tanpa tag Google di halaman web, Anda harus menyertakan GCLID dalam impor konversi dengan menetapkan kolom ClickConversion.gclid pada setiap konversi.

  • Pastikan Anda menentukan izin dengan benar dalam upload. Anda dapat melakukannya dengan menetapkan setelan izin default untuk akun Anda, (Di UI Google Ads, klik Alat -> Pengelola Data -> Setelan izin) atau dengan menetapkan kolom ClickConversion.consent di setiap konversi yang diupload.

Masalah terkait performa kampanye

Jika Anda tidak mengalami masalah teknis saat mengupload konversi dan merasa nyaman dengan metrik yang ditampilkan, tetapi tidak melihat peningkatan performa kampanye yang diharapkan, atau "peningkatan", setelah menerapkan konversi yang disempurnakan untuk prospek, hubungi Dukungan Produk Google Ads untuk mendapatkan bantuan.

Masalah pada Konversi yang Disempurnakan untuk Web

Error yang biasa terjadi

Error
CONVERSION_NOT_FOUND Konversi untuk tindakan konversi dan pasangan ID konversi yang diberikan atau order_id tidak dapat ditemukan. Pastikan konversi adalah konversi Google Ads untuk pelanggan konversi Google Ads yang ditentukan dalam customer_id permintaan.
Selain itu, pastikan konversi bukan untuk klik yang mengisi gbraid atau wbraid, bukan gclid. Google Ads tidak mendukung konversi yang disempurnakan untuk web untuk konversi ini.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS Persyaratan dan ketentuan data pelanggan belum disetujui untuk customer_id permintaan. Temukan petunjuk untuk melakukannya di panduan prasyarat.
CONVERSION_ALREADY_ENHANCED Konversi ini telah menerima penyesuaian dengan order_id dan conversion_action yang diberikan. Pastikan untuk memberikan order_id unik untuk setiap konversi.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT conversion_action yang diberikan tidak memenuhi syarat untuk konversi yang disempurnakan untuk web. Di UI Google Ads, pastikan Anda mencentang kotak Aktifkan konversi yang disempurnakan pada tindakan konversi yang dirujuk dalam permintaan Anda. Temukan petunjuknya di Pusat Bantuan.

Masalah umum pengelolaan konversi

Perhatikan masalah umum berikut:

  • Mencoba menetapkan kolom enum ke UNKNOWN akan menghasilkan error RequestError.INVALID_ENUM_VALUE. Ini adalah masalah umum saat menentukan consent saat pengiklan mungkin tidak tahu apakah izin diberikan. Jika status consent tidak diketahui, status tersebut harus ditetapkan ke DENIED.

  • Saat membuat tindakan konversi untuk Konversi aplikasi atau Firebase dan analisis aplikasi pihak ketiga, Anda hanya dapat mengubah kolom app_id saat membuat, setelah tindakan konversi dibuat, kolom ini tidak dapat diubah.

  • Saat membuat tindakan konversi, Anda hanya dapat menetapkan kolom ConversionAction.attribution_model_settings.attribution_model ke GOOGLE_ADS_LAST_CLICK atau GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN. Opsi lain akan menghasilkan error CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Postingan blog kami yang mengumumkan penghentian model atribusi lainnya berisi detail selengkapnya.

  • Rentang yang diizinkan untuk kolom click_through_lookback_window_days adalah [1, 60] untuk tindakan konversi dengan jenis AD_CALL dan WEBSITE_CALL. Untuk sebagian besar tindakan konversi lainnya, rentang yang diizinkan adalah [1, 30].

  • Rentang yang diizinkan untuk kolom view_through_lookback_window_days adalah [1, 30] untuk sebagian besar tindakan konversi. Kolom ini harus tidak ditetapkan untuk tindakan konversi jenis AD_CALL dan WEBSITE_CALL.

  • Menetapkan atau memperbarui kolom include_in_conversion_metrics pada tindakan konversi akan menghasilkan error FieldError.IMMUTABLE_FIELD. Sebagai gantinya, tetapkan kolom primary_for_goal, seperti yang dijelaskan dalam panduan sasaran konversi.

  • Saat membuat tindakan konversi jenis WEBSITE_CALL atau AD_CALL, value_settings.always_use_default_value harus ditetapkan ke true. Menentukan nilai false akan menghasilkan error INVALID_VALUE.

Error yang biasa terjadi

Error
INVALID_CONVERSION_ACTION_TYPE Tindakan konversi yang ditentukan memiliki jenis yang tidak valid untuk mengupload konversi klik. Pastikan ConversionAction yang ditentukan dalam permintaan upload Anda memiliki jenis UPLOAD_CLICKS.
NO_CONVERSION_ACTION_FOUND Tindakan konversi yang ditentukan tidak diaktifkan atau tidak dapat ditemukan dalam customer_id upload. Ambil informasi tentang penyiapan konversi Anda untuk memastikan tindakan konversi dalam upload Anda diaktifkan dan dimiliki oleh customer_id permintaan upload.
TOO_RECENT_CONVERSION_ACTION Tindakan konversi baru saja dibuat. Tunggu minimal 6 jam setelah tindakan dibuat sebelum mencoba lagi konversi yang gagal.
INVALID_CUSTOMER_FOR_CLICK customer_id permintaan bukan ID pelanggan yang sama dengan akun konversi Google Ads API pada saat klik. Perbarui customer_id permintaan ke pelanggan yang benar.
EVENT_NOT_FOUND Google Ads tidak dapat menemukan kombinasi ID klik dan customer_id. Tinjau persyaratan untuk customer_id dan confirmasikan bahwa Anda mengupload menggunakan akun Google Ads yang benar.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST Beberapa konversi dalam permintaan memiliki kombinasi ID klik, conversion_date_time, dan conversion_action yang sama. Hapus konversi duplikat dari permintaan Anda.
CLICK_CONVERSION_ALREADY_EXISTS Konversi dengan kombinasi ID klik, conversion_date_time, dan conversion_action yang sama telah diupload sebelumnya. Abaikan error ini jika Anda mencoba lagi upload dan konversi ini sebelumnya berhasil. Jika Anda ingin menambahkan konversi lain selain konversi yang diupload sebelumnya, sesuaikan conversion_date_time ClickConversion untuk menghindari duplikasi konversi yang diupload sebelumnya.
EVENT_NOT_FOUND Google Ads tidak dapat menemukan kombinasi ID klik dan customer_id. Tinjau persyaratan untuk customer_id dan confirmasikan bahwa Anda mengupload menggunakan akun Google Ads yang benar.
EXPIRED_EVENT Klik yang diimpor terjadi sebelum jangka waktu yang ditentukan di kolom click_through_lookback_window_days. Perubahan pada click_through_lookback_window_days hanya memengaruhi klik yang dicatat setelah perubahan, sehingga mengubah periode lihat balik tidak akan menyelesaikan error ini untuk klik tertentu. Jika sesuai, ubah conversion_action ke tindakan lain dengan periode lihat balik yang lebih lama.
CONVERSION_PRECEDES_EVENT conversion_date_time berada sebelum tanggal dan waktu klik. Perbarui conversion_date_time ke nilai yang lebih baru.
GBRAID_WBRAID_BOTH_SET ClickConversion memiliki nilai yang ditetapkan untuk gbraid dan wbraid. Perbarui konversi agar hanya menggunakan satu ID klik, dan pastikan Anda tidak menggabungkan beberapa klik ke dalam konversi yang sama. Setiap klik hanya memiliki satu ID klik.
VALUE_MUST_BE_UNSET Periksa location dari GoogleAdsError untuk menentukan masalah mana dari berikut ini yang menyebabkan error.
  • ClickConversion memiliki nilai yang ditetapkan untuk gclid serta setidaknya salah satu dari gbraid atau wbraid. Perbarui konversi agar hanya menggunakan satu ID klik, dan pastikan Anda tidak menggabungkan beberapa klik ke dalam konversi yang sama. Setiap klik hanya memiliki satu ID klik.
  • ClickConversion memiliki nilai yang ditetapkan untuk gbraid atau wbraid dan memiliki nilai untuk custom_variables. Google Ads tidak mendukung variabel kustom untuk konversi dengan ID klik gbraid atau wbraid. Hapus penetapan kolom custom_variables konversi.