Sekimo fragmentas yra mažas asinchroninis scenarijus – keli kilobaitai, pateikiami iš kraštinio talpyklos pirmojo šalies kelio – kuris identifikuoja kiekvienos sesijos organizaciją. Tinkamai įdiegus, jo nepastebėsite. Neteisingai įdiegus, savaitę derinsite, kodėl trūksta identifikuotų įmonių, kol suprasite, kad įkėlimo programa buvo tingiai įkeltame skyriuje. Šis vadovas padės jums sutaupyti tą savaitę.
Trys principai prieš ką nors įklijuojant
- Įkėlimo programa turi būti visos svetainės HTML antraštėje. Ne poraštėje, ne konkrečiame puslapio šablone, ne komponente, kuris rodomas tik rinkodaros puslapiuose. Antraštėje, kiekviename puslapyje.
- Įkėlimo programa pagal numatytuosius nustatymus yra asinchroninė. Nepridėkite atidėjimo/asinchroninio perrašymo, kuris pakeistų vykdymo laiką; pateikti atributai yra tie atributai, kuriuos mes išbandėme.
- Įdiekite tik vieną kartą. Dvi įkėlimo programos kopijos tame pačiame puslapyje nedvigubins jūsų duomenų – jos padvigubins užklausas ir sukels painiavą derinant.
WordPress
Švariausias diegimas „WordPress“ sistemoje leidžia išvengti temų redagavimo. Naudokite antraštės scenarijų papildinį (bet kuris gerai žinomas tiks), įklijuokite įkėlimo programą į lauką „scripts in head“, išsaugokite ir išvalykite bet kokią puslapio talpyklą. Jei nenorite papildinio, pridėkite nedidelį mu-papildinio failą, kuris prisijungia prie wp_head su 5 prioriteto, kad įkėlimo programa būtų įkelta prieš analizės žymas. Neklijuokite jos į puslapio ar įrašo turinį – „WordPress“ išfiltruos scenarijaus žymą.
Vienas „WordPress“ specifinis patikrinimas: jei naudojate viso puslapio talpyklą („LiteSpeed“, „WP Rocket“, „W3 Total Cache“), išvalykite talpyklą po įdiegimo. Talpykloje esantis HTML prieš įdiegimą neapims įkėlimo programos.
Shopify
„Shopify“ temų HTML talpina „theme.liquid“ faile. „Shopify“ administratoriaus skydelyje eikite į „Online Store“ → „Themes“ → „Actions“ → „Edit code“ → „theme.liquid“ ir įklijuokite įkėlimo programą tiesiai prieš uždaromąją </head> žymą. Išsaugokite. Tai viskas – nereikia jokios programėlės, jokio atsiskaitymo scenarijaus (atsiskaitymas vis tiek nepatenka į įmonės lygio identifikavimo sritį).
Pirmiausia dubliuokite temą
Prieš redaguodami theme.liquid, naudokite Actions → Duplicate. Jei kas nors nutiks ne taip, galėsite grįžti vienu paspaudimu. Tai penkių sekundžių įprotis, kuris išgelbėjo kiekvieną Shopify komandą, kuriai jį rekomendavome.
Webflow
Webflow → Svetainės nustatymai → Pasirinktinis kodas → Antraštės kodas. Įklijuokite įkėlimo programą. Išsaugokite. Paskelbkite svetainę. Antraštės kodas bus pritaikytas visame pasaulyje visiems puslapiams, o tai yra būtent tai, ko norite. Neklijuokite įkėlimo programos į puslapio lygio įterptąjį elementą – tokiu atveju stebėsite tik tą vieną puslapį.
Google Tag Manager
GTM veikia, su dviem išlygomis. Pirma: naudokite pasirinktinę HTML žymą, kurios paleidiklis nustatytas į „All Pages“, kad įkėlimo programa veiktų su kiekvienu puslapio peržiūra. Antra: nustatykite žymos prioritetą pakankamai aukštą, kad ji būtų vykdoma prieš kitas analizės žymas, kurios gali sulėtinti pradinį duomenų perdavimą. GTM vartotojai dažnai sukrauna keturias ar penkias žymas antraštėje; įkėlimo programa yra maža, tačiau žymų paleidimo tvarka yra svarbi, jei norite identifikavimo pirmuoju prašymu.
Atkreipkite dėmesį į sutikimo režimą: jei naudojate GTM už sutikimo reklamjuostės, kuri paleidžia analizės žymas tik po sutikimo, nestatykite įmonės lygio identifikavimo už tos pačios barjeros – ji nenaudoja slapukų ir nesaugo duomenų lankytojo įrenginyje, todėl jai nereikia to paties sutikimo lygio. Sukonfigūruokite žymą, kad ji būtų paleista nedelsiant, kartu su jūsų griežtai būtinosiomis žymomis.
Paprastas HTML / nuosavi paketai
Savo sukurtai svetainei arba sistemai, kurios nepaminėjome, įklijuokite įkėlimo programą į savo pagrindinio šablono <head> elementą – failą, kuris atvaizduojamas kiekviename puslapyje. Perkurkite ir iš naujo įdiekite. Statinėms svetainių generatoriams įkėlimo programa turi būti visos svetainės išdėstymo faile (Next.js atveju tai yra <Script> programos lygio išdėstyme su strategy="afterInteractive"; Astro atveju – <BaseHead> komponentas; 11ty atveju – pagrindinio šablono dalis). Jei ją pridėjote kaip komponento lygio scenarijų, pranešimus teiks tik tie puslapiai, kuriuose yra tas komponentas.
Vieno puslapio programos – kabliukas
SPA atveju pradinis puslapio peržiūra užfiksuojama įkėlimo programa, kai puslapis įkeliamas pirmą kartą. Vėlesnės kliento pusės navigacijos nėra automatinės puslapio peržiūros naršyklės požiūriu. Mūsų įkėlimo programa pagal numatytuosius nustatymus klausosi History API, todėl navigacijos atgal/pirmyn ir pushState pagrindu registruojamos kaip naujos puslapio peržiūros, nereikalaujant pridėti kodo. Jei jūsų SPA naudoja nestandartinį maršrutizatorių, kuris apeina History API (reta, bet įmanoma), iškvieskite mažą dokumentuotą pageview funkciją maršruto pasikeitimo metu – trys eilutės, kurias rasite dokumentacijoje.
Patikrinkite diegimą per dvi minutes
Patvirtinimas nėra pasirinktinis. Atlikite tai prieš uždarydami skirtuką, kuriame įdiegėte įkėlimo programą; sugedusį diegimą aptikti penkias minutes po įklijavimo yra lengva, o po penkių dienų – ne.
- Atidarykite savo svetainę inkognito lange (kad talpykloje esantys failai jūsų neklaidintų).
- Atidarykite DevTools → Tinklo skirtuką, filtruokite pagal „l5e“ arba įkėlimo programos kelią.
- Atnaujinkite puslapį. Turėtumėte matyti vieną užklausą į įkėlimo programą, po kurios seka vienas mažas identifikavimo švyturys. Abiejų būsena turi būti 200. Įkėlimo programos atsako antraštėse turi būti „cache-control“ su „s-maxage“ ir „stale-while-revalidate“.
- Pereikite į antrą puslapį. Turėtumėte matyti, kad paleidžiamas dar vienas identifikavimo švyturys, be pakartotinio įkėlimo programos atsisiuntimo (jis grąžins 304).
- Grįžkite į lead.box prietaisų skydelį, atidarykite tiesioginių lankytojų srautą ir patvirtinkite, kad jūsų bandomasis apsilankymas rodomas. Jei taip, diegimas baigtas.
Dažniausios klaidos – lentelė, kurią reikia patikrinti pirmiausia
| Simptomas | Tikėtina priežastis | Sprendimas |
|---|---|---|
| Visiškai nėra tiesioginių apsilankymų | Įkėlimo programa trūksta antraštėje arba yra netinkamame šablone | Perkelkite įkėlimo programą į visos svetainės antraštės šabloną |
| Tiesioginiai apsilankymai tik iš vieno skyriaus | Įkėlimo programa įterpta puslapio lygio, o ne globaliai | Perkelkite į globalią antraštę / temos antraštę |
| Įkėlimo programa įkeliama, bet nėra identifikavimo švyturio | Sutikimo reklamjuostė per agresyviai blokuoja trečiųjų šalių scenarijus | Konfigūruokite reklamjuostę, kad leistų griežtai būtinus; įkėlimo programai nereikia sutikimo |
| Dvigubi švyturiai vienam puslapio peržiūrai | Įkėlimo programa įdiegta du kartus (tema + papildinys/žyma) | Pašalinkite vieną |
| Lėtas pirmasis atvaizdavimas po įdiegimo | Įkėlimo programa įdėta prieš kritinį CSS | Patvirtinkite, kad yra asinchroninis atributas; įdėkite po kritinio CSS išankstinio įkėlimo |
| SPA praneša tik apie pirmąjį puslapį | Pasirinktinis maršrutizatorius apeina History API | Iškvieskite dokumentuotą pageview() maršruto pasikeitimo metu |
| Pasenęs HTML pateikiamas be įkėlimo programos | Viso puslapio talpykla neišvalyta po įdiegimo | Išvalykite talpyklą; patikrinkite inkognito režimu |
Našumo pastaba – kraštinio talpyklos įkėlimo programa
Įkėlimo programa pateikiama iš pirmojo šalies kelio, kuris yra nukreiptas į mūsų kraštinio talpyklos serverį su s-maxage=300 ir stale-while-revalidate. Praktiškai tai reiškia, kad įkėlimo programa atsiunčiama vieną kartą per penkias minutes iš kiekvieno kraštinio taško ir tada pateikiama iš talpyklos kiekvienam vėlesniam lankytojui. Poveikis failo dydžiui ir įkėlimo laikui yra toks mažas, kad nerekomenduojame pridėti papildomos įkėlimo logikos.
Kada kreiptis pagalbos
Jei atlikote patvirtinimo veiksmus ir vis dar kažkas negerai, norėtume tai išgirsti po dešimties minučių, o ne po dešimties dienų. Pateikite tris dalykus: svetainės URL, tinklo skirtuko ekrano kopiją DevTools, filtruotą pagal įkėlimo programos kelią, ir platformos, kurioje įdiegėte, pavadinimą. To pakanka, kad būtų galima diagnozuoti beveik bet kokią diegimo problemą jau pirmuoju atsakymu.
Published by
lead.box Team
Daugiau straipsnių
Pamatykite lead.box su savo pačių srautu
Pradėkite nemokamai — be kortelės, be privalomo pardavimų skambučio. Arba rezervuokite 20 minučių demonstraciją, jei norite ekskursijos su gidu.