Tracking-snippeten är ett litet asynkront skript — några få kilobytes som levereras via en edge-cachad förstaparts-sökväg — som identifierar organisationen bakom varje session. Korrekt installerat bör du aldrig märka av det. Felaktigt installerat kommer du att spendera en vecka med att debugga varför identifierade företag saknas, innan du upptäcker att laddaren låg inuti en lazy-loaded partial. Den här guiden hjälper dig att slippa den veckan.
Tre principer innan du klistrar in något
- Laddaren hör hemma i sajtens globala HTML head. Inte i footern, inte i en specifik sidmall, inte i en komponent som bara renderas på marknadsföringssidor. I head, på varje sida.
- Laddaren är asynkron som standard. Lägg inte till någon defer/async-override som ändrar när den körs; de attribut som levereras är de vi har testat.
- Installera en gång, exakt. Två kopior av laddaren på samma sida dubblar inte din data — de dubblar antalet anrop och förvirrar vid debugging.
WordPress
Den renaste installationen på WordPress undviker tema-ändringar. Använd ett plugin för header-skript (vilket som helst av de välkända fungerar), klistra in laddaren i fältet "scripts in head", spara och rensa eventuell sidcache. Om du inte vill använda ett plugin, lägg till en liten mu-plugin-fil som hakar i wp_head med prioritet 5 så att laddaren landar före analytics-taggar. Klistra inte in den i brödtexten på en sida eller ett inlägg — WordPress kommer att tvätta bort skript-taggen.
En WordPress-specifik kontroll: om du kör en full-page cache (LiteSpeed, WP Rocket, W3 Total Cache), töm cachen efter installationen. Cachad HTML som skapades före installationen kommer inte att innehålla laddaren.
Shopify
Shopify placerar temats HTML i theme.liquid. I din Shopify-admin, öppna Online Store → Themes → Actions → Edit code → theme.liquid, och klistra in laddaren omedelbart före den avslutande </head>-taggen. Spara. Det är allt — inget app-krav, inget checkout-skript (checkout är ändå utanför ramen för identifiering på företagsnivå).
Duplicera temat först
Innan du redigerar theme.liquid, använd Actions → Duplicate. Om något går fel kan du gå tillbaka med ett klick. Detta är en femsekunders-vana som har räddat varje Shopify-team den någonsin föreslagits för.
Webflow
Webflow → Site Settings → Custom Code → Head Code. Klistra in laddaren. Spara. Publicera sajten. Head-koden gäller globalt för alla sidor, vilket är precis vad du vill. Klistra inte in laddaren i en embed på sidnivå — då spårar du bara den enskilda sidan.
Google Tag Manager
GTM fungerar, med två förbehåll. För det första, använd en Custom HTML-tagg med triggern inställd på "All Pages" så att laddaren körs vid varje sidvisning. För det andra, sätt tagg-prioriteten tillräckligt högt så att den avfyras före andra analytics-taggar som kan sakta ner den initiala laddningen. GTM-användare lägger ofta fyra eller fem taggar i head; laddaren är liten, men ordningen för tagg-avfyrning spelar roll om du vill ha identifiering vid första anropet.
Notering om Consent-mode: om du kör GTM bakom en samtyckesbanner som bara avfyrar analytics-taggar efter opt-in, lägg inte företagsidentifiering bakom samma spärr — den använder inte cookies eller lagrar data på besökarens enhet, så den kräver inte samma samtycke. Konfigurera taggen att köras omedelbart, tillsammans med dina strikt nödvändiga taggar.
Ren HTML / eget tech-stack
För en handkodad sajt eller ett ramverk vi inte nämnt, klistra in laddaren inuti <head>-elementet i din basmall — filen som renderas på varje sida. Bygg om och rulla ut. För statiska sajtgeneratorer hör laddaren hemma i den globala layout-filen (i Next.js är det en <Script> i layouten på app-nivå med strategy="afterInteractive"; i Astro, <BaseHead>-komponenten; i 11ty, basmallen). Om du lade till den som ett skript på komponentnivå kommer bara sidor som inkluderar den komponenten att rapportera.
Single-page applications — den enda fällan
I en SPA fångas den initiala sidvisningen av laddaren när sidan först laddas. Efterföljande navigeringar på klientsidan är inte automatiska sidvisningar ur webbläsarens synvinkel. Vår laddare lyssnar på History API som standard, så navigeringar via bakåt/framåt och pushState registreras som nya sidvisningar utan att du behöver skriva någon kod. Om din SPA använder en icke-standardiserad router som går förbi History API (ovanligt, men det händer), anropas den lilla dokumenterade pageview-funktionen vid ruttändring — tre rader, finns i dokumentationen.
Verifiera installationen på två minuter
Verifiering är inte valfritt. Gör det innan du stänger fliken där du installerade laddaren; att upptäcka en trasig installation fem minuter efter inklistring är enkelt, att upptäcka det fem dagar senare är det inte.
- Öppna din sajt i ett privat/inkognito-fönster (så att inga cachade filer förvirrar dig).
- Öppna DevTools → fliken Network, filtrera på "l5e" eller sökvägen till laddaren.
- Ladda om sidan. Du bör se ett anrop till laddaren, sedan en liten identify-beacon. Båda ska ha status 200. Laddarens response headers bör innehålla cache-control med s-maxage och stale-while-revalidate.
- Navigera till en andra sida. Du bör se ytterligare en identify-beacon avfyras, inget nytt nedladdningsanrop av laddaren (den bör ge 304).
- Gå tillbaka till lead.box-dashboarden, öppna live-flödet för besökare och bekräfta att ditt testbesök visas. Om det gör det är installationen klar.
Vanliga misstag — tabellen att kolla först
| Symptom | Trolig orsak | Lösning |
|---|---|---|
| Inga live-besök alls | Laddaren saknas i head, eller ligger på fel mall | Flytta laddaren till den globala head-mallen |
| Live-besök bara från en sektion | Laddaren ligger i en embed på sidnivå, inte globalt | Flytta till global head / tema-header |
| Laddaren laddas men ingen identify-beacon | Samtyckesbanner blockerar tredjepartsskript för aggressivt | Konfigurera bannern att tillåta strikt nödvändiga; laddaren behöver inte samtycke |
| Dubbla beacons per sidvisning | Laddaren installerad två gånger (tema + plugin/tagg) | Ta bort en av dem |
| Långsam first paint efter installation | Laddaren placerad före kritisk CSS | Bekräfta att async-attributet finns; placera efter preload av kritisk CSS |
| SPA rapporterar bara första sidan | Egen router går förbi History API | Anropa dokumenterad pageview() vid ruttändring |
| Gammal HTML visas utan laddare | Full-page cache inte tömd efter installation | Töm cachen; verifiera i inkognito |
Prestandanotering — edge-cachad laddare
Laddaren levereras från en förstaparts-sökväg proxied till vår edge-cache med s-maxage=300 och stale-while-revalidate. I praktiken betyder det att laddaren hämtas en gång var femte minut per edge PoP, och sedan serveras från cache till varje efterföljande besökare. Påverkan på laddningstid och vikt är så liten att vi inte rekommenderar att lägga till extra logik för laddning ovanpå den.
När du ska be om hjälp
Om du har gått igenom verifieringsstegen och något fortfarande inte stämmer, hör vi hellre från dig efter tio minuter än efter tio dagar. Ta med tre saker: sajtens URL, en skärmdump av DevTools Network-fliken filtrerad på laddarens sökväg, och namnet på plattformen du installerade på. Det räcker för att diagnostisera nästan alla installationsproblem redan vid första svaret.
Publicerat av
lead.box Team
Fler artiklar
Se lead.box på din egen trafik
Börja gratis — inget kort, inget säljsamtal krävs. Eller boka en 20-minuters genomgång om du vill ha en guidad tur.