GA4 Measurement Protocol API Secret aanmaken

Om server-side events naar Google Analytics 4 te versturen via het Measurement Protocol, heb je een API Secret nodig. Deze secret fungeert als authenticatiesleutel voor je server-side verzoeken en zorgt ervoor dat alleen geautoriseerde systemen data naar je GA4-property kunnen sturen.

In dit artikel laten we je stap voor stap zien hoe je deze API Secret aanmaakt. Let's get started 🚀

• Toegang tot Google Analytics met Editor- of Beheerder-rechten op de GA4-property.

• De Measurement ID (G-XXXXXXXXXX) van je GA4-gegevensstroom — deze heb je later samen met de secret nodig.

1. Log in op Google Analytics.

2. Klik linksonder op Beheer (tandwielicoon ⚙️).

3. Selecteer in de kolom Property de optie Gegevensstromen (Data Streams).

4. Klik op de webdatastroom waarvoor je de API Secret wilt aanmaken.

5. Scroll naar beneden tot je het kopje Google Analytics 4 Measurement Protocol ziet.

6. Klik op Measurement Protocol API-geheimen.

7. Klik rechtsboven op Aanmaken (Create).

8. Geef de API Secret een herkenbare bijnaam, bijvoorbeeld Server Side Tracking.

9. Klik op API-geheim aanmaken.

10. Kopieer de Geheimwaarde (Secret Value) en sla deze veilig op.

De API Secret gebruik je in combinatie met de Measurement ID (G-XXXXXXXXXX) in je server-side tracking setup. Voorbeelden:

• GA4 tag in je GTM server container — Vul de API Secret in als configuratieparameter.

• AdPage server container — De API Secret wordt gebruikt voor het doorsturen van events via het Measurement Protocol.

• Webhook-integraties — Bij het server-side versturen van events zoals purchase via webhooks.

⚠️ Let op: De API Secret is vertrouwelijk. Deel deze nooit publiekelijk en sla hem veilig op. De secret mag nooit worden blootgesteld in client-side code (zoals JavaScript in de browser).

Je hebt naast de API Secret ook de Measurement ID nodig. Deze vind je op dezelfde plek:

1. Ga naar Beheer > Gegevensstromen.

2. Klik op je webdatastroom.

3. De Measurement ID (G-XXXXXXXXXX) staat bovenaan de pagina onder Stroom-ID.

💡 Tip: Noteer de Measurement ID en API Secret samen, zodat je beide bij de hand hebt wanneer je je server-side tags configureert.

Kan ik meerdere API Secrets aanmaken voor dezelfde gegevensstroom? Ja, je kunt meerdere secrets aanmaken. Dit is handig als je verschillende systemen of omgevingen (bijv. staging en productie) apart wilt authenticeren.

Wat gebeurt er als ik een API Secret verwijder? Alle server-side verzoeken die deze secret gebruiken, worden niet meer geaccepteerd door GA4. Zorg ervoor dat je eerst je configuratie bijwerkt voordat je een secret verwijdert.

Ik zie de optie 'Measurement Protocol API-geheimen' niet. Wat nu? Controleer of je voldoende rechten hebt op de GA4-property (minimaal Editor-rechten). Als de optie niet zichtbaar is, heb je mogelijk alleen leesrechten.