Docs / Utvecklare
Felsök installation
Börja med Install Doctor i dashboarden. Den kontrollerar SDK, worker, scope och en testprenumerationsväg.
Bara HTTPS
Webbläsare slår inte på Push på osäker HTTP. Det finns ingen HTTP-subdomänproxy. Serva den riktiga origin på HTTPS.
Origin-allowlist
Sajtorigin i EngageNudge måste matcha origin i adressfältet (scheme + host + port). www mot apex är en mismatch. Parkoppling och SDK misslyckas tills de matchar.
Service worker
| Symptom | Kontrollera |
|---|---|
| Worker 404 | Filen saknas på /en-sw.js. Permalänkar, CDN eller hosting-rewrite. |
| Fel scope | Workern måste styra /, inte bara en underkatalog. |
| Styr inte sidan | Gammal worker. Avregistrera i DevTools → Application, hårduppdatera, rensa CDN. |
| GTM grön SDK, röd worker | Förväntat om /en-sw.js saknas. GTM kan inte installera den. |
| Worker 403, eller HTML där JavaScript ska vara | Ett botfilter utmanar förfrågan. Se nedan. |
Merge: importScripts('/en-sw.js'); högst upp i befintlig root-worker.
När ett botfilter står framför filen
Cloudflare, de flesta brandväggar och flera hostingplattformar utmanar förfrågningar som inte ser ut att komma från en människa. En utmaning på /en-sw.js returnerar en HTML-sida i stället för JavaScript, service workern registreras aldrig, och ingenting i dashboarden säger det. Besökare blir helt enkelt aldrig prenumeranter.
Öppna https://din-origin/en-sw.js i en webbläsare. JavaScript betyder att allt är bra. HTML, en kontrollsida eller en 403 betyder att filen utmanas.
Lösningen är en regel som släpper igenom just den sökvägen. I Cloudflare: Security → WAF → Custom rules, matcha http.request.uri.path eq "/en-sw.js" och välj Skip. Matcha exakt sökväg i stället för en delsträng, så undantaget täcker workern och ingenting annat.
Kör du ett webbappmanifest för iOS hemskärm, ge /manifest.json samma behandling.
CSP
Blockerat script eller worker syns som SDK inte laddad eller worker HTTP-fel. Se CSP.
Tillstånd nekat
Besökaren (eller du) blockerade notiser. Chrome kommer ihåg det. Återställ sajttillstånd. På iOS måste sajten ligga på hemskärmen först. Se Opt-in.
Testutskick gör inget
Registrera en testenhet efter att ni tillåtit notiser. Testutskick når bara de prenumeranterna.