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