> 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/meta-ads-appgebeurtenissen.md).

# Meta Ads-appgebeurtenissen

Stuur app-conversies via de Conversions API naar Meta, met de apparaatinformatie die Meta vereist.

{% hint style="info" %}
**Status: schets.** Secties 1, 3 en 6 zijn bevestigd door een live implementatie. De open punten zijn gemarkeerd.
{% endhint %}

## 1. Wat Meta nodig heeft voor app-events

Een event met action source `app` wordt alleen geaccepteerd wanneer het een `app_data` object bevat met:

* `extinfo`: een array van 16 waarden. Positie 0 is de extinfo-versie, `i2` voor iOS en `a2` voor Android. Positie 4 is de OS-versie. Beide zijn verplicht, de andere posities mogen lege strings zijn.
* `advertiser_tracking_enabled` en `application_tracking_enabled`.

Zonder dat object antwoordt Meta met HTTP 400, code 100, subcode 2804043, "verkeerde extinfo-versie of OS-versie". Het event verschijnt niet in Events Manager, zelfs niet onder Test Events.

## 2. Wat je aan de Meta-kant instelt

* Toegang tot de advertentieaccount en tot Events Manager, om te verifiëren.
* **Open:** bevestig of app-events naar de bestaande pixel-dataset met action source moeten gaan `app`, of naar een aparte app-dataset die in Events Manager is geregistreerd. Noteer de gevolgen voor rapportage en campagne-optimalisatie.

## 3. Tagconfiguratie

| Veld           | Waarde                                                                   |
| -------------- | ------------------------------------------------------------------------ |
| Tagtype        | Facebook Conversion API (Stape)                                          |
| Trigger        | `Client Name` is gelijk aan de App client, plus de eventnaam             |
| Action source  | `app`                                                                    |
| App data       | Automap aan, of `extinfo` en beide tracking-vlaggen handmatig toegewezen |
| Gebruikersdata | De identificatiecode die met de app-ontwikkelaar is afgesproken          |

Met een huidige versie van de tagsjabloon, **Automap App Data** bouwt `extinfo` vanuit `x-ga-platform`, `app_id`, `app_version`, `x-ga-os_version`, `x-ga-device_model` en `taal`. Er gelden twee voorwaarden: de sjabloon moet actueel zijn en de tag moet afgaan op de App client, omdat die velden niet bestaan op de webclient.

Als de sjabloon ouder is, heeft de sectie App Data geen automap-optie en wordt een leeg object verzonden. Werk de sjabloon bij, of map `extinfo` zelf. Het waardeveld is tekst, dus een array moet uit een variabele komen: ofwel een galerijvariabele zoals Object Builder of JSON Converter, of een aangepaste templatesvariabele van jezelf. Een servercontainer heeft geen Custom JavaScript-variabeletype.

{% hint style="warning" %}
Door de action source in te stellen op `other` accepteert Meta het event zonder apparaatinformatie. Gebruik dit alleen als tijdelijke stap terwijl de app wordt hersteld, nooit als eindtoestand, omdat app-campagnes `app` voor attributie nodig hebben.
{% endhint %}

## 4. Identificatoren die dit platform accepteert

`madid`, `anon_id`, `external_id`, en gehashte `em`, `ph`, `fn`, `ln`. Zie **Identificatoren en toestemming in apps**. Merk op dat de gebruikersdatavariabelen van een webtag verwijzen naar web dataLayer-paden en leeg zijn voor app-events, dus ze moeten worden opnieuw toegewezen.

## 5. Hoe te testen

* Events Manager, onder Test Events, met een `test_` voorvoegsel in de eventnaam tijdens de testfase.
* De uitgaande verzoeken van de container, die zowel de payload als het antwoord van Meta tonen. Dit is de snellere route en werkt zonder toegang tot de advertentieaccount van de klant.

## 6. Bekende fouten

| Antwoord                       | Oorzaak                                                 | Oplossing                                                              |
| ------------------------------ | ------------------------------------------------------- | ---------------------------------------------------------------------- |
| 400, code 100, subcode 2804043 | `app_data` leeg, of de platform- of OS-versie ontbreekt | Werk de sjabloon bij en schakel automap in, of map `extinfo` handmatig |

**Open:** breiden uit naarmate we er meer van zien.

## 7. Limieten

* Zonder identificator wordt het event geaccepteerd maar nauwelijks toerekenbaar.
* Op iOS is de advertentie-id alleen beschikbaar met trackingtoestemming, wat de app-attributie op dat platform beperkt.
* **Open:** beschrijf hoe deze events zich gedragen in campagne-optimalisatie zodra een klant er een tijdje op draait.


---

# 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/meta-ads-appgebeurtenissen.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.
