Müşteri listesi sorunlarını giderme

Bu kılavuz, düşük eşleşme oranlarını ve Müşteri Eşleştirme entegrasyonunuzda ortaya çıkabilecek yaygın hataları gidermenize yardımcı olur.

Eşleşme oranını doğrulama

Eşleşme oranınızı doğrulamaya çalışmadan önce yükleme işinizin tamamlandığından emin olun.

Eşleşme oranınız, aşağıdakiler de dahil olmak üzere çeşitli nedenlerle beklenenden düşük olabilir:

  • Verilere yüklenmeden önce karma oluşturma işlemi uygulanmamıştır.
  • Verilere karma oluşturma işlemi uygulanmadan önce doğru şekilde biçimlendirilmemiş.
  • Farklı bir sistemdeki eşleşme oranlarıyla karşılaştırma yapıyorsunuz.
  • Tek bir UserIdentifier nesnesine birden fazla kullanıcı tanımlayıcısı eklemeye çalışıyorsunuz. Bunun yerine, bu kod örneğinde gösterildiği gibi tek bir UserData nesnesine birden fazla UserIdentifier nesnesi ekleyin.

Bir reklamverenin, kullanıcılarının Google Arama, Gmail veya YouTube'daki etkinlik düzeyine bağlı olarak listesinin% 1 ila% 99'una ulaşması mümkündür. Düşük eşleşme oranlarıyla ilgili sorunları giderme hakkında daha ayrıntılı bir kılavuz için Yardım Merkezi'ni ziyaret edin.

Eşleşme oranı ile liste boyutu arasındaki farklar

Liste boyutu ve eşleşme oranı farklı değerleri yansıtır. Eşleşme oranı, Müşteri Eşleştirme listesiyle ulaşılamayan Google Hesabı kullanıcılarını da içerir. Liste boyutu, bir Google Hesabı ile eşleşen ve reklam kişiselleştirme yoluyla erişilebilen etkin kullanıcıları sayar.

Sık karşılaşılan hataları ayıklama

Hata
USER_PERMISSION_DENIED Başka bir hesap tarafından oluşturulan bir listeyi değiştirmeye çalışırsanız izin hatalarıyla karşılaşabilirsiniz. Yalnızca kendi hesabınızın oluşturduğu listeleri düzenleyebilirsiniz.
EXTERNAL_UPDATE_ID_ALREADY_EXISTS Bu hata, aynı external_id ile birden fazla iş oluşturmaya çalıştığınızda ortaya çıkabilir.
CONFLICTING_OPERATION Bu hata, tek bir işte remove işlemleri ile create işlemleri karıştırılırsa oluşabilir.
TOO_MANY_USER_IDENTIFIERS Tek bir işteki create işlemleri toplamda 100.000'den fazla user_identifiers içeriyor. İsteği, bu sınırı aşmayan birden fazla isteğe bölün.
CONCURRENT_MODIFICATION Bu hata, aynı listede aynı anda işlem yapmaya çalıştığınızda oluşabilir.
RESOURCE_EXHAUSTED Bu hata, çok fazla istek göndermeye çalıştığınızda oluşabilir. İşlemlerinizi önerilen kullanım akışına göre gruplandırarak bu durumu azaltabilirsiniz. API sınırları ve kotaları ile ilgili en iyi uygulamalar kılavuzuna da göz atabilirsiniz.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Bu hata, Google Cloud projenizde (veya 9 Eylül 2026'da desteği sonlandırılan eski geliştirici jetonunuzda) 1 Ekim 2025 ile 31 Mart 2026 tarihleri arasında Müşteri Eşleştirme isteği olmaması durumunda oluşur. Bunun yerine Müşteri Eşleştirme iş akışları için Data Manager API'yi kullanmanız gerekir.

Ek sorun giderme desteği

Sorun yaşamaya devam ederseniz Müşteri Eşleştirme sorun gidericisi aracılığıyla bize ulaşın.