تحديد مشاكل قائمة العملاء وحلّها

استخدِم هذا الدليل لمساعدتك في تحديد المشاكل وحلّها المتعلقة بنِسب المطابقة المنخفضة والأخطاء الشائعة التي قد تظهر في عملية دمج "مطابقة العملاء".

التحقّق من صحة نسبة المطابقة

تأكَّد من اكتمال مهمة التحميل قبل محاولة التحقّق من صحة نسبة المطابقة.

قد تكون نسبة المطابقة أقل من المتوقع لعدة أسباب، من بينها:

  • لم تتم تجزئة البيانات قبل تحميلها.
  • لم يتم تنسيق البيانات بشكل صحيح قبل تجزئتها.
  • أنت تقارن بنسب المطابقة في نظام مختلف.
  • أنت تحاول إضافة معرّفات مستخدمين متعددة إلى عنصر UserIdentifier واحد. بدلاً من ذلك، أضِف عناصر UserIdentifier متعددة إلى عنصر UserData واحد كما هو موضّح في مثال الرمز هذا.

يمكن للمعلن الوصول إلى نسبة تتراوح بين %1 و%99 من قائمته، استنادًا إلى مدى نشاط المستخدمين على "بحث Google" أو Gmail أو YouTube. للحصول على دليل أكثر تفصيلاً حول تحديد المشاكل وحلّها في ما يتعلّق بنسب المطابقة المنخفضة، يُرجى الانتقال إلى مركز المساعدة.

الاختلافات بين نسبة المطابقة وحجم القائمة

يعكس حجم القائمة ونسبة المطابقة قيمًا مختلفة. تحتسب نسبة المطابقة جميع المستخدمين الذين لديهم حساب Google حتى إذا لم يكن من الممكن الوصول إليهم فعليًا باستخدام قائمة "مطابقة العملاء". يحتسب حجم القائمة عدد المستخدمين النشطين الذين تطابقوا مع حساب Google ويمكن الوصول إليهم من خلال تخصيص الإعلانات.

تصحيح الأخطاء الشائعة

خطأ
USER_PERMISSION_DENIED قد تظهر لك أخطاء في الأذونات إذا حاولت تعديل قائمة تم إنشاؤها بواسطة حساب آخر. يمكنك فقط تعديل قائمة أنشأها حسابك.
EXTERNAL_UPDATE_ID_ALREADY_EXISTS يمكن أن يحدث هذا الخطأ إذا حاولت إنشاء وظائف متعددة باستخدام السمة external_id نفسها.
CONFLICTING_OPERATION يمكن أن يحدث هذا الخطأ إذا تم خلط عمليات remove مع عمليات create في مهمة واحدة.
TOO_MANY_USER_IDENTIFIERS تحتوي عمليات create في مهمة واحدة على أكثر من 100,000 user_identifiers في المجموع. قسِّم الطلب إلى طلبات متعددة لا تتجاوز هذا الحدّ.
CONCURRENT_MODIFICATION يمكن أن يحدث هذا الخطأ إذا حاولت العمل على القائمة نفسها في الوقت نفسه.
RESOURCE_EXHAUSTED يمكن أن يحدث هذا الخطأ إذا حاولت إرسال عدد كبير جدًا من الطلبات. يمكنك الحدّ من ذلك من خلال تجميع عملياتك وفقًا لمسار الاستخدام المقترَح. يمكنك أيضًا الرجوع إلى دليل أفضل الممارسات حول حدود واجهة برمجة التطبيقات وحصصها.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE يحدث هذا الخطأ إذا لم يتضمّن مشروعك على Google Cloud (أو الرمز المميّز القديم للمطوّر، الذي تم إيقافه نهائيًا في 9 سبتمبر 2026) أي طلبات لمطابقة العملاء بين 1 أكتوبر 2025 و31 مارس 2026. يجب استخدام Data Manager API في سير عمل "مطابقة العملاء" بدلاً من ذلك.

دعم إضافي لتحديد المشاكل وحلّها

إذا استمرّت المشاكل، يُرجى التواصل معنا من خلال أداة حلّ المشاكل في "مطابقة العملاء".