Izsekošanas fragments ir mazs asinhronais skripts — daži kilobaiti, kas tiek pasniegti no malas kešatmiņā saglabāta pirmās puses ceļa — kas identificē organizāciju aiz katras sesijas. Pareizi instalēts, jūs to nepamanīsit. Nepareizi instalēts, jūs pavadīsit nedēļu, atkļūdojot, kāpēc trūkst identificēto uzņēmumu, pirms atklājat, ka ielādētājs atradās lēni ielādētā sadaļā. Šis ceļvedis palīdzēs jums ietaupīt šo nedēļu.
Trīs principi pirms kaut ko satverat
- Ielādētājam jābūt vietnes mēroga HTML galvenē. Ne kājenē, ne konkrētā lapas veidnē, ne komponentā, kas parādās tikai mārketinga lapās. Galvenē, katrā lapā.
- Ielādētājs pēc noklusējuma ir asinhronais. Nepievienojiet atlikšanas/asinhronās ignorēšanas, kas maina izpildes laiku; komplektā iekļautie atribūti ir tie atribūti, kurus esam pārbaudījuši.
- Instalējiet tieši vienu reizi. Divas ielādētāja kopijas vienā lapā nedubultos jūsu datus — tās dubultos pieprasījumus un padarīs atkļūdošanu mulsinošu.
WordPress
Tīrākā instalācija WordPress izvairās no tēmu rediģēšanas. Izmantojiet galvenes skriptu spraudni (jebkurš labi zināms darbosies), ielīmējiet ielādētāju laukā "skripti galvenē", saglabājiet un notīriet jebkuru lapas kešatmiņu. Ja nevēlaties spraudni, pievienojiet nelielu mu-spraudņa failu, kas pievienojas wp_head ar prioritāti 5, lai ielādētājs nonāktu pirms analītikas tagiem. Neielīmējiet to lapas vai ziņas pamattekstā — WordPress filtrēs skripta tagu.
Viena WordPress specifiska pārbaude: ja izmantojat pilnas lapas kešatmiņu (LiteSpeed, WP Rocket, W3 Total Cache), notīriet kešatmiņu pēc instalēšanas. Kešatmiņā saglabātā HTML no pirms instalēšanas nesatur ielādētāju.
Shopify
Shopify ievieto tēmas HTML failā theme.liquid. Savā Shopify administratora panelī dodieties uz Online Store → Themes → Actions → Edit code → theme.liquid un ielīmējiet ielādētāju tieši pirms aizverošās </head> taga. Saglabājiet. Tas ir viss — nav nepieciešama lietotne, nav kases skripta (kase jebkurā gadījumā ir ārpus uzņēmuma līmeņa identifikācijas jomas).
Vispirms dublējiet tēmu
Pirms rediģējat theme.liquid, izmantojiet Actions → Duplicate. Ja kaut kas noiet greizi, varat atgriezties ar vienu klikšķi. Tas ir piecu sekunžu ieradums, kas ir glābis katru Shopify komandu, kurai mēs to ieteicām.
Webflow
Webflow → Site Settings → Custom Code → Head Code. Ielīmējiet ielādētāju. Saglabājiet. Publicējiet vietni. Galvenes kods tiek lietots visā pasaulē visās lapās, kas ir tieši tas, ko vēlaties. Neielīmējiet ielādētāju lapas līmeņa iegultnē — tad jūs izsekosit tikai šo vienu lapu.
Google Tag Manager
GTM darbojas ar divām piezīmēm. Pirmkārt: izmantojiet pielāgotu HTML tagu, kura aktivizētājs ir iestatīts uz "Visas lapas", lai ielādētājs darbotos ar katru lapas skatījumu. Otrkārt: iestatiet taga prioritāti pietiekami augstu, lai tas tiktu izpildīts pirms citiem analītikas tagiem, kas var aizkavēt sākotnējo datu slodzi. GTM lietotāji bieži vien galvenē sakrauj četrus vai piecus tagus; ielādētājs ir mazs, taču tagu aktivizēšanas secība ir svarīga, ja vēlaties identifikāciju ar pirmo pieprasījumu.
Ņemiet vērā piekrišanas režīmu: ja izmantojat GTM aiz piekrišanas reklāmkaroga, kas aktivizē analītikas tagus tikai pēc piekrišanas, nenovietojiet uzņēmuma līmeņa identifikāciju aiz tās pašas barjeras — tas neizmanto sīkfailus un nesaglabā datus apmeklētāja ierīcē, tāpēc tam nav nepieciešams tāds pats piekrišanas līmenis. Konfigurējiet tagu, lai tas aktivizētos nekavējoties, kopā ar jūsu stingri nepieciešamajiem tagiem.
Vienkāršs HTML / pašu izveidotas sistēmas
Pašbūvētai vietnei vai ietvaram, ko neesam minējuši, ielīmējiet ielādētāju sava pamata veidnes <head> elementā — failā, kas tiek renderēts katrā lapā. Pārbūvējiet un atkārtoti izvietojiet. Statisku vietņu ģeneratoriem ielādētājam jābūt vietnes mēroga izkārtojuma failā (Next.js tas ir <Script> lietotnes līmeņa izkārtojumā ar strategy="afterInteractive"; Astro tas ir <BaseHead> komponents; 11ty tas ir pamata veidnes daļa). Ja esat to pievienojis kā komponenta līmeņa skriptu, ziņos tikai lapas, kas satur šo komponentu.
Vienas lapas lietojumprogrammas — āķis
SPA gadījumā sākotnējais lapas skatījums tiek fiksēts ar ielādētāju, kad lapa pirmo reizi ielādējas. Secīgas klienta puses navigācijas no pārlūkprogrammas viedokļa nav automātiski lapas skatījumi. Mūsu ielādētājs pēc noklusējuma klausās History API, tāpēc navigācijas, kas balstītas uz atpakaļ/uz priekšu un pushState, tiek reģistrētas kā jauni lapas skatījumi, nepievienojot kodu. Ja jūsu SPA izmanto atšķirīgu maršrutētāju, kas apiet History API (reti, bet iespējams), izsauciet mazo dokumentēto pageview funkciju maršruta maiņas gadījumā — trīs rindiņas, atrodamas dokumentācijā.
Pārbaudiet instalāciju divās minūtēs
Verifikācija nav obligāta. Dariet to, pirms aizverat cilni, kurā instalējāt ielādētāju; atklāt bojātu instalāciju piecas minūtes pēc ielīmēšanas ir vienkārši, piecas dienas vēlāk — nē.
- Atveriet savu vietni inkognito logā (lai kešatmiņā saglabātie faili jūs nemulsinātu).
- Atveriet DevTools → Network cilni, filtrējiet pēc "l5e" vai ielādētāja ceļa.
- Atjaunojiet lapu. Jums vajadzētu redzēt vienu pieprasījumu ielādētājam, kam seko viens mazs identifikācijas bāka. Abiem jābūt ar statusu 200. Ielādētāja atbildes galvenēm jāsatur cache-control ar s-maxage un stale-while-revalidate.
- Pārejiet uz otro lapu. Jums vajadzētu redzēt vēl vienu identifikācijas bāku, kas tiek aktivizēta, bez ielādētāja atkārtotas lejupielādes (tā atgriezīs 304).
- Atgriezieties lead.box informācijas panelī, atveriet tiešo apmeklētāju plūsmu un apstipriniet, ka parādās jūsu testa apmeklējums. Ja tā, instalācija ir pabeigta.
Biežākās kļūdas — tabula, ko pārbaudīt vispirms
| Simptoms | Iespējamais cēlonis | Risinājums |
|---|---|---|
| Vispār nav tiešo apmeklējumu | Ielādētājs trūkst galvenē vai atrodas nepareizā veidnē | Pārvietojiet ielādētāju uz vietnes mēroga galvenes veidni |
| Tiešie apmeklējumi tikai no vienas sadaļas | Ielādētājs lapas līmeņa iegultnē, nevis globāli | Pārvietojiet uz globālo galveni / tēmas galveni |
| Ielādētājs ielādējas, bet nav identifikācijas bākas | Piekrišanas reklāmkarogs pārāk agresīvi bloķē trešo pušu skriptus | Konfigurējiet reklāmkarogu, lai atļautu stingri nepieciešamos; ielādētājam nav nepieciešama piekrišana |
| Dubultas bākas uz lapas skatījumu | Ielādētājs instalēts divreiz (tēma + spraudnis/tags) | Noņemiet vienu |
| Lēna pirmā krāsa pēc instalēšanas | Ielādētājs novietots pirms kritiskā CSS | Apstipriniet, ka ir async atribūts; novietojiet pēc kritiskā CSS iepriekšējas ielādes |
| SPA ziņo tikai par pirmo lapu | Pielāgots maršrutētājs apiet History API | Izsauciet dokumentēto pageview() maršruta maiņas gadījumā |
| Novecojis HTML pasniegts bez ielādētāja | Pilnas lapas kešatmiņa nav notīrīta pēc instalēšanas | Notīriet kešatmiņu; pārbaudiet inkognito režīmā |
Veiktspējas piezīme — malas kešatmiņā saglabāts ielādētājs
Ielādētājs tiek pasniegts no pirmās puses ceļa, kas ir proksēts uz mūsu malas kešatmiņu ar s-maxage=300 un stale-while-revalidate. Praksē tas nozīmē, ka ielādētājs tiek izgūts vienu reizi piecās minūtēs katrā malas PoP un pēc tam tiek pasniegts no kešatmiņas katram nākamajam apmeklētājam. Ietekme uz faila lielumu un ielādes laiku ir tik maza, ka mēs neiesakām pievienot papildu ielādes loģiku.
Kad lūgt palīdzību
Ja esat veicis verifikācijas darbības un joprojām kaut kas nav kārtībā, mēs labprātāk to uzzinātu pēc desmit minūtēm, nevis desmit dienām. Nododiet trīs lietas: vietnes URL, tīkla cilnes ekrānuzņēmumu DevTools, filtrētu pēc ielādētāja ceļa, un platformas nosaukumu, kurā instalējāt. Tas ir pietiekami, lai diagnosticētu gandrīz jebkuru instalācijas problēmu ar pirmo atbildi.
Published by
lead.box Team
Vairāk rakstu
Skatiet lead.box darbībā uz savas datplūsmas
Sāciet bez maksas — bez kartes un bez pārdošanas zvana. Vai rezervējiet 20 minūšu demonstrāciju, ja vēlaties apskati ar gidu.