De meting op uw site installeren

Het plaatsen van het script is de enige technische stap in Pulsar. Hier is de exacte procedure voor elke omgeving, ook die met verrassingen.

Kort samengevat

Kopieer de twee scriptregels uit uw instellingen, plak ze in de head van uw pagina's, en de meting start bij het eerste bezoek. Hetzelfde paar regels werkt zowel bij een rechtstreekse plaatsing als via een tagbeheerder.

De twee te kopiëren regels

Open uw site in Pulsar en ga naar Instellingen, Installatie. Het zwarte kader bevat precies wat geplaatst moet worden. Kopieer het geheel: elke regel heeft zijn rol, en er één weglaten breekt bepaalde installaties.

De eerste regel zet de configuratie in een globale variabele en bereidt de wachtrij voor aangepaste gebeurtenissen voor. Hij laadt niets.
De tweede regel laadt het meetscript, asynchroon, met dezelfde configuratie herhaald als data-*-attributen.

De configuratie staat er twee keer met opzet, in de globale variabele en in de attributen. Dat maakt hetzelfde paar regels overal bruikbaar, ook onder een tagbeheerder die attributen verwijdert. Verwijder de regel die u overbodig lijkt dus niet.

Rechtstreekse plaatsing in de HTML

Dit is de betrouwbaarste methode, en die de voorkeur verdient wanneer ze mogelijk is. Het script hangt van geen tussenpersoon af, en niets kan het vertragen of verwijderen.

1 Open de template die de <head> van al uw pagina's aanmaakt.
2 Plak de twee regels vlak voor </head>.
3 Publiceer en laad daarna een pagina van uw site.
4 Ga terug naar Instellingen, Installatie en klik op Testen: Pulsar zegt of er iets is binnengekomen.

WordPress

Drie wegen, van de duurzaamste naar de snelste. De eerste overleeft thema-updates, de andere niet.

Via een plug-in voor code-invoeging. WPCode, Header Footer Code Manager of gelijkaardig. Plak de twee regels in de headerzone, sitebreed toegepast. Dit is de aanbevolen weg: er gaat niets verloren bij een thema-update.
Via de thema-instellingen. Veel thema's bieden een veld « Headerscripts » in de customizer. Handig, maar de inhoud hoort bij het thema: van thema veranderen wist het script.
Via het bestand header.php. Alleen in een childthema. In een parentthema overschrijft de volgende update uw wijziging zonder waarschuwing.

Gebruikt uw site caching, leeg die dan na het plaatsen. Een pagina uit de cache behoudt haar oude HTML, zonder het script, en u zou ten onrechte besluiten dat de installatie mislukt is.

Google Tag Manager, in detail

GTM werkt, maar vraagt een voorzorg waar niets voor waarschuwt. De container injecteert externe scripts zonder hun data-*-attributen over te nemen, en zet document.currentScript op null. Een script dat zijn configuratie uit zijn attributen leest, zou dus niets vinden en zwijgen, zonder enige fout.

Precies daarvoor bestaat de eerste regel. Door beide regels samen te plakken, loopt de configuratie via de globale variabele en werkt de installatie.

1 Open in GTM Tags en daarna Nieuw.
2 Kies het type Aangepaste HTML.
3 Plak beide regels uit uw instellingen, ongewijzigd.
4 Laat document.write ondersteunen uitgevinkt: het script heeft dat niet nodig.
5 Trigger: Alle pagina's, van het type Paginaweergave. Kies de vroegst beschikbare initialisatie om bezoekers die meteen vertrekken niet te verliezen.
6 Noem de tag, sla op en publiceer de container. Een opgeslagen maar niet gepubliceerde tag doet niets.
7 Controleer in de voorbeeldmodus: de tag moet als geactiveerd verschijnen, en het tabblad Netwerk moet een oproep naar het verzameldomein tonen.

Installeren via GTM voegt een afhankelijkheid toe: blokkeert een bezoeker de container, dan blokkeert hij ook uw meting. Blokkeerders viseren GTM veel vaker dan Pulsar. Bij een technisch publiek loopt het verschil met een rechtstreekse plaatsing vaak op tot vijftien procent.

