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

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

التحقّق من معدّل المطابقة

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

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

من الممكن أن يصل المعلِن إلى ما بين% 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 يظهر هذا الخطأ إذا لم يسبق أن أرسل الرمز المميز للمطوِّر طلبات "مطابقة العملاء" قبل 1 أبريل 2026. يجب بدلاً من ذلك استخدام Data Manager API في سير عمل "مطابقة العملاء".

مزيد من الدعم لتحديد المشاكل وحلّها

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