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

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

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

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

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

  • لم تتم تجزئة البيانات قبل تحميلها.
  • لم يتم تنسيق البيانات بشكلٍ سليم قبل تجزئتها.
  • تجري مقارنة مع معدّلات المطابقة في نظام مختلف.
  • أنت تحاول إضافة معرّفات مستخدمين متعددة إلى عنصر 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 في سير عمل "مطابقة العملاء" بدلاً من ذلك.

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

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