Shopify

1 Open in het beheer Onlinewinkel, Thema's en daarna Code bewerken op het actieve thema.
2 Open layout/theme.liquid.
3 Plak de twee regels vlak voor </head>.
4 Sla op: Shopify publiceert meteen.

De afrekening van Shopify wordt vanaf aparte pagina's geserveerd, waarop dit bestand niet van toepassing is. Afrekenpagina's worden dus niet gemeten, behalve bij abonnementen die scripts in de afrekening toelaten.

Webflow, Wix, Squarespace

Webflow: Projectinstellingen, tabblad Custom code, veld Head code. Publiceer de site opnieuw, aangepaste code is niet actief in de voorvertoning.
Wix: Instellingen, Tracking en analyse, een aangepast hulpmiddel toevoegen, bereik Alle pagina's, plaatsing Head.
Squarespace: Instellingen, Code-injectie, veld Header. Beschikbaar vanaf de Business-abonnementen.

Single-page apps: React, Vue, Next, Nuxt

Niets bijzonders te doen. Het script volgt de navigatiegeschiedenis, inclusief pushState, replaceState en de terugknop: elke weergavewissel telt als een paginaweergave, zonder oproep van u.

Plaats de twee regels in het HTML-basisdocument: index.html voor Vite, app/layout.tsx voor Next met de Script-component in de strategie afterInteractive, app.html voor SvelteKit.

Roep de pixel niet handmatig aan bij elke routewissel: u zou elke weergave dubbel tellen. Het volgen van de geschiedenis is al aanwezig.

Het script vanaf uw eigen domein serveren

Standaard komt het script van het verzameldomein van Pulsar. U kunt het serveren vanaf een subdomein van uzelf, bijvoorbeeld stats.uwsite.com. Het is dan geen bron van derden meer.

Het voordeel is dubbel: het ontsnapt aan de blokkeerlijsten die analysedomeinen viseren, en het hergebruikt een reeds geopende verbinding, wat de paginaweergaven terugwint die bij snelle navigatie verloren gaan. Afhankelijk van het publiek is dat vijf tot twintig procent van de bezoeken.

De instelling staat in Instellingen, Installatie. Het script leidt zijn verzameladres dan af uit zijn eigen oorsprong: de twee getoonde regels worden automatisch bijgewerkt, u hoeft ze alleen opnieuw te kopiëren.

Controleren of alles werkt

De knop Testen in de instellingen bevraagt de verzameling en zegt of er gegevens binnenkomen. Dat is de snelste controle.

Bij twijfel opent u de console van uw browser, tabblad Netwerk, en herlaadt u een pagina van uw site. U moet er een verzoek naar het verzameldomein zien, eindigend op /e.

Geen enkel verzoek. Het script is niet geladen: controleer of het echt in de geserveerde HTML staat, en niet alleen in uw template.
Verzoek geblokkeerd. Een browserextensie filtert het. Test in privénavigatie met uitgeschakelde extensies.
Verzoek verstuurd, geen cijfers. Uw IP-adres staat waarschijnlijk in de uitsluitingen van het account. Dit is de meest voorkomende oorzaak van « het werkt niet » terwijl alles werkt.

Een precieze actie meten

Zodra het script staat, kunt u een gebeurtenis melden vanuit uw code, bijvoorbeeld bij het versturen van een formulier:

pulsar('offerte_verstuurd', { formule: 'pro' })

De oproep werkt zelfs voordat het script volledig is geladen: de eerste regel van het fragment plaatst de oproepen in een wachtrij, en het script verwerkt ze bij aankomst. U kunt hem dus zonder zorgen om volgorde gebruiken.

Een gebeurtenis wordt een gevolgde conversie zodra u ze als doel markeert, met één klik op de ster in het dashboard.

Mist u een antwoord? Schrijf ons. Wij antwoorden zelf en vullen deze gids aan.

Een vraag stellen