# Conversiefunnel en heatmap: documentatie van de module voor PrestaShop 8 en 9

> Installatie, dashboard, funnel, acquisitie, producten, heatmap, weekrapport en instellingen van de module DataFirefly Conversietrechter & Heatmap voor PrestaShop 8 en 9.

- Pagina: <https://www.datafirefly.com/nl/documentation/dffunnelheatmap/>
- Taal: nl
- Bijgewerkt op: 2026-10-16
- Andere talen: [fr](https://www.datafirefly.com/documentation/dffunnelheatmap/index.md), [en](https://www.datafirefly.com/en/documentation/dffunnelheatmap/index.md), [es](https://www.datafirefly.com/es/documentation/dffunnelheatmap/index.md), [de](https://www.datafirefly.com/de/documentation/dffunnelheatmap/index.md), [it](https://www.datafirefly.com/it/documentation/dffunnelheatmap/index.md), [pl](https://www.datafirefly.com/pl/documentation/dffunnelheatmap/index.md), [pt](https://www.datafirefly.com/pt/documentation/dffunnelheatmap/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

De module **DataFirefly Conversietrechter & Heatmap** (`dffunnelheatmap`) laat zien waar uw bezoekers afhaken, waar uw kopers vandaan komen en wat hen tegenhoudt op uw pagina's. Ze combineert een conversiefunnel in 9 stappen, een acquisitierapport, productstatistieken, een heatmap met detectie van woedeklikken en een wekelijks e-mailrapport. Alle gegevensverzameling is first-party: niets verlaat uw server.

Deze documentatie beschrijft versie **1.3.2**, compatibel met PrestaShop 8.0 t/m 9.x (PHP 7.2 of hoger).

## Installatie en update

1. Download het archief `dffunnelheatmap.zip` uit uw klantaccount.
2. Open in de back-office **Modules > Modulebeheer**, klik op **Een module uploaden** en kies de ZIP.
3. De module maakt haar 6 tabellen aan en voegt het tabblad **Statistieken > Funnel en heatmap** toe.

Om bij te werken vanaf een eerdere versie uploadt u de nieuwe ZIP over de geïnstalleerde module. De updatescripts draaien vanzelf: uw gegevens en instellingen blijven behouden.

Geen externe afhankelijkheden: geen Composer, geen CDN. De standaardinstellingen passen bij de meeste winkels: heatmap op 100% van de sessies, bewaartermijn van 90 dagen, Do Not Track gerespecteerd, medewerkers uitgesloten.

## Aan de slag

Zolang er nog geen bezoek is binnengekomen, toont het dashboard een checklist: tracking ingeschakeld, funnel of heatmap ingeschakeld, eerste bezoek ontvangen. Browsers die in de back-office zijn ingelogd worden niet geteld: open de winkel in een privévenster of op een ander apparaat om de verzameling te controleren.

## Het dashboard

De interface heeft zes tabbladen: **Dashboard**, **Conversiefunnel**, **Acquisitie**, **Producten**, **Heatmap** en **Instellingen**.

- **Kerncijfers**: sessies, unieke bezoekers, geplaatste bestellingen, toevoegpercentage winkelwagen, conversiepercentage, gevolgde omzet incl. btw, gemiddelde bestelwaarde en de grootste uitval in de funnel. Elk cijfer wordt vergeleken met de vorige periode van dezelfde lengte.
- **Per dag**: grafiek van sessies, bestellingen of conversiepercentage. De knoppen boven de grafiek wisselen het cijfer zonder de pagina te herladen, en de link _Gegevens tonen_ opent de tabel met waarden.
- **Aanbevelingen**: tot 6 bevindingen, ingedeeld in _Op te lossen_, _Te controleren_ en _Goed nieuws_, elk met een link naar het bijbehorende rapport.
- **Op dit moment**: bezoekers van de laatste 5 minuten, de pagina's die ze bekijken en de verdeling per apparaat, elke 30 seconden vernieuwd.

Een overzichtskaart (sessies, bestellingen en conversie van de laatste 7 dagen, bezoekers op dit moment) verschijnt ook op het startdashboard van PrestaShop.

### De aanbevelingen

Ze verschijnen pas boven een minimumvolume, ongeveer 30 sessies per apparaat of kanaal, om conclusies op basis van drie bezoeken te vermijden. De module controleert:

- het grootste lek in de funnel tussen twee stappen;
- het aandeel sessies dat de checkout betreedt en een bestelling plaatst;
- het conversieverschil tussen mobiel en desktop;
- kanalen die verkeer opleveren zonder enige bestelling, en het best converterende kanaal;
- het meest bekeken product onder de producten die weinig aan de winkelwagen worden toegevoegd;
- de pagina met de meeste woedeklikken en klikken zonder effect;
- een stijging of daling van het verkeer van minstens 20%.

## De conversiefunnel

De funnel telt sessies. Een sessie eindigt na 30 minuten inactiviteit. Elke sessie telt bij de verste stap die ze bereikt, en in alle stappen daarvoor: de funnel wordt altijd smaller.

1. **Bezoek**: elke paginaweergave.
2. **Productpagina**: weergave van een productpagina.
3. **Toevoegen aan winkelwagen**: server-side gedetecteerd, vanaf welke pagina ook.
4. **Winkelwagenpagina**: weergave van de winkelwagen.
5. **Afrekenen**: start van het bestelproces.
6. **Adres**: adresstap van de standaard checkout, gedetecteerd in de browser.
7. **Verzending**: keuze van de vervoerder, gedetecteerd in de browser.
8. **Betaling**: betaalstap, gedetecteerd in de browser.
9. **Bestelling geplaatst**: server-side vastgelegd bij het valideren van de bestelling en daarna bevestigd door de bevestigingspagina.

De detailtabel toont per stap de sessies die haar bereiken, hun aandeel, de sessies die sinds de vorige stap verloren gingen, het uitvalpercentage en de sessies die de stap zelf hebben uitgevoerd. Toevoegen aan de winkelwagen vanaf een categoriepagina slaat bijvoorbeeld de productpagina over. Rijen met meer dan 30% of 50% uitval worden gekleurd.

De kolom **vs vorige periode** geeft de verandering van het aandeel sessies in procentpunten. De tabel **Conversie per apparaat** vergelijkt desktop, tablet en mobiel. De knop **CSV exporteren** downloadt de funnel met de huidige filters.

## Acquisitie

Elke sessie wordt aan een kanaal gekoppeld op basis van het domein van de verwijzende site (alleen het domein wordt bewaard), de UTM-parameters en de klik-ID's van advertentieplatforms.

- **Direct**: geen verwijzende site en geen UTM-parameter.
- **Organisch zoeken**: zoekmachines (Google, Bing, Qwant, DuckDuckGo, Ecosia...).
- **Betaalde advertenties**: klik-ID van Google Ads of Microsoft Ads (`gclid`, `msclkid`), of een `utm_medium` zoals cpc, ppc, paid of display.
- **Sociale netwerken**: Facebook, Instagram, TikTok, LinkedIn, Pinterest, X, YouTube..., of een link met `fbclid` of `ttclid`.
- **E-mail**: `utm_medium=email` of een webmail (Gmail, Outlook...).
- **Verwijzende sites**: elke andere site.
- **Andere campagnes**: een UTM-parameter die bij geen van de bovenstaande gevallen past.

Terugkeer vanaf een betaalpagina (PayPal, Stripe...) telt niet als bron: die vervangt nooit de echte herkomst van het bezoek.

Het tabblad toont de kanalen (sessies, aandeel, bounce, winkelwagen, conversie, bestellingen en omzet), daarna de bronnen, de campagnes `utm_campaign`, de landingspagina's met een link naar hun heatmap en de verdeling tussen nieuwe en terugkerende bezoekers. Klik op een kanaal om de funnel te openen, gefilterd op dat kanaal.

## Producten

Per product: weergaven (één per sessie), eerste toevoegingen aan de winkelwagen, bestellingen, verkochte aantallen, toevoegpercentage en percentage weergave naar bestelling. Er zijn vier sorteringen: **Meest bekeken**, **Meest toegevoegd**, **Meest besteld** en **Kansen**.

De sortering **Kansen** toont producten die minstens 20 keer bekeken zijn en waarvan het toevoegpercentage lager is dan de helft van het winkelgemiddelde. Ze trekken bezoekers aan, maar iets houdt hen tegen: prijs, foto's, beschrijving, voorraad of levertijd.

## De heatmap

### Een pagina kiezen

Pagina's zijn gegroepeerd per type (homepage, producten, categorieën, winkelwagen en checkout...) en gesorteerd op aantal weergaven. Het zoekveld filtert op titel of adres. De meest bekeken pagina laadt automatisch. Het blok **Pagina's om in de gaten te houden** bovenaan het tabblad toont de pagina's met de meeste woedeklikken en klikken zonder effect.

De pagina verschijnt in een preview op de meest voorkomende schermgrootte van haar bezoekers, voor het gekozen apparaat (desktop, tablet of mobiel). Scrol in de preview: de warmtelaag scrolt mee.

Elke klik wordt teruggezet op het element waarop de bezoeker klikte, op dezelfde plek binnen dat element, ongeacht zijn schermbreedte, de hoogte van zijn pagina op het moment van de klik of een sticky header. Klikken op een vast element (winkelwagenbalk onderaan het scherm) blijven er tijdens het scrollen op staan. Bestaat het element niet in de preview of is het verborgen (ingeklapt menu, gesloten venster), dan valt de klik terug op zijn oorspronkelijke coördinaten. In de preview worden cookiebanners verborgen en draaien alleen de scripts van de winkel: scripts van derden (tags, chats) worden geblokkeerd.

### De drie modi

- **Klikken**: heatmap van de klikken, van geel (weinig klikken) tot donkerrood (veel).
- **Scrollen**: aandeel bezoekers dat elke hoogte van de pagina bereikt, met de gemiddelde vouwlijn.
- **Frustratie**: markeringen voor woedeklikken (rood) en klikken zonder effect (grijs). Nabije klikken worden gegroepeerd en hun aantal wordt getoond.

Een woedeklik is een reeks van 3 klikken binnen een seconde op dezelfde plek. Een klik zonder effect is een klik op een afbeelding of element dat klikbaar lijkt, zonder enige reactie van de pagina.

### Segmenten en aangeklikte elementen

De segmentkeuze toont **Alle bezoekers**, **alleen kopers** (sessies met een bestelling) of **alleen niet-kopers**. Het zijpaneel rangschikt de meest aangeklikte elementen met hun woedeklikken en klikken zonder effect. Beweeg over een element om het in de preview terug te vinden.

De preview laadt de winkelpagina in de back-office. Winkel en back-office moeten op hetzelfde domein staan, en de server mag geen `X-Frame-Options: DENY` sturen: gebruik `SAMEORIGIN`.

## Wekelijks e-mailrapport

Elke maandag vat een e-mail de afgelopen week (maandag tot en met zondag) samen, vergeleken met de week ervoor:

- sessies, geplaatste bestellingen, conversiepercentage en gevolgde omzet, met hun verandering;
- tot 4 punten om eerst naar te kijken, uit de aanbevelingen;
- de funnel in 5 kernstappen (bezoek, productpagina, toevoegen aan winkelwagen, afrekenen, bestelling geplaatst);
- de 5 belangrijkste acquisitiekanalen met conversie en omzet;
- een knop die het dashboard op die week opent.

### Instellingen van het rapport

In **Instellingen > Wekelijks e-mailrapport**:

- **Elke maandag een rapport versturen**: standaard ingeschakeld.
- **Ontvangers**: één adres per regel. Laat u het veld leeg, dan gaat het rapport naar het e-mailadres van de winkel.
- **Taal van het rapport**: standaard de taal van de winkel. Het rapport bestaat in het Frans, Engels, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees.
- **Opslaan en test versturen**: verstuurt het rapport van vorige week direct naar de ontvangers.
- **Voorbeeld van vorige week**: opent het rapport in een nieuw tabblad, precies zoals de ontvangers het krijgen.

### Wanneer wordt het rapport verstuurd?

Er is geen cronjob nodig. Het eerste bezoek dat op maandag wordt vastgelegd start de verzending, nadat de bezoeker zijn antwoord heeft gekregen, die dus niet wacht. Een vergrendeling voorkomt twee verzendingen voor dezelfde week. Na een week zonder bezoeken wordt geen e-mail verstuurd. Na installatie of update gaat het eerste rapport de volgende maandag uit.

Het rapport gebruikt de e-mailconfiguratie van PrestaShop. Zijn e-mails uitgeschakeld in **Geavanceerde instellingen > E-mail**, dan verschijnt er een waarschuwing in de instellingen. De links in het rapport openen de back-office zonder beveiligingstoken: PrestaShop vraagt om bevestiging voordat de pagina wordt getoond, dat is normaal.

## Filters

De rapporten delen een filterbalk: **periode** (7, 30, 90 of 365 dagen, of eigen datums), **apparaat**, **kanaal** (dashboard en funnel) en **winkel** bij multistore. Filters blijven behouden als u van tabblad wisselt.

## Instellingen

### Tracking

- **Tracking inschakelen**, en daarna de **conversiefunnel** en de **heatmap** apart inschakelen.
- **Heatmap-steekproef** (1 tot 100%): aandeel sessies dat voor de heatmap wordt vastgelegd. De funnel legt altijd alle sessies vast.

### Privacy

- **Do Not Track en Global Privacy Control respecteren**: standaard ingeschakeld.
- **Modus zonder cookies**: de sessie leeft in het browsertabblad. Unieke bezoekers worden niet meer geteld.
- **Bewaartermijn** in dagen (standaard 90). Oudere gebeurtenissen worden automatisch verwijderd, hooguit eenmaal per uur.

### Uitsluitingen

- **Ingelogde medewerkers volgen**: standaard uitgeschakeld, browsers die in de back-office zijn ingelogd worden niet geteld.
- **Uitgesloten IP-adressen**: één per regel, exact adres, CIDR-bereik (`192.168.1.0/24`) of prefix (`10.0.*`). Uw huidige adres wordt getoond.
- **Deze browser uitsluiten**: plaatst een uitsluitingscookie, handig op een telefoon of een computer die niet in de back-office is ingelogd.

### Onderhoud

Het blok **Gegevensonderhoud** toont het opgeslagen volume en biedt drie acties: opschonen buiten de bewaartermijn, een nieuwe trackingsleutel aanmaken en alle gegevens verwijderen.

## Privacy en AVG

- Er wordt geen IP-adres, geen e-mail en geen waarde van een formulierveld opgeslagen.
- Alleen de teksten van klikbare elementen (knoppen, links) worden bewaard, en op account- en bestelpagina's helemaal geen tekst. E-mails en lange cijferreeksen worden in de browser en daarna op de server gemaskeerd.
- Technische first-party cookies: `dffh_sid` (sessie, 30 minuten), `dffh_vid` (anonieme bezoeker, 13 maanden) en `dffh_optout` (uitsluiting). De modus zonder cookies schakelt ze uit.
- Bots en audittools (Lighthouse, PageSpeed...) worden genegeerd.
- Het verzameladres accepteert alleen POST-verzoeken die met een trackingsleutel zijn ondertekend, en alleen adressen van uw winkel worden vastgelegd.

Afhankelijk van uw eigen beoordeling en die van uw functionaris gegevensbescherming kunt u deze tracking vermelden in uw privacyverklaring of de modus zonder cookies inschakelen.

## Problemen oplossen

**Er verschijnen geen gegevens.** Controleer dat u niet test vanuit een browser die in de back-office is ingelogd of vanaf een uitgesloten IP-adres, en dat Do Not Track niet aan staat in uw browser. Leeg na de installatie de PrestaShop-cache als er een full-page cache actief is.

**De stappen adres, verzending en betaling blijven op nul.** Ze zijn gebaseerd op de standaard PrestaShop-checkout (thema's Classic en Hummingbird). Een checkoutmodule van derden stelt ze mogelijk niet beschikbaar. De andere stappen, inclusief de geplaatste bestelling, blijven server-side gevolgd.

**De heatmap-preview blijft leeg.** Winkel en back-office moeten op hetzelfde domein staan, zonder header `X-Frame-Options: DENY`.

**Het weekrapport komt niet aan.** Gebruik _Opslaan en test versturen_: een melding geeft aan of de verzending mislukte, e-mails uitgeschakeld zijn of een ontvanger ontbreekt. Kijk ook in de spammap.

## De-installatie

De-installatie verwijdert het tabblad, de hooks en de instellingen. Verzamelde gegevens blijven standaard bewaard. Om ze te verwijderen, schakelt u vóór de de-installatie **Gegevens verwijderen bij de-installatie** in de instellingen in: dan worden de 6 tabellen van de module verwijderd.
