getting-started

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.

Basis-scripttag
<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
Cross-domain tracking
<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.

Goal met parameters
<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).

Scrolltracking met drempel en 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.