Google Analytics 4 verbinden met Elido

Elido stuurt conversiegebeurtenissen server-side naar GA4 via het Measurement Protocol. Dit betekent dat conversies in GA4 verschijnen ongeacht of de gebruiker een adblocker heeft, zonder enige JavaScript op je pagina.

Wat je nodig hebt

• Een GA4-property (geen Universal Analytics).
• Toegang tot het Admin-paneel van de property.
• Ongeveer 5 minuten.

Stap 1 — Je Measurement ID vinden

1. Ga naar Google Analytics.
2. Klik op Admin (tandwielicoon linksonder).
3. Klik onder Property op Data streams → Web.
4. Klik op je webdatastream.
5. Kopieer de Measurement ID — deze begint met G-, bijv. G-XXXXXXXXXX.

Stap 2 — Een Measurement Protocol API-secret aanmaken

Op dezelfde datastreampagina:

1. Scroll naar beneden naar Measurement Protocol API secrets.
2. Klik op Create.
3. Geef het een naam ("Elido") en klik op Create.
4. Kopieer de secretwaarde. Deze wordt maar één keer getoond. Ben je hem kwijt, maak dan een nieuwe aan — oude secrets blijven werken totdat je ze verwijdert.

Stap 3 — Configureren in Elido

1. Ga naar Dashboard → Conversions → GA4 → Set up forwarding.
2. Plak de Measurement ID en het API-secret.
3. Klik op Opslaan. Elido stuurt meteen een testgebeurtenis (elido_test) naar GA4.

Hoe Elido client_id toewijst

GA4 vereist een client_id om gebeurtenissen aan een gebruiker toe te schrijven. Elido leidt deze als volgt af:

1. Als de bestemmingspagina van je korte link een _ga-cookie instelt en de waarde via je conversiepixel wordt teruggestuurd — leest Elido deze direct.
2. Anders hasht Elido de Elido-click_id (bijv. clk_abc123) tot een stabiele, UUID-achtige tekenreeks en gebruikt die als client_id.

Dit betekent dat GA4 deze gebeurtenissen toont onder een "gebruiker" die mogelijk niet overeenkomt met je bestaande GA4-websessies — ze worden niet aan elkaar gekoppeld. Voor volledige sessiekoppeling stuur je de waarde van de _ga-cookie naar je server en neem je deze op in de Elido-Conversions API-aanroep.

Gebeurtenisnamen in GA4

Elido stuurt de volgende gebeurtenissen door:

Elido-gebeurtenis	GA4-gebeurtenisnaam
conversion.recorded	purchase (met waarde + valuta)
link.clicked (indien actief)	elido_click
threshold.exceeded	elido_threshold

De gebeurtenis purchase wordt gebruikt omdat GA4 hiervoor ingebouwde rapportage heeft in de sectie Monetization. Alle gebeurtenissen bevatten utm_source, utm_medium en utm_campaign als gebeurtenisparameters.

Probleemoplossing

Geen gebeurtenissen zichtbaar in Realtime — Controleer de Measurement ID en het API-secret. Een verkeerd API-secret geeft HTTP 204 (geen inhoud) terug, maar GA4 laat de payload stilzwijgend vallen. Verifieer door het Measurement Protocol-endpoint direct aan te roepen:

curl -X POST \
  "https://www.google-analytics.com/debug/mp/collect?measurement_id=G-XXXX&api_secret=YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"test","events":[{"name":"elido_test","params":{}}]}'

Een succesvolle debug-aanroep geeft {"validationMessages":[]} terug.

Gebeurtenissen verschijnen in Realtime maar niet in reguliere rapporten — Measurement Protocol-gebeurtenissen kunnen 24-48 uur duren voordat ze verschijnen in niet-realtime GA4-rapporten. Dit is een beperking van GA4, geen probleem van Elido.

Verkeerde valuta in purchase-gebeurtenissen — Elido leest de valuta uit het veld currency van de conversiegebeurtenis. De standaard is EUR. Stel deze expliciet in bij je API-aanroep voor het registreren van conversies.

Dubbele gebeurtenissen — Als je site ook client-side een GA4-purchase-gebeurtenis activeert, zie je dubbele registraties. Schakel de client-side gebeurtenis uit of gebruik een andere gebeurtenisnaam in de toewijzingsinstellingen van Elido.