تخطَّ إلى المحتوى

أصلح أعطال التكاملات

آخر تحديث: ١٨ مارس ٢٠٢٦5 دقيقة قراءةمتوسطالعلامة التجاريةالمطور

إن ظهرت أخطاء في تكاملاتك (Meta CAPI و sGTM و GA4 وغيرها) أو توقّفت عن تمرير الأحداث، فاتّبع هذه الخطوات لتحديد السبب وإصلاحه.

المشكلات الشائعة

  • بيانات اعتماد غير صالحة — قد تكون مفاتيح API أو رموز الوصول قد انتهت صلاحيتها أو أُلغيت
  • انقطاع API المنصّة — قد تواجه المنصّة الوجهة عطلًا من جهتها
  • تجاوز حدّ الطلبات — قد تكون تتخطّى الحدّ المسموح به لطلبات API على المنصّة
  • قاطع الدائرة مفتوح — قد يكون قاطع الدائرة في أرقام٣٦٠ قد فُتح بسبب أعطال متكرّرة
  • مشكلات الشبكة — تعذّر الاتصال من خادم إلى خادم

قاطع الدائرة

إذا فشل التكامل 5 مرات متتالية، يُفتح قاطع الدائرة ويوقف إرسال الأحداث إلى تلك المنصّة مدّة 60 ثانية، فيمنع تتابع الأعطال وهدر طلبات API. ويعود القاطع إلى وضعه تلقائيًا بعد انقضاء هذه المدّة.

إعادة المحاولة

يُعاد إرسال الأحداث الفاشلة تلقائيًا بفواصل زمنية تتضاعف مع كلّ محاولة، ويتولّى عامل خطّ معالجة الأحداث تشغيل طابور إعادة المحاولة. وتجد الأحداث الفاشلة في سجل القرارات.

1

تحقّق من حالة التكامل

افتح تبويب التكاملات وانظر إن كان التكامل يظهر بحالة حمراء أو بعدد من الأخطاء.

2

اختبر الاتصال

انقر 'اختبر الاتصال' لتتأكّد أنّ أرقام٣٦٠ يصل إلى المنصّة.

3

راجع بيانات الاعتماد

تأكّد من لوحة إدارة المنصّة أنّ مفاتيح API والرموز ما زالت صالحة.

4

راجع سجل القرارات

افتح تبويب سجل القرارات لترى أحدث قرارات التمرير وأيّ أخطاء صاحبتها.

5

أعد التفعيل عند الحاجة

إذا عُطّل التكامل تلقائيًا (بعد 10 أعطال)، فأصلح المشكلة ثمّ فعّله من جديد.

يعرض سجل القرارات كلّ قرار تمرير مع نتيجته وزمن استجابته وأيّ رسائل خطأ. وهو أنفع أداة لديك لتشخيص مشكلات التكامل.

هل كانت هذه المقالة مفيدة؟