Het trackingscript van Flowsery Analytics ondersteunt verschillende data-attributen om het trackinggedrag aan te passen. Deze handleiding behandelt elke beschikbare configuratieoptie.
Nieuw bij Flowsery Analytics?
Begin met de installatiehandleiding om het trackingscript aan je website toe te voegen.Scriptattributen
Website-ID: data-fl-website-id (verplicht)
Je unieke website-ID uit Flowsery Analytics. Dit is het enige verplichte attribuut.
<script
defer
data-fl-website-id="flid_******"
src="https://cdn.flowsery.com/main.js"
></script>Domein: data-domain (optioneel)
Bepaalt het cookiebereik voor bezoekers- en sessie-ID's. Standaard is dit location.hostname, dus sites met één domein kunnen het weglaten. Stel het in als je één bezoekerscookie wilt delen over subdomeinen; met data-domain="example.com" delen example.com, app.example.com en blog.example.com bijvoorbeeld dezelfde bezoekers-ID. Heeft geen effect in de modus zonder cookies.
Subdomeinen volgen
Flowsery Analytics volgt standaard alle subdomeinen van je hoofddomein; data-domain bepaalt het cookiebereik, niet welke hostnamen worden gevolgd. Is je hoofddomein bijvoorbeeld example.com, dan werkt Flowsery Analytics ook op app.example.com, blog.example.com, shop.example.com, enz.Toegestane hostnamen: data-allowed-hostnames (optioneel)
Kommagescheiden lijst met extra domeinen voor cross-domain tracking.
- Standaard: leeg (geen cross-domain tracking)
- Voorbeeld: app.io,shop.example.com
- Toepassing: gebruikers volgen over verschillende hoofddomeinen
<script
defer
data-fl-website-id="flid_******"
data-allowed-hostnames="app.io,myapp.org"
src="https://cdn.flowsery.com/main.js"
></script>API-URL: data-api (optioneel)
Aangepast API-endpoint om events naartoe te sturen. Accepteert een volledige URL of een relatief pad.
- Voorbeeld: https://api.example.com/events of /custom-events
- Toepassing: aangepaste API-endpoints, analytics-proxy's van derden of geavanceerde proxyconfiguraties
Geef je een relatief pad op, dan wordt dat achter je domein geplakt.
Automatische proxyherkenning
Flowsery Analytics herkent een proxy-opstelling automatisch. Gebruik dit alleen als je een aangepast endpointpad nodig hebt of events naar een heel andere server wilt sturen.Localhost toestaan: data-local (optioneel)
Schakel tracking op localhost in voor ontwikkeling en testen. Accepteert "true" of "false". Standaard: false.
File-protocol toestaan: data-allow-file-protocol (optioneel)
Schakel tracking in wanneer je HTML-bestanden direct in een browser opent (file://-protocol). Accepteert "true" of "false". Standaard: false.
Debugmodus: data-debug (optioneel)
Schakel de debugmodus in om tracking binnen iframes toe te staan. Accepteert "true" of "false". Standaard: false. Flowsery Analytics volgt standaard niet binnen iframes, om dubbele tracking te voorkomen.
Console uitschakelen: data-disable-console (optioneel)
Schakel alle consolelogs van de Flowsery Analytics-tracker uit. Accepteert "true" of "false". Standaard: false.
Betalingen uitschakelen: data-disable-payments (optioneel)
Schakel automatische betaaltracking en omzettoewijzing via URL-parameters uit (Stripe session_id, LemonSqueezy order_id, Polar checkout_id). Accepteert "true" of "false". Standaard: false.
- Toepassing: bij server-side omzettoewijzing, om dubbele betaalevents te voorkomen
Handmatige betaaltracking
Handmatige aanroepen van window.flowsery("payment", { email }) blijven werken als dit aanstaat. Alleen de automatische herkenning via URL-parameters wordt uitgeschakeld.Attributen voor HTML-elementen
Deze attributen voeg je toe aan HTML-elementen op je pagina om automatische tracking in te schakelen.
Goals volgen: data-fs-goal (optioneel)
Volg klikken op elk element als aangepaste goal. Alleen kleine letters, cijfers, underscores en koppeltekens. Maximaal 64 tekens.
<button data-fs-goal="add_to_cart">Add to Cart</button>Goalparameters: data-fs-goal-* (optioneel)
Voeg aangepaste parameters toe aan goal-events. De parameternaam wordt afgeleid van de attribuutnaam (kebab-case, omgezet naar snake_case). Maximaal 10 parameters per event. Parameternamen: maximaal 64 tekens. Waarden: maximaal 255 tekens.
<button
data-fs-goal="product_added"
data-fs-goal-product-id="prod_123"
data-fs-goal-product-name="Premium Plan"
data-fs-goal-price="49">
Add to Cart
</button>Scrolltracking: data-fs-scroll (optioneel)
Volg automatisch wanneer een element tijdens het scrollen zichtbaar wordt. Standaardtrigger: het element is voor 50% zichtbaar. Dezelfde naamregels als bij data-fs-goal.
<section data-fs-scroll="viewed_pricing">
<h2>Pricing</h2>
</section>Scrolldrempel: data-fs-scroll-threshold (optioneel)
Pas de zichtbaarheidsdrempel voor scrolltracking aan. Decimaal getal tussen 0 en 1. Standaard: 0.5 (50% van het element zichtbaar). Veelgebruikte waarden: 0.1 (10%), 0.5 (50%), 0.9 (90%), 1.0 (100%).
Scrollvertraging: data-fs-scroll-delay (optioneel)
Voeg een vertraging in milliseconden toe voordat het scrollevent wordt gevolgd. Standaard: 0 (geen vertraging).
<section
data-fs-scroll="read_testimonials"
data-fs-scroll-threshold="0.7"
data-fs-scroll-delay="3000">
<!-- Tracks only if element stays visible for 3 seconds -->
</section>Scrollparameters: data-fs-scroll-*
Voeg aangepaste parameters toe aan scrolltracking-events, net als bij data-fs-goal-*.
Veelgebruikte configuratievoorbeelden
Ontwikkelomgeving
<script
defer
data-fl-website-id="flid_******"
data-local="true"
src="https://cdn.flowsery.com/main.js"
></script>Productie met proxy
<script
defer
data-fl-website-id="flid_******"
src="/js/main.js"
></script>Flowsery Analytics herkent een proxy-opstelling automatisch. Je hebt geen data-api nodig als je zowel /js/main.js als /api/track via de proxy laat lopen.
Cross-domain tracking
<script
defer
data-fl-website-id="flid_******"
data-domain="example.com"
data-allowed-hostnames="app.io,shop.example.net"
src="https://cdn.flowsery.com/main.js"
></script>Gebruik dezelfde configuratie op alle gevolgde domeinen.
Navigatie op basis van hashes volgen
Voor single-page applicaties met hash-routing:
<script
defer
data-fl-website-id="flid_******"
src="https://cdn.flowsery.com/main.hash.js"
></script>Overzicht van validatieregels
Namen van goals en events
- Tekens: kleine letters, cijfers, underscores (_), koppeltekens (-)
- Lengte: maximaal 64 tekens
Namen van aangepaste parameters
- Tekens: kleine letters, cijfers, underscores (_), koppeltekens (-)
- Lengte: maximaal 64 tekens
- Omzetting: attributen in kebab-case worden automatisch omgezet naar snake_case
Waarden van aangepaste parameters
- Lengte: maximaal 255 tekens
- HTML/XSS: gevaarlijke tekens worden automatisch opgeschoond
- Limiet: maximaal 10 aangepaste parameters per event
Scrolldrempel
Decimaal getal, bereik 0.0 tot 1.0, standaard 0.5.
Scrollvertraging
Geheel getal (milliseconden), 0 of hoger, standaard 0.
Problemen oplossen
Tracking werkt niet op localhost
Voeg data-local="true" toe om lokale tracking in te schakelen.
Aangepaste goals gaan niet af
Controleer of je goalnaam aan de validatieregels voldoet: alleen kleine letters, geen spaties of speciale tekens (behalve _ en -), maximaal 64 tekens.
Cross-domain tracking werkt niet
Controleer: dezelfde data-fl-website-id op alle domeinen, alle extra domeinen staan in data-allowed-hostnames, gebruikers klikken op links tussen de domeinen.
Scrolltracking gaat niet af
Veelvoorkomende oorzaken: het element is niet lang genoeg in beeld, de drempel staat te hoog, IntersectionObserver wordt niet ondersteund.