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 rasio kecocokan

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

Rasio kecocokan Anda mungkin lebih rendah dari yang diharapkan karena sejumlah alasan, termasuk:

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

Pengiklan dapat menjangkau antara 1% hingga 99% dari daftar mereka, 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 rasio kecocokan mencerminkan nilai yang berbeda. Rasio kecocokan menghitung semua pengguna yang memiliki Akun Google meskipun mereka sebenarnya 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 digabungkan dengan operasi create dalam satu tugas.
TOO_MANY_USER_IDENTIFIERS Operasi create dalam satu tugas berisi total lebih dari 100.000 user_identifiers. Bagi permintaan menjadi beberapa permintaan yang tidak melebihi batas tersebut.
CONCURRENT_MODIFICATION Error ini dapat terjadi jika Anda mencoba beroperasi pada daftar yang sama pada waktu yang sama.
RESOURCE_EXHAUSTED Error ini dapat terjadi jika Anda mencoba mengirim terlalu banyak permintaan. Anda dapat menguranginya 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 pada 9 September 2026) tidak memiliki permintaan Customer Match antara 1 Oktober 2025 dan 31 Maret 2026. Sebagai gantinya, 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.