كيفية إصلاح أخطاء تثبيت عامل الخدمة

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

لقد قمنا بتجميع دليل يتضمن مشكلات شائعة مختلفة تتعلق بملف عامل الخدمة أثناء تثبيت PushEngage وكيف يمكنك إصلاح هذه المشكلات.

قبل البدء

• يجب عليك تجنب عمليات إعادة التوجيه ؛ يجب أن يكون ملف service-worker.js متاحًا للعامة (https://www.mywebsite.com/service-worker.js). إذا كان هناك أي إعادة توجيه عند محاولة زيارة ملف service-worker.js، فإن التثبيت الخاص بك غير صحيح، وسيفشل الاشتراك أيضًا.
• إذا رأيت خطأ 403 أو 404 بعد محاولة الاشتراك في موقعك، فهناك شيء يمنع ملفات عامل خدمة PushEngage من أن تكون متاحة بشكل علني. يمكنك التحقق من ذلك عن طريق زيارة لوحة تحكم PushEngage الخاصة بك أو وحدة تحكم المتصفح لديك. يجب كتابة هذه الملفات بأحرف كبيرة، وليس كإعادة توجيه. يجب أن تكون هذه الصفحات متاحة لك دون أي مشاكل.
• من الضروري دمج عمال الخدمة إذا كنت تدمج PushEngage في موقع ويب يحتوي بالفعل على عامل خدمة (مثل PWA) لكي يعمل PushEngage بشكل صحيح. يساعدك هذا الدليل في دمج عامل خدمة PushEngage مع عامل الخدمة الموجود على موقع الويب الخاص بك.

مشكلات مع عامل الخدمة وحلولها

الخطأ 1: عنوان URL غير صحيح لملف عامل الخدمة

TypeError: فشل في تسجيل عامل خدمة للنطاق (https://xxxx) مع البرنامج النصي (https://www). تم تلقي رمز استجابة HTTP سيئ (404) عند جلب البرنامج النصي.

الحل: تحقق من أن اسم ملف عامل الخدمة وموقعه يتطابقان مع القيمة من لوحة تحكم PushEngage الخاصة بك عن طريق الانتقال إلى إعدادات الموقع » الإعدادات المتقدمة » إعدادات عامل الخدمة

الخطأ 2: لا يمتلك المتصفح إذنًا لقراءة ملف عامل الخدمة

TypeError: فشل في تسجيل عامل خدمة ('https://xxx') مع البرنامج النصي ('https://xxxx'): تم تلقي رمز استجابة HTTP سيئ (403) عند جلب البرنامج النصي.

الحل: تحقق من تكوين خادم الويب مع مزود خدمة استضافة الويب للتأكد من أن التكوين يسمح بالوصول للقراءة إلى ملف عامل الخدمة وأن الملف متاح للعامة من الإنترنت.

لا يمكن لفريق PushEngage مساعدتك في تغيير الأذونات، فقط شركة الاستضافة أو فريق التطوير لديك يمكنهم مساعدتك في إصلاح هذه الأذونات.

الخطأ 3: فشل في تنفيذ ‘importScripts’

Uncaught DOMException: فشل في تنفيذ 'importScripts' على 'WorkerGlobalScope'. فشل تحميل البرنامج النصي في (https://xxxxxx) في (https://www).

الحل:  يستخدم ملف الـ Service Worker اسم نطاق فرعي غير صحيح في عبارة importScripts (https://xxxx.pushengage.com) داخل ملف الـ Service Worker. لذا، تأكد من أن عبارة importScript تستخدم النطاق الفرعي الصحيح لـ PushEngage المعين للموقع.

قيمة المعلمة الاستعلامية للنطاق في عنوان URL الخاص بالـ Service Worker غير صحيحة. ينطبق هذا فقط على المواقع التي تستخدم إضافة WordPress.

الخطأ 4:  فشل تسجيل Service Worker

DOMException: فشل تسجيل Service Worker للنطاق (https://www) باستخدام البرنامج النصي (https://xxxxxxxx). المسار المحدد للنطاق ('xxx') ليس ضمن أقصى نطاق مسموح به ('xxxxxxx'). اضبط النطاق، أو انقل البرنامج النصي الخاص بالـ Service Worker، أو استخدم رأس HTTP Service-Worker-Allowed للسماح بالنطاق.

الحل:  انقل ملف الـ Service Worker إلى الدليل الجذر وقم بتحديث مسار الـ Service Worker من خلال هذا الدليل.
بعد الانتهاء من ذلك، قم بتعيين قيمة رأس HTTP Service-Worker-Allowed إلى ‘/’ للطلبات إلى ملف الـ Service Worker.

إذا واجهت أي مشاكل، يرجى الاتصال بنا بالنقر هنا. سيكون فريق الدعم لدينا قادرًا على مساعدتك.