Müşteri listesi sorunlarını giderme

Müşteri Eşleştirme entegrasyonunuzda ortaya çıkabilecek düşük eşleşme oranlarını ve yaygın hataları gidermek için bu kılavuzdan yararlanabilirsiniz.

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ış.
  • Veriler, 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ı kimliği eklemeye çalışıyorsunuz. Bunun yerine, bu kod örneğinde gösterildiği gibi tek bir UserData nesnesine birden fazla UserIdentifier nesnesi ekleyin.

Reklamverenler, kullanıcılarının Google Arama, Gmail veya YouTube'da ne kadar etkin olduğuna bağlı olarak listelerinin %1 ila %99'una ulaşabilir. 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şılamayanlar da dahil olmak üzere Google Hesabı olan tüm kullanıcıları sayar. Liste boyutu, bir Google Hesabı ile eşleşen ve reklam kişiselleştirme ile 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 ortaya çıkabilir.
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ı anda aynı liste üzerinde işlem yapmaya çalışırsanız ortaya çıkabilir.
RESOURCE_EXHAUSTED Çok fazla istek göndermeye çalışırsanız bu hata oluşabilir. Önerilen kullanım akışına göre işlemlerinizi toplu olarak gerçekleştirerek bu sorunu 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 projenizin (veya 9 Eylül 2026'da desteği sonlandırılan eski geliştirici jetonunuzun) 1 Ekim 2025 ile 31 Mart 2026 arasında Müşteri Eşleştirme isteği olmaması durumunda ortaya çıkar. 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 üzerinden bize ulaşın.