Remarque : Il n'y a pas de documentation héritée disponible pour cet élément, vous voyez donc la documentation actuelle.
Nous souhaitons que votre installation WordPress PushEngage soit transparente, mais vous pouvez toujours rencontrer des problèmes. Le Service Worker est le fichier clé pour collecter les abonnés aux notifications push et envoyer des campagnes push.
Nous avons compilé un guide avec divers problèmes courants liés au fichier Service Worker lors de l'installation de PushEngage et comment vous pouvez résoudre ces problèmes.
Avant de commencer
- Vous devez éviter les redirections ; le fichier service-worker.js doit être accessible publiquement (https://www.monsite.com/service-worker.js). S'il y a une redirection lorsque vous essayez de visiter le fichier service-worker.js, votre installation est incorrecte et l'abonnement échouera également.
- Si vous voyez une erreur 403 ou 404 après avoir tenté de vous abonner à votre site, quelque chose empêche les fichiers Service Worker de PushEngage d'être ouvertement accessibles. Vous pouvez vérifier cela en visitant votre tableau de bord PushEngage ou votre console de navigateur. Ces fichiers doivent être écrits en majuscules, pas comme des redirections. Ces pages doivent vous être accessibles sans aucun problème.
- Il est nécessaire de fusionner les Service Workers si vous intégrez PushEngage dans un site Web qui possède déjà un Service Worker (comme une PWA) pour que PushEngage fonctionne correctement. Ce guide vous aide à fusionner le Service Worker PushEngage avec le Service Worker existant sur votre site Web.
Problèmes avec le Service Worker et leurs solutions
Erreur 1 : URL incorrecte du fichier Service Worker
TypeError : Échec de l'enregistrement d'un ServiceWorker pour la portée (https://xxxx) avec le script (https://www). Un code de réponse HTTP incorrect (404) a été reçu lors de la récupération du script.
Solution : Vérifiez que le nom et l'emplacement du fichier Service Worker correspondent à la valeur de votre tableau de bord PushEngage en accédant à Paramètres du site » Paramètres avancés » Paramètres du Service Worker
Erreur 2 : Le navigateur n'a pas la permission de lire le fichier Service Worker
TypeError : Échec de l'enregistrement d'un ServiceWorker pour la portée ('https://xxx') avec le script ('https://xxxx') : Un code de réponse HTTP incorrect (403) a été reçu lors de la récupération du script.
Solution : Vérifiez la configuration du serveur Web auprès du fournisseur de services d'hébergement Web pour vous assurer que la configuration autorise l'accès en lecture au fichier Service Worker et que le fichier est accessible publiquement depuis Internet.
L'équipe PushEngage ne peut pas vous aider à modifier les permissions, seule votre société d'hébergement ou votre équipe de développement peut vous aider à corriger ces permissions.
Erreur 3 : Échec de l'exécution de ‘importScripts’
Uncaught DOMException : Échec de l'exécution de 'importScripts' sur 'WorkerGlobalScope'. Le script à (https://xxxxxx) n'a pas pu être chargé à (https://www).
Solution : Le fichier Service Worker utilise un nom de sous-domaine incorrect dans l'instruction importScripts (https://xxxx.pushengage.com) à l'intérieur du fichier Service Worker. Assurez-vous donc que l'instruction importScript utilise le sous-domaine PushEngage correct attribué au site.
La valeur du paramètre de requête de domaine dans l'URL du Service Worker est incorrecte. Ceci s'applique uniquement aux sites utilisant le plugin WordPress.
Erreur 4 : Échec de l'enregistrement d'un Service Worker
DOMException : Échec de l'enregistrement d'un Service Worker pour la portée (https://www) avec le script (https://xxxxxxxx). Le chemin de la portée fournie ('xxx') n'est pas sous la portée maximale autorisée ('xxxxxxx'). Ajustez la portée, déplacez le script du Service Worker ou utilisez l'en-tête HTTP Service-Worker-Allowed pour autoriser la portée.
Solution : Déplacez le fichier du service worker vers le répertoire racine et mettez à jour le chemin du service worker via ce guide.
Une fois que vous avez fait cela, définissez la valeur de l'en-tête HTTP Service-Worker-Allowed sur ‘/’ pour les requêtes vers le fichier du service worker.
Si vous rencontrez des problèmes, veuillez nous contacter en cliquant ici. Notre équipe de support sera en mesure de vous aider.
