Naar inhoud
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Referentie voor gebeurtenisgegevens

Welke velden de GA4 App-client beschikbaar maakt in de servercontainer en hoe je controleert wat er daadwerkelijk binnenkomt.

De platformtags bouwen hun payload op uit de eventgegevens die de GA4 App-client beschikbaar stelt. Dit zijn de velden die je mapt, en de velden waar automatische toewijzing van een tag naar zoekt.

Velden van de GA4 App-client

Veld
Bevat
Meestal gebruikt voor

x-ga-platform

iOS of Android

Meta extinfo positie 0, TikTok-appinfo

x-ga-os_version

OS-versie van het apparaat

Meta extinfo positie 4, verplicht

x-ga-device_model

Apparaatmodel

Meta extinfo, apparaatreportage

app_id

Bundle- of pakketnaam

App-identificatie per platform

app_version

Appversie

Meta extinfo, debuggen per release

taal

Apparataal

Meta extinfo, landinstelling

app_instance_id

Firebase-instance-ID van de installatie

external_id voor de platformen

user_id

De eigen user-ID van de client, wanneer de app die instelt

external_id, cross-device

event_name

Het event, bijvoorbeeld signup

Triggers en eventtoewijzing

ga_session_id

GA4-sessie-ID

GA4-rapportage

Parameters die de app zelf met een event meestuurt, zoals een gehashte e-mailadrs of een waarde, verschijnen onder hun eigen namen naast deze velden.

Hoe je controleert wat binnenkomt

App-events verschijnen niet vanzelf in preview. Een request wordt alleen naar een previewsessie gerouteerd wanneer het de X-Gtm-Server-Preview header bevat, en de Firebase SDK voegt die header alleen toe nadat het apparaat aan de sessie is gekoppeld. Een container die in preview staat blijft daarom leeg terwijl de app prima events verstuurt.

Koppel het apparaat aan de previewsessie

1

Start preview

Open de server container en klik op Preview. Niet de webcontainer: een previewsessie op de webcontainer ziet nooit appverkeer.

2

Scan de QR-code met het apparaat

Gebruik de optie om een app te debuggen. De QR-code opent de app via het URL-scheme tagmanager.sgtm.c.[bundle-id] en slaat de previewtoken op, waarna de SDK bij elke upload de previewheader meestuurt.

3

Activeer het event

Het event verschijnt nu in de previewsessie.

4

Lees de eventgegevens

Selecteer de App-tracking client op het inkomende event en open het Eventgegevens tabblad. Zoek de velden op die je wilt mappen.

Of stuur zelf een request

Het previewscherm toont de waarde van de previewheader. Speel een request met die header opnieuw af vanuit curl of Postman en het komt in dezelfde sessie terecht. Handig om een mapping te testen zonder op een app-build te wachten.

Of sla preview helemaal over

De uitgaande requests van de container laten zien wat er daadwerkelijk is verzonden en wat elk platform heeft geantwoord, zonder apparaat of previewsessie. Voor de vraag "komt er überhaupt iets aan" is dat de snellere en betrouwbaardere route. Zie Testen en verifiëren.

Identifiers staan standaard niet in deze lijst

De advertising-ID van het apparaat (IDFA of GAID) wordt niet door Firebase op zichzelf doorgestuurd, en een e-mailadres ook niet. Die komen alleen binnen wanneer de app ze expliciet verstuurt. Zie Identificatoren en toestemming in apps.

Was dit nuttig?