Optionele metingen inschakelen

We zijn er trots op dat we een van de meest lichtgewicht JavaScript-snippets in de analyse-industrie hebben.

We bereiken dat door het aantal opties in het standaardscript radicaal te beperken. In plaats daarvan bieden we verbeterde metingen als optionele scriptextensies die zijn afgestemd op hoe u Histat wilt gebruiken. Deze aanpak zorgt ervoor dat u alleen de code laadt die daadwerkelijk op uw website wordt gebruikt.

U kunt deze optionele metingen inschakelen wanneer u een nieuwe site toevoegt aan uw Histat-account of in het gedeelte 'Site-installatie' van de sectie 'Algemeen' in uw 'site-instellingen'

Het fragment verandert afhankelijk van uw selectie van metingen

Houd er rekening mee dat het trackingfragment dat u in uw site moet invoegen, verandert afhankelijk van uw selectie van verbeterde metingen. Wanneer u wijzigingen aanbrengt in uw optionele metingen, zorg er dan voor dat u het nieuwste fragment in uw site invoegt, zodat alle tracking werkt zoals verwacht

Hier is de lijst met onze optionele metingen:

Optionele meting	Uitleg
Uitgaande links	Automatisch 'kliks op uitgaande links bijhouden'
Bestandsdownloads	Automatisch bestandsdownloads bijhouden
404-foutpagina's	Automatisch 404-foutpagina's bijhouden
Gehashte paginapaden	Automatisch paginapaden bijhouden die een # in de URL gebruiken hash-based routing
Aangepaste gebeurtenissen	Hiermee kunt u aangepaste gebeurtenissen bijhouden zoals klikken op links, formulierverzendingen en klikken op andere HTML-elementen
Aangepaste eigenschappen	Hiermee kunt u aangepaste eigenschappen (ook bekend als aangepaste dimensies in Google Analytics) toevoegen bij het verzenden van een paginaweergave of aangepaste gebeurtenis om aangepaste statistieken te maken
E-commerce-inkomsten	Hiermee kunt u dynamische geldelijke waarden toewijzen aan aangepaste gebeurtenissen en inkomstentoewijzing bijhouden

Geavanceerde trackingopties

Naast de bovenstaande lijst (script.outbound-links.js, script.file-downloads.js, script.hash.js, script.tagged-events.js, script.pageview-props.js en script.revenue.js) hebben we ook een aantal geavanceerdere trackingopties beschikbaar. Let op: deze zijn niet opgenomen in de lijst met onboarding-sites, dus u moet ze handmatig in uw trackingsnippet invoegen.

Uitbreiding	Uitleg
script.compat.js	Compatibiliteitsmodus voor tracking users on Internet Explorer (≥IE11)
script.local.js	Sta analytics toe om ook op localhost te tracken, wat handig is in hybride apps
script.manual.js	Paginaweergaven niet automatisch activeren. Hiermee kunt u ook aangepaste locaties opgeven om URL's met identifiers te redigeren. U kunt het ook gebruiken om aangepaste queryparameters te volgen.

Hoe u het trackingfragment handmatig kunt wijzigen

De standaard scriptnaam in ons fragment is bijvoorbeeld script.js. Als uw website op een localhost staat en u die bezoeken wilt volgen, hebt u de mogelijkheid om het script te laden met een andere extensie: script.local.js.

In dit geval is het fragment dat u in uw site moet invoegen als volgt (zorg ervoor dat u het kenmerk data-domain wijzigt in het domein dat u aan Histat hebt toegevoegd):

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>

U kunt deze extensies naar wens mixen en matchen. Als u bijvoorbeeld zowel onze hash-based routing als onze outbound link click tracking wilt gebruiken, kunt u ze als volgt combineren: script.hash.outbound-links.js.

In dit geval is het fragment dat u in uw site moet invoegen als volgt (zorg ervoor dat u het kenmerk data-domain wijzigt in het domein dat u aan Histat hebt toegevoegd):

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>

Of stel dat u onze extensie script.revenue.js wilt gebruiken om e-commerce-inkomsten bij te houden en onze extensie script.local.js om localhost-verkeer bij te houden, dan zou uw fragment er zo uit moeten zien:

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>

En u hoeft alleen dat ene fragment in uw site in te voegen, verder is er niets nodig.

script.compat.js

Het standaard Histat-script werkt niet op Internet Explorer omdat het de document.currentScript API gebruikt om configuratieopties te lezen. U kunt Histat in de compatibiliteitsmodus uitvoeren door de extensie script.compat.js op te nemen en id="plausible" te definiëren in de scripttag, zodat het zichzelf kan vinden. Let op: dit werkt alleen op ≥ IE11. Dit is hoe het eruit zou moeten zien:

<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>

script.manual.js

Standaard triggert het Histat-script een paginaweergave wanneer het voor het eerst wordt geladen. Het koppelt ook listeners aan de History API en triggert automatisch paginaweergaven wanneer u history.pushState gebruikt. Dit is handig voor de meeste websites, maar we bieden ook een handmatige modus aan als u volledige controle wilt over wanneer paginaweergaven op uw website worden geactiveerd.

Een van de use-cases hiervoor is wanneer u Turbo (voorheen Turbolinks) gebruikt. In dat geval wilt u handmatig Histat-paginaweergaven activeren op de browsergebeurtenis turbo:load of turbolinks:load, afhankelijk van welke bibliotheek u gebruikt. Dit is hoe u dat kunt doen:

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- definieer de functie `plausible` om handmatig gebeurtenissen te activeren -->
<script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>
<!-- trigger pageviews on turbolinks navigation -->
<script>
document.addEventListener("turbo:load", function() {
plausible('pageview')
})
</script>

Wanneer u turbolinks gebruikt, moet u ervoor zorgen dat het Histat-script niet wordt geladen en uitgevoerd tijdens turbonavigatie. Mogelijk moet u het script verplaatsen naar de sectie <head> van uw website of het kenmerk data-turbo-eval="false" gebruiken om dit te doen.

notitie

Bij het gebruik van manual.js resulteert elke scriptaanroep met 'pageview' in een aparte pageview die wordt geteld, zelfs als deze op dezelfde pagina wordt aangeroepen

Geef aangepaste locaties op voor uw pagina-URL's

Bovendien kunt u met de handmatige scriptextensie een speciale optie met de naam u opgeven bij uw gebeurtenissen. Hiermee kunt u de URL van de pagina opgeven en kan deze worden gebruikt om aangepaste locaties op te geven.

Het is vooral handig om meerdere pagina's te redigeren en samen te voegen waarvan de URL's identifiers bevatten die specifiek zijn voor gebruikers.

Volg aangepaste queryparameters voor volledige pagina-URL's

Standaard verwijdert Histat alle queryparameters voor privacydoeleinden ref, source, utm_source, utm_medium, utm_campaign, utm_content en utm_term.

Dit betekent dat pagina's zoals yoursite.com/blog/index.php?article=some_article&page=11 worden gerapporteerd als yoursite.com/blog/index.php in het rapport **Top Pages** van uw Histat-dashboard.