> For the complete documentation index, see [llms.txt](https://docs.adpage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adpage.io/documentation/documentation-nl/app-tracking/referentie-voor-gebeurtenisgegevens.md).

# 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.

{% hint style="warning" %}
Beschouw deze tabel als de verwachte situatie, niet als een garantie. Wat de client levert, hangt af van de SDK-versie en van wat de app verstuurt. Bevestig altijd in preview voordat je op basis van een van deze velden een mapping maakt.
{% endhint %}

## 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

{% stepper %}
{% step %}

## Start preview

Open de **server** container en klik op Preview. Niet de webcontainer: een previewsessie op de webcontainer ziet nooit appverkeer.
{% endstep %}

{% step %}

## 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.
{% endstep %}

{% step %}

## Activeer het event

Het event verschijnt nu in de previewsessie.
{% endstep %}

{% step %}

## 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.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Dit werkt alleen wanneer de app het scheme ondersteunt: op Android een preview-activiteit zoals `GoogleAnalyticsServerPreviewActivity`, op iOS het URL-scheme plus de open-URL-handler van de SDK (`Analytics.handleOpen`). App-ontwikkelaars slaan de iOS-kant vaak over omdat die alleen preview beïnvloedt. Preview blijft dan leeg terwijl liveverkeer prima werkt, dus vraag of het is geïmplementeerd voordat je concludeert dat er niets binnenkomt.
{% endhint %}

### 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**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.adpage.io/documentation/documentation-nl/app-tracking/referentie-voor-gebeurtenisgegevens.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
