Müşteri listesi sorunlarını giderme

Düşük eşleşme oranlarını ve Müşteri Eşleştirme entegrasyonunuzda ortaya çıkabilecek yaygın hataları gidermenize yardımcı olması için bu kılavuzu kullanın.

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 ekleyin.

Reklamverenler, kullanıcılarının Google Arama, Gmail veya YouTube'daki etkinlik düzeyine 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ı ve liste boyutu arasındaki farklar

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

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şlem 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 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, geliştirici jetonunuz daha önce 1 Nisan 2026'dan önce Müşteri Eşleştirme istekleri göndermediyse 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 üzerinden bize ulaşın.