# Analytics

Capyshop wordt geleverd met een **ingebouwd analyticssysteem** — geen Google Analytics, geen tracking-snippets van derden, geen integratie met een consent-manager die u moet onderhouden. U krijgt bezoekers, sessies, conversiefunnels, verkeersbronnen, productprestaties en inzichten over verlaten winkelmandjes direct vanuit de beheerdersnavigatie.

Analytics is te vinden onder **Analytics** in de beheerdersnavigatie, los van het **Dashboard**. Een snelle manier om het onderscheid te maken:

| Sectie        | Focus                                                                        | Typische vraag die het beantwoordt           |
| ------------- | ---------------------------------------------------------------------------- | -------------------------------------------- |
| **Dashboard** | Operationele snapshot — bestellingen, omzet, voorraad, kortingscodes         | "Hoe gaat het vandaag / deze maand?"         |
| **Analytics** | Bezoekersgedrag en conversietrends — sessies, funnel, verkeersbronnen        | "Waar komen verkopen vandaan en waarom?"     |

Bekijk de dedicated [Dashboard](/nl/features/dashboard)-pagina voor de operationele kant.

## Voordat u begint

Een aantal dingen om te weten voordat u begint met het vergelijken van cijfers:

- **Standaard consent-gestuurd.** Bezoekersgedrag (page views, product views, add-to-cart, etc.) wordt pas gevolgd nadat een shopper de cookie-consent-banner op uw storefront heeft geaccepteerd. Aankopen en verlaten checkouts worden altijd vastgelegd — dit zijn contractuele gebeurtenissen, geen gedragstracking.
- **Adminsessies worden uitgesloten.** Sessies van ingelogde admins tellen niet mee voor bezoekers, sessies, paginaweergaven of andere metrieken, zodat de dashboards de werkelijke klantactiviteit weerspiegelen in plaats van interne navigatie of tests.
- **Paginapaden worden genormaliseerd.** Dezelfde logische pagina wordt onder één canoniek pad gegroepeerd — bijvoorbeeld zonder query-parameters die alleen voor tracking dienen — zodat verkeersaantallen niet over cosmetische URL-varianten worden versplinterd.
- **Volledig GDPR-compliant.** Capyshop slaat nooit ruwe IP-adressen of User-Agents op. Botverkeer wordt gedetecteerd en eruit gefilterd voordat het in de database belandt.
- **De verversingscadans is configureerbaar.** Standaard her-aggregeert een achtergrondtaak elk uur de laatste 24 uur aan ruwe events. Uw deployment kan anders zijn ingesteld — de exacte cadans voor uw winkel staat direct onder de "Analytics"-titel. U kunt altijd eerder de nieuwste cijfers ophalen met de **Refresh**-knop.
- **De retentie is configureerbaar.** Standaard worden ruwe events 90 dagen bewaard en geaggregeerde daily rollups voor altijd, zodat jaar-op-jaar vergelijkingen beschikbaar blijven. Beide waarden kunnen per deployment worden aangepast.

## De Analytics-sectie

![Analytics-overzicht](/features/analytics/overview.png)

Elke tab deelt dezelfde header-besturingselementen:

- **Date range picker** — standaard de laatste 30 dagen. Klik op de picker om een preset of aangepast bereik te kiezen.
- **Refresh-knop** — draait de aggregator opnieuw aan de serverkant. Er is een cooldown van 10 seconden tussen refreshes, zodat een kamer vol admins de database niet kan overbelasten.

![Date range picker](/features/analytics/date-range.png)

## Tab Overview

De Overview-tab toont de vijf belangrijkste cijfers, plus een **Visitors & Sessions**-grafiek over het geselecteerde bereik.

| KPI                 | Wat het betekent                                                                                                                       |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Visitors**        | Unieke personen die uw winkel in dit datumbereik hebben bezocht.                                                                       |
| **Sessions**        | Een sessie is één doorlopend bezoek. Eén bezoeker kan meerdere sessies hebben als hij later terugkomt.                                 |
| **Page Views**      | Totaal aantal pagina's dat is geladen over alle bezoeken.                                                                              |
| **Conversion Rate** | Percentage sessies dat eindigde in een aankoop. Het belangrijkste cijfer voor uw winkel.                                               |
| **Bounce Rate**     | Percentage sessies waarin de bezoeker slechts één pagina heeft gezien. Lager is beter — het betekent dat mensen uw winkel verkennen.   |

Elke KPI toont ook een **"vs previous period"**-delta zodra u genoeg historie heeft opgebouwd. De kleuren volgen de richting van de metriek: "conversion rate up 12%" verschijnt groen en "bounce rate up 12%" verschijnt rood. Beweeg de cursor over een KPI om een tooltip te zien die uitlegt hoe dat getal wordt berekend.

## Tab Traffic

![Traffic-tab — tabel met bronnen, devices-grafiek, top pages](/features/analytics/traffic.png)

Drie secties helpen u te begrijpen waar uw bezoekers vandaan komen en waarnaar ze kijken:

- **Traffic Sources** — een tabel gesplitst naar **UTM source** en **medium** (bijv. `google / organic`, `facebook / cpc`, `newsletter / email`). Sessies, aankopen en omzet per bron.
- **Devices** — horizontale staafgrafiek van sessies per apparaattype (mobile, desktop, tablet). Als het meeste verkeer mobiel is, moeten uw productpagina's er goed uitzien op kleine schermen.
- **Top Pages** — welke URL's op uw winkel de meeste views krijgen, met aantal unieke bezoekers.

> **Tip:** Om te zien welke campagnes echt werken, tag elke marketinglink die u deelt met [UTM-parameters](https://ga-dev-tools.google/campaign-url-builder/). Capyshop pikt ze automatisch op — geen extra configuratie nodig.

De tabellen voor Traffic Sources, Top Pages, Products en Abandoned Carts gebruiken **paginering aan de serverzijde**, zodat grote winkels snel blijven — alleen de rijen die u bekijkt worden tegelijk geladen.

## Tab Products

![Productprestatietabel](/features/analytics/products.png)

Per-product-statistieken voor uw top 50 producten op basis van views:

| Kolom               | Betekenis                                                                                                                                 |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Product**         | Linkt terug naar de productbewerkingspagina voor snelle aanpassingen.                                                                     |
| **Views**           | Aantal keer dat de productpagina is geopend.                                                                                              |
| **Add to Carts**    | Aantal add-to-cart-events voor dit product.                                                                                               |
| **ATC Rate**        | Add-to-cart-ratio — hoe vaak bezoekers die een product bekeken het aan hun mandje toevoegden. Goed om producten te spotten die clicks trekken maar geen actie. |
| **Conversion Rate** | Van de mensen die dit product bekeken, welk percentage het daadwerkelijk heeft gekocht.                                                   |
| **Revenue**         | Totale omzet van dit product in het bereik.                                                                                               |

## Tab Funnel

![Conversiefunnel met drop-off-analyse](/features/analytics/funnel.png)

De Funnel-tab laat zien hoe bezoekers zich door de zeven stappen van de koopreis bewegen:

1. **Visited store** — eerste page view
2. **Viewed product** — een productpagina geopend
3. **Added to cart** — op "Add to cart" geklikt
4. **Began checkout** — het checkout-proces gestart
5. **Entered address** — verzendgegevens ingevuld
6. **Picked shipping/payment** — verzending en betaling geselecteerd
7. **Completed purchase** — bestelling geplaatst

Elke stap die veel mensen verliest, is een kans om te verbeteren. **Pak eerst de lekste stap aan** — de staafgrafiek plus de drop-off-lijst kleurcoderen grote verliezen (rood bij verlies boven 30%, amber tussen 15–30%), zodat de slechtste stap meteen opvalt.

## Tab Abandoned Carts

![KPIs en recente lijst van verlaten winkelmandjes](/features/analytics/carts.png)

Verlaten winkelmandjes zijn checkouts die een klant is begonnen maar niet binnen 24 uur heeft afgerond. Deze terugwinnen is vaak het grootste snelle voordeel voor een kleine winkel.

| KPI                   | Wat het betekent                                                                                                                      |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Checkouts Started** | Shoppers die voorbij het mandje kwamen en in het checkout-proces stapten.                                                             |
| **Purchases**         | Bestellingen die in dit datumbereik succesvol zijn geplaatst.                                                                         |
| **Abandoned**         | Checkouts die werden gestart maar niet binnen 24 uur zijn voltooid.                                                                   |
| **Abandonment Rate**  | Percentage gestarte checkouts dat werd verlaten. Onder **70%** is gezond; boven **85%** wijst op echte frictie in uw checkout.        |
| **Lost Revenue**      | Geschatte omzet die is misgelopen door mandjes die zijn verlopen zonder aankoop.                                                      |

Onder de KPIs toont **Recent abandoned carts** elk verlaten mandje met klant, wanneer het gebeurde, aantal items en waarde. Dit is uw shortlist voor herstelcampagnes (persoonlijke e-mail, retargeting, een kleine kortingscode).

## Privacy en dataretentie

Capyshop is vanaf dag één gebouwd met GDPR in gedachten:

- Er worden geen ruwe IP-adressen of User-Agents opgeslagen — alleen een grof apparaattype (mobile / desktop / tablet).
- Botverkeer wordt gefilterd voordat het in de database belandt, zodat geaggregeerde cijfers echte mensen weerspiegelen.
- Ruwe event-data wordt **standaard 90 dagen bewaard** (per deployment configureerbaar via `ANALYTICS_RETENTION_DAYS`). Geaggregeerde daily rollups worden voor altijd bewaard, zodat lange-termijntrends beschikbaar blijven zonder persoonlijke data.
- Wanneer een klantaccount wordt verwijderd, worden de bijbehorende analytics-events ook verwijderd — het recht op vergetelheid valt onder dezelfde admin-flow als de rest van de klantgegevens.

Als u specifieke compliance-vereisten heeft (kortere retentie, aangepast opruimschema), kunnen de standaardwaarden per deployment worden aangepast zonder gevolgen voor de dashboards.