> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisepim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Analytics 4-integratie

> Koppel een GA4-property aan WISEPIM, synchroniseer verkeer en e-commercegedrag en verbind conversieprestaties met producten via SKU.

Google Analytics 4 (GA4) verbindt wat bezoekers in je winkel doen met de productdata die je in WISEPIM beheert. De integratie voegt echt verkeer, engagement, funnel- en itemprestaties toe aan Analytics zonder iets in je catalogus te wijzigen. De koppeling is alleen-lezen en gebruikt Google OAuth, dus je hoeft geen API-sleutels te kopiëren.

<img className="block dark:hidden" src="https://mintcdn.com/swiftsyncai/RrI5zmmCE9oVB7Rc/images/marketing-screenshots/analytics/analytics-ga4-traffic-insight-light-branded.webp?fit=max&auto=format&n=RrI5zmmCE9oVB7Rc&q=85&s=b7400111bd5a05353b203221963af6fc" alt="Een gekoppelde GA4-reis in WISEPIM van verkeer en doelgroep naar funnelgedrag en productkansen" width="2400" height="569" data-path="images/marketing-screenshots/analytics/analytics-ga4-traffic-insight-light-branded.webp" />

<img className="hidden dark:block" src="https://mintcdn.com/swiftsyncai/Lc4wDQ2eYr16CXUM/images/marketing-screenshots/analytics/analytics-ga4-traffic-insight-dark-branded.webp?fit=max&auto=format&n=Lc4wDQ2eYr16CXUM&q=85&s=da96a6c37a86979f479ac82ff36cb217" alt="Een gekoppelde GA4-reis in WISEPIM van verkeer en doelgroep naar funnelgedrag en productkansen" width="2400" height="569" data-path="images/marketing-screenshots/analytics/analytics-ga4-traffic-insight-dark-branded.webp" />

## Voordat je begint

* Een Google-account met toegang tot minstens **één GA4-property**.
* Een GA4-property die data ontvangt van de storefront voor dit WISEPIM-project.
* De standaard GA4 e-commerce-events voor een volledige funnel: `view_item`, `add_to_cart`, `begin_checkout` en `purchase`.
* Stuur voor productattributie de WISEPIM-SKU mee als GA4 `item_id`. De koppeling is exact en hoofdlettergevoelig.

Elk WISEPIM-project koppelt aan **één GA4-property**. Gebruik bij meerdere storefronts een apart project en een aparte property per datagrens.

## Google Analytics 4 koppelen

<Steps>
  <Step title="Open Integraties">
    Ga naar **Kanalen → Integraties**, filter op **Analytics** en open **Google Analytics 4**.
  </Step>

  <Step title="Verbind met Google">
    Klik op **Verbinden met Google**. WISEPIM stuurt je naar het toestemmingsscherm van Google en vraagt alleen-lezen-toegang tot Analytics.
  </Step>

  <Step title="Kies een account">
    Log in met het Google-account dat toegang heeft tot de gewenste GA4-property. Na toestemming kom je automatisch terug in WISEPIM.
  </Step>

  <Step title="Selecteer een property">
    WISEPIM toont de beschikbare GA4-properties, inclusief het Analytics-account en de property-ID. Kies de property die bij dit project hoort.
  </Step>

  <Step title="Laat de eerste synchronisatie afronden">
    WISEPIM controleert de property en zet automatisch de eerste synchronisatie in de wachtrij. Het statusvenster volgt de achtergrondtaak en toont het resultaat en aantal rijen.
  </Step>
</Steps>

## Welke data WISEPIM ophaalt

| Data                                                                    | Wat het mogelijk maakt                                          |
| ----------------------------------------------------------------------- | --------------------------------------------------------------- |
| Sessies, gebruikers en dagtotalen                                       | Winkelverkeer en trends tussen periodes                         |
| Bron, medium en apparaat                                                | Acquisitie- en kanaalanalyse                                    |
| Betrokken sessies, engagementratio, bouncepercentage en gemiddelde duur | Analyse van verkeerskwaliteit en gedrag                         |
| Paginapaden en paginaweergaven                                          | Prestaties van landings- en productpagina's                     |
| E-commerce-events en omzet                                              | De funnel van weergave via winkelwagen en checkout naar aankoop |
| Itemweergaven, winkelwagens, checkouts, aankopen en itemomzet           | Conversieprestaties per product                                 |

<Info>
  GA4 stuurt alleen analyticsdata naar WISEPIM. De integratie importeert, wijzigt of exporteert geen producttitels, prijzen, afbeeldingen, voorraad of andere catalogusvelden.
</Info>

## Hoe producten worden gekoppeld

WISEPIM koppelt een GA4-item alleen wanneer `item_id` exact gelijk is aan de SKU van een product binnen hetzelfde project. Productnamen worden bewust niet als fallback gebruikt, omdat ze geen stabiele identifiers zijn.

| GA4-waarde                                                      | Resultaat in WISEPIM                                            |
| --------------------------------------------------------------- | --------------------------------------------------------------- |
| `item_id` komt exact overeen met een SKU                        | Funnelcijfers verschijnen bij dat product                       |
| `item_id` gebruikt andere hoofdletters of een andere identifier | De rij blijft ongekoppeld en kan geen ander product beïnvloeden |
| `item_id` ontbreekt of is `(not set)`                           | De rij wordt genegeerd voor productattributie                   |

<Warning>
  Configureer je GA4 e-commerce-implementatie zo dat de WISEPIM-SKU als `item_id` wordt verstuurd. Zonder die afspraak werken algemene GA4-rapporten wel, maar kunnen productconversies niet betrouwbaar worden gekoppeld.
</Warning>

## Conversieratio's begrijpen

WISEPIM houdt namen en noemers expliciet:

* **Key-eventratio per sessie** is GA4 `sessionKeyEventRate`: het aandeel sessies waarin minstens één event plaatsvond dat in GA4 als key event is gemarkeerd. Dit is niet `key events ÷ sessies`, omdat één sessie meerdere key events kan bevatten.
* **Winkelwagenratio per eenheid** is het aantal gesynchroniseerde itemtoevoegingen gedeeld door itemweergaven.
* **Aankoopratio per eenheid** is het aantal gesynchroniseerde gekochte items gedeeld door itemweergaven.

De eenheidsratio's beantwoorden een productvraag; de key-eventratio beantwoordt een sessievraag. Ze mogen dus van elkaar verschillen.

## Wat het aandrijft

| WISEPIM-rapport                                            | Wat GA4 toevoegt                                            |
| ---------------------------------------------------------- | ----------------------------------------------------------- |
| [Verkeer & Gedrag](/nl/analytics/traffic-behavior)         | Sessies, engagement, bronnen, apparaten, pagina's en trends |
| [Conversies](/nl/analytics/conversions)                    | De gedragsfunnel en de grootste uitvalmomenten              |
| [Productprestaties](/nl/analytics/product-performance)     | Itemweergaven, itemomzet en conversieratio's per product    |
| [Marketingattributie](/nl/analytics/marketing-attribution) | Bron- en mediumcontext voor acquisitieprestaties            |
| [Integratiegezondheid](/nl/analytics/integration-health)   | Zicht op verbinding en synchronisatie                       |

## De koppeling beheren en verversen

Open de GA4-integratie opnieuw om:

* De **property te wijzigen**. WISEPIM controleert deze en start automatisch een nieuwe, propertyspecifieke synchronisatie. Data van de oude en nieuwe property wordt nooit gemengd.
* De **verbinding te testen** en de opgeslagen toestemming en property te controleren.
* **Nu synchroniseren** te gebruiken om de laatste zeven dagen te verversen en gaten in het bewaarde venster van 180 dagen aan te vullen.
* Met **Volledig opnieuw synchroniseren** het volledige bewaarde venster van 180 dagen opnieuw op te bouwen.
* Recente synchronisaties te bekijken, inclusief status, duur, periode, aantal rijen en foutmelding.
* GA4 van het huidige project **los te koppelen**.

<Note>
  GA4 is in WISEPIM geen realtime feed. Synchronisaties draaien op de achtergrond en lopen tot en met gisteren. Google kan recente data nog aanpassen; daarom ververst WISEPIM bij elke slimme synchronisatie de laatste zeven dagen.
</Note>

## Problemen oplossen

<AccordionGroup>
  <Accordion title="Er worden geen properties getoond">
    Het gekozen Google-account heeft geen toegang tot een GA4-property, of de vereiste Google Analytics-API's zijn niet beschikbaar. Wissel naar een account met toegang en probeer opnieuw. Meldt WISEPIM een API-configuratieprobleem, neem dan contact op met support.
  </Accordion>

  <Accordion title="De koppeling werkt maar de rapporten zijn leeg">
    Controleer of de gekozen property bij deze storefront hoort, data ontvangt en minstens één succesvolle synchronisatie heeft afgerond. Verwerkingstijd bij GA4 en een lege geselecteerde periode kunnen recente ontbrekende data ook verklaren.
  </Accordion>

  <Accordion title="Verkeer is zichtbaar maar producten zijn niet gekoppeld">
    Controleer de e-commercepayload van je storefront. `item_id` moet exact gelijk zijn aan de WISEPIM-SKU, inclusief hoofdletters. Stuur geen productnaam, database-ID of variantlabel tenzij die waarde ook de SKU in WISEPIM is.
  </Accordion>

  <Accordion title="Een synchronisatie is gedeeltelijk of mislukt">
    Open de synchronisatiegeschiedenis voor de providerfout en de getroffen periode. Probeer eerst een normale synchronisatie. Gebruik **Volledig opnieuw synchroniseren** wanneer je na het herstellen van de property of trackingconfiguratie de volledige historie opnieuw wilt opbouwen.
  </Accordion>
</AccordionGroup>

## Gerelateerd

<CardGroup cols={2}>
  <Card title="Conversies" icon="arrow-right-left" href="/nl/analytics/conversions">
    Vind de grootste uitval in de GA4 e-commercefunnel.
  </Card>

  <Card title="Productprestaties" icon="box" href="/nl/analytics/product-performance">
    Koppel itemweergaven en aankopen aan producten en contentkwaliteit.
  </Card>

  <Card title="Google Search Console" icon="search" href="/nl/integrations/google-search-console">
    Voeg organische klikken, impressies, CTR en posities toe.
  </Card>

  <Card title="Alle integraties" icon="puzzle" href="/nl/integrations/supported-platforms">
    Bekijk alles wat je aan WISEPIM kunt koppelen.
  </Card>
</CardGroup>
