Memecahkan masalah daftar pelanggan

Gunakan panduan ini untuk membantu Anda memecahkan masalah rasio kecocokan yang rendah dan error umum yang mungkin muncul dalam integrasi Customer Match Anda.

Memvalidasi tingkat kecocokan

Pastikan tugas upload Anda telah selesai sebelum mencoba memvalidasi rasio kecocokan.

Rasio kecocokan Anda mungkin lebih rendah dari yang diperkirakan karena beberapa alasan, termasuk:

  • Data tidak di-hash sebelum diupload.
  • Data tidak diformat dengan benar sebelum di-hash.
  • Anda membandingkan dengan rasio kecocokan dalam sistem yang berbeda.
  • Anda mencoba menambahkan beberapa ID pengguna ke satu objek UserIdentifier objek. Sebagai gantinya, tambahkan beberapa objek UserIdentifier ke satu objek UserData seperti yang ditunjukkan dalam contoh kode ini.

Pengiklan dapat menjangkau 1% hingga 99% daftarnya, berdasarkan seberapa aktif pengguna mereka di Google Penelusuran, Gmail, atau YouTube. Untuk panduan yang lebih mendetail tentang pemecahan masalah rasio kecocokan yang rendah, buka Pusat Bantuan.

Perbedaan antara rasio kecocokan dan ukuran daftar

Ukuran daftar dan tingkat kecocokan mencerminkan nilai yang berbeda. Tingkat kecocokan menghitung semua pengguna dengan Akun Google, meskipun mereka tidak dapat dijangkau dengan daftar Customer Match. Ukuran daftar menghitung pengguna aktif yang cocok dengan Akun Google dan dapat dijangkau oleh personalisasi Iklan.

Men-debug error umum

Error
USER_PERMISSION_DENIED Anda mungkin mengalami error izin jika mencoba mengubah daftar yang dibuat oleh akun lain. Anda hanya dapat mengedit daftar yang dibuat oleh akun Anda sendiri.
EXTERNAL_UPDATE_ID_ALREADY_EXISTS Error ini dapat terjadi jika Anda mencoba membuat beberapa tugas dengan external_id yang sama.
CONFLICTING_OPERATION Error ini dapat terjadi jika operasi remove dicampur dengan operasi create dalam satu tugas.
TOO_MANY_USER_IDENTIFIERS Operasi create dalam satu tugas berisi lebih dari 100.000 user_identifiers secara total. Bagi permintaan menjadi beberapa permintaan yang tidak melebihi batas tersebut.
CONCURRENT_MODIFICATION Error ini dapat terjadi jika Anda mencoba mengoperasikan daftar yang sama pada waktu yang sama.
RESOURCE_EXHAUSTED Error ini dapat terjadi jika Anda mencoba mengirim terlalu banyak permintaan. Anda dapat mengurangi hal ini dengan mengelompokkan operasi sesuai dengan alur penggunaan yang direkomendasikan. Anda juga dapat membaca panduan praktik terbaik untuk batas dan kuota API.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Error ini terjadi jika project Google Cloud Anda (atau token developer lama, yang tidak digunakan lagi mulai 9 September 2026) tidak memiliki permintaan Customer Match antara 1 Oktober 2025 dan 31 Maret 2026. Anda harus menggunakan Data Manager API untuk alur kerja Customer Match.

Dukungan pemecahan masalah tambahan

Jika Anda masih mengalami masalah, hubungi kami melalui pemecah masalah Customer Match.