Tracking-snippettet er et lille async script — på få kilobytes, serveret fra en edge-cached first-party sti — der identificerer organisationen bag hver session. Korrekt installeret bør du aldrig bemærke det. Forkert installeret vil du bruge en uge på at fejlsøge, hvorfor identificerede virksomheder mangler, før du finder ud af, at loaderen lå inde i en lazy-loaded sektion. Denne guide hjælper dig forbi den uge.
Tre principper før du indsætter noget
- Loaderen hører til i sitets globale HTML-head. Ikke i footeren, ikke på en specifik sideskabelon, ikke i en komponent der kun vises på marketing-sider. I head, på hver eneste side.
- Loaderen er async som standard. Tilføj ikke en defer/async override, der ændrer hvornår den kører; de medfølgende attributter er dem, vi har testet.
- Installér præcis én gang. To kopier af loaderen på samme side fordobler ikke dine data — de fordobler anmodningerne og gør fejlsøgning forvirrende.
WordPress
Den reneste installation på WordPress undgår rettelser i temaet. Brug et header-scripts plugin (alle de kendte fungerer), indsæt loaderen i feltet "scripts in head", gem, og tøm din side-cache. Hvis du ikke ønsker et plugin, kan du tilføje en lille mu-plugin fil, der kobler sig på wp_head med prioritet 5, så loaderen lander før analytics-tags. Indsæt den ikke i en sides eller et indlægs brødtekst — WordPress vil filtrere script-tagget fra.
Et specifikt WordPress-tjek: hvis du kører med full-page cache (LiteSpeed, WP Rocket, W3 Total Cache), skal du tømme cachen efter installation. Cached HTML fra før installationen vil ikke indeholde loaderen.
Shopify
Shopify lægger temaets HTML i theme.liquid. I din Shopify admin skal du åbne Online Store → Themes → Actions → Edit code → theme.liquid, og indsætte loaderen umiddelbart før det lukkende </head> tag. Gem. Det er det hele — intet behov for apps eller checkout-scripts (checkout er alligevel uden for rækkevidde for identifikation på virksomhedsniveau).
Duplikér temaet først
Før du redigerer theme.liquid, bør du bruge Actions → Duplicate. Hvis noget går galt, kan du rulle tilbage med ét klik. Dette er en fem-sekunders vane, der har reddet alle Shopify-teams, vi har foreslået det til.
Webflow
Webflow → Site Settings → Custom Code → Head Code. Indsæt loaderen. Gem. Udgiv sitet. Head-koden gælder globalt for alle sider, hvilket er præcis det, du ønsker. Indsæt ikke loaderen i et embed på sideniveau — så vil du kun tracke den enkelte side.
Google Tag Manager
GTM virker, men med to forbehold. For det første skal du bruge et Custom HTML tag med triggeren sat til "All Pages", så loaderen kører ved hver sidevisning. For det andet skal tag-prioriteten være høj nok til, at det affyres før andre analytics-tags, der kunne sløve den oprindelige indlæsning. GTM-brugere har ofte fire-fem tags i head; loaderen er lille, men rækkefølgen betyder noget, hvis du vil have identifikation ved første besøg.
Forbehold om consent-mode: Hvis du kører GTM bag et samtykke-banner, der kun affyrer analytics-tags efter accept, skal du ikke lægge virksomhedsidentifikation bag samme filter — den bruger ikke cookies eller gemmer data på besøgendes enhed, så den kræver ikke samme samtykke. Konfigurér tagget til at affyre med det samme, sammen med dine strengt nødvendige tags.
Ren HTML / specialbyggede løsninger
For et håndkodet site eller et framework, vi ikke har nævnt, skal loaderen indsættes i <head> elementet i din grundskabelon — den fil, der loades på hver side. Build og deploy igen. For statiske site-generatorer hører loaderen hjemme i den globale layout-fil (i Next.js er det et <Script> i layout på app-niveau med strategy="afterInteractive"; i Astro, <BaseHead> komponenten; i 11ty, base template partial). Hvis du tilføjer den som et script på komponentniveau, vil kun sider med den komponent rapportere.
Single-page applications — den ene faldgrube
I en SPA fanges den første sidevisning af loaderen, når siden indlæses første gang. Efterfølgende navigering på klientsiden er ikke automatiske sidevisninger set fra browserens perspektiv. Vores loader lytter til History API som standard, så tilbage/frem og pushState-baseret navigation registreres som nye sidevisninger helt automatisk. Hvis din SPA bruger en ikke-standard router, der går udenom History API (sjældent, men det sker), skal du kalde den lille dokumenterede pageview-funktion ved ruteskift — tre linjer, som findes i dokumentationen.
Verificér installationen på to minutter
Verifikation er ikke valgfrit. Gør det, før du lukker fanen, hvor du installerede loaderen; at opdage en fejl fem minutter efter er nemt, at opdage det fem dage senere er ikke.
- Åbn dit site i et privat/incognito vindue (så du ikke forstyrres af cachede filer).
- Åbn DevTools → Network fanen, filtrér efter "l5e" eller loader-stien.
- Genindlæs siden. Du bør se én anmodning til loaderen og derefter et lille identify-beacon. Begge skal have status 200. Loaderens response headers bør indeholde cache-control med s-maxage og stale-while-revalidate.
- Navigér til en anden side. Du bør se endnu et identify-beacon, men ingen ny download af loaderen (den vil give 304).
- Gå tilbage til lead.box dashboardet, åbn live visitor feed, og bekræft at dit testbesøg vises. Hvis det gør, er installationen færdig.
Typiske fejl — tabellen du bør tjekke først
| Symptom | Sandsynlig årsag | Løsning |
|---|---|---|
| Ingen live besøg overhovedet | Loader mangler i head, eller er på forkert skabelon | Flyt loader til den globale head-skabelon |
| Live besøg kun fra én sektion | Loader i et sidespecifikt embed, ikke globalt | Flyt til global head / temas header |
| Loader indlæses, men intet identify-beacon | Consent-banner blokerer tredjeparts-scripts for aggressivt | Konfigurér banner til at tillade strengt nødvendige; loader kræver ikke samtykke |
| Dobbelt beacons per sidevisning | Loader installeret to gange (tema + plugin/tag) | Fjern den ene |
| Langsom indlæsning efter installation | Loader placeret før kritisk CSS | Bekræft at async-attributten er til stede; placér efter preload af kritisk CSS |
| SPA rapporterer kun den første side | Brugerdefineret router går udenom History API | Kald dokumenteret pageview() ved ruteskift |
| Gammel HTML serveres uden loader | Full-page cache er ikke tømt efter installation | Tøm cache; verificér i incognito |
Performance note — edge-cached loader
Loaderen serveres fra en first-party sti, der er proxied til vores edge cache med s-maxage=300 og stale-while-revalidate. I praksis betyder det, at loaderen hentes én gang hvert femte minut per edge PoP og derefter serveres fra cache til alle efterfølgende besøgende. Den påvirker hastigheden så minimalt, at vi ikke anbefaler at bygge ekstra loading-logik ovenpå den.
Hvornår skal du spørge om hjælp?
Hvis du har fulgt verifikationstrinnene, og noget stadig ikke stemmer, vil vi hellere høre fra dig efter ti minutter end efter ti dage. Hav tre ting klar: sitets URL, et screenshot af DevTools Network fanen filtreret efter loader-stien, og navnet på den platform du installerede på. Det er nok til at diagnosticere næsten alle problemer i første svar.
Udgivet af
lead.box Team
Flere artikler
Se lead.box på din egen trafik
Start gratis — intet kort, intet salgsopkald påkrævet. Eller book en 20-minutters gennemgang, hvis du vil have den guidede tur.