> 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/integraties-marketingtools/microsoft-ads.md).

# Microsoft Ads

Configureer de Microsoft UET-tag en de Conversions API met deduplicatie op basis van gebeurtenis-ID's.

Stel eerst de Microsoft UET-tag in de webcontainer in. Stuur daarna overeenkomende gebeurtenissen via de Microsoft Conversions API (CAPI) vanuit de servercontainer.

Beide tags sturen dezelfde conversie. Geef beide dezelfde UET Tag ID, dezelfde gebeurtenisnaam en dezelfde gebeurtenis-ID. Microsoft kan de gebeurtenissen dan dedupliceren en één conversie tellen.

Deze hybride opzet is wat Microsoft aanbeveelt. UET legt browsercontext vast, zoals de klik-ID en paginadetails. CAPI voegt een server-side route toe die niet wordt beïnvloed door adblockers en browser-cookiebeperkingen, en die ook conversies kan rapporteren die later plaatsvinden, buiten de browser.

{% hint style="info" %}
Deze pagina behandelt **tracking**: conversies naar Microsoft Ads verzenden. Om Microsoft-kosten- en conversiegegevens in AdPage-rapporten en het Marketing Mix Model te krijgen, zie [Microsoft Advertising](https://claude.ai/data-and-insights/marketing-integrations/microsoft-advertising).
{% endhint %}

#### Wat je gaat configureren

Je maakt het volgende aan:

* Een Microsoft UET-tagopzet in de GTM-webcontainer, met toestemmingsmodus.
* Een **Microsoft Ads UET Conversion API** tag in de GTM-servercontainer.
* Eén gedeelde `event_id` voor elke overeenkomende browser- en servergebeurtenis.

Gebruik deze pagina voor de volledige implementatie. Zie ook:

* [Waar je de UET Tag ID, Customer ID en API-token kunt vinden](https://docs.adpage.io/documentation/documentation-nl/integraties-marketingtools/microsoft-ads/waar-je-de-uet-tag-id-klant-id-en-api-token-vindt.md)
* [Deduplicatie van Microsoft Ads-gebeurtenis-ID](https://docs.adpage.io/documentation/documentation-nl/integraties-marketingtools/microsoft-ads/deduplicatie-van-microsoft-ads-event-id.md)
* [Klik-ID, cookies en toestemming](https://docs.adpage.io/documentation/documentation-nl/integraties-marketingtools/microsoft-ads/klik-id-cookies-en-toestemming.md)
* [Webhook- en offline conversies](https://docs.adpage.io/documentation/documentation-nl/integraties-marketingtools/microsoft-ads/webhook-en-offline-conversies.md)

#### Voordat je begint

Zorg dat je het volgende hebt:

* [ ] &#x20;Een GTM-webcontainer met GA4-gebeurtenistags.
* [ ] Een GTM-servercontainer die de GA4-gebeurtenissen ontvangt.
* [ ] De **UET Tag ID**, de **Conversions API-token** en de **Customer ID** van Microsoft Advertising. Zie [Waar je de UET Tag ID, Customer ID en API-token kunt vinden](https://docs.adpage.io/documentation/documentation-nl/integraties-marketingtools/microsoft-ads/waar-je-de-uet-tag-id-klant-id-en-api-token-vindt.md).
* [ ] Ten minste één **conversiedoel** in Microsoft Advertising dat deze UET-tag gebruikt.
* [ ] Een **Unieke gebeurtenis-ID** variabele in de webcontainer.
* [ ] Automatisch taggen ingeschakeld in Microsoft Advertising, zodat advertentieklikken `msclkid` in de URL van de landingspagina bevatten.

{% hint style="warning" %}
De API-token hoort bij één specifieke UET-tag. Gebruik de token en de Tag ID van dezelfde tag, in beide containers. Een token die voor een andere UET-tag is gegenereerd, geeft `401 Unauthorized`.
{% endhint %}

### Deel 1: client-side tracking instellen

#### **Stap 1: Maak een UET Tag ID-variabele aan**

1. Open je GTM-webcontainer en ga naar **Variabelen**.
2. Maak een **Constante** variabele aan.
3. Stel de waarde in op de UET Tag ID en sla deze op.

#### **Stap 2: Maak de UET-basis-tag aan**

1. Ga naar **Tags** en maak een nieuwe tag aan.
2. Kies **Microsoft Advertising Universal Event Tracking** als tagconfiguratie. Als die nog niet beschikbaar is, voeg hem dan toe vanuit de **Community Template Gallery**.
3. Selecteer je UET Tag ID-variabele.
4. Stel het tagtype in op **Paginaweergave**.
5. Gebruik de trigger die je voor alle pagina's gebruikt (Page View of `cookie_consent_update`).

#### **Stap 3: Configureer de UET-toestemmingsmodus**

Microsoft vereist UET-toestemmingsmodus voor bezoekers in de EER, het VK en Zwitserland. UET leest één signaal, `ad_storage`. Dit moet standaard ingesteld zijn op `geweigerd` en worden bijgewerkt naar `verleend` alleen wanneer de bezoeker marketingcookies accepteert.

Open de toestemmingsinstellingen in de UET-tag en schakel de opties in die de GTM-toestemmingsstatus overnemen en luisteren naar toestemmingsupdates. Dit werkt alleen wanneer je CMP de standaard van Google Consent Mode instelt op `geweigerd` voordat de UET-tag wordt geladen. Zie [Toestemmingsbeheer](https://docs.adpage.io/documentation/documentation-nl/optimaliseer-je-installatie/toestemmingsbeheer.md).

Details en alternatieven staan op [Klik-ID, cookies en toestemming](https://docs.adpage.io/documentation/documentation-nl/integraties-marketingtools/microsoft-ads/klik-id-cookies-en-toestemming.md).

#### **Stap 4: Maak de conversietags aan**

1. Maak een nieuwe **Microsoft Advertising Universal Event Tracking** tag aan.
2. Selecteer je UET Tag ID-variabele.
3. Stel het tagtype in op een **aangepaste gebeurtenis** en vul de **Event Action** in die je conversiedoel in Microsoft Advertising verwacht, bijvoorbeeld `purchase`.
4. Voeg voor een aankoop de omzetwaarde en valuta toe.
5. Voeg een aangepaste parameter toe met de naam `event_id`:
   * Gebruik voor een aankoop de order-ID.
   * Gebruik voor alle andere gebeurtenissen je variabele Unieke gebeurtenis-ID.
6. Gebruik dezelfde trigger als de overeenkomende GA4-gebeurtenistag.

Herhaal dit voor elke gebeurtenis die je wilt volgen.

{% hint style="info" %}
Waarom de order-ID voor aankopen? Een aankoop kan vanuit de browser of vanuit een webshop-webhook in de servercontainer terechtkomen. De order-ID is de enige waarde die beide routes kennen. Zie [Deduplicatie van Microsoft Ads-gebeurtenis-ID](https://docs.adpage.io/documentation/documentation-nl/integraties-marketingtools/microsoft-ads/deduplicatie-van-microsoft-ads-event-id.md).&#x20;
{% endhint %}

#### **Stap 5: Geef de gebeurtenis-ID door aan GA4**

Voeg dezelfde gebeurtenis-ID toe aan elke overeenkomende GA4-gebeurtenistag:

1. Open de GA4-gebeurtenistag.
2. Voeg een gebeurtenisparameter toe met de naam `event_id`.
3. Stel de waarde in op dezelfde variabele die je in de UET-tag voor die gebeurtenis hebt gebruikt.
4. Sla de tag op.

De servercontainer kan nu de gebeurtenis-ID uit de GA4-gebeurtenis lezen.

### Deel 2: server-side tracking instellen

#### **Stap 6: Voeg de Conversions API-template toe**

1. Open je GTM-servercontainer en ga naar **Templates**.
2. Onder **Tag Templates**, klik op **Search Gallery**.
3. Voeg de **Microsoft Ads UET Conversion API** template van Stape toe.

#### **Stap 7: Sla de inloggegevens op**

Maak twee **Constante** variabelen aan in de servercontainer: één voor de UET Tag ID en één voor de Conversions API-token. Je hebt dan maar één plek om ze te wijzigen.

#### **Stap 8: Maak de server-side tag aan**

1. Maak een nieuwe **Microsoft Ads UET Conversion API** tag aan.
2. Onder **Event Type Setup Method**, kies **Overnemen van client**. Kies **Standaard** alleen wanneer je het type gebeurtenis en de naam handmatig moet instellen.
3. Vul de **UET Tag ID** en **Autorisatietoken** variabelen in.
4. Schakel **Client-Side ID Sync** en vul de **Customer ID**in. Dit is niet de UET Tag ID.
5. Laat **Use Optimistic Scenario** uit staan. Als dit aan staat, rapporteert de tag altijd succes, zelfs wanneer Microsoft het verzoek afwijst.
6. Voeg de **Gebruikersdataparameters** die je hebt, minstens één. E-mail en telefoon worden door de tag gehasht.
7. Houd **Auto-mapping** ingeschakeld onder **Server Event Data Parameters** en **Event Parameters**.

#### **Stap 9: Geef de gebeurtenis-ID door aan Microsoft**

1. Maak een **Event Data** variabele met sleutelpad `event_id`.
2. Open de Microsoft Ads UET Conversion API-tag.
3. Onder **Server Event Data Parameters**, voeg **Event ID**.
4. in. Stel de waarde in op de `event_id` variabele aan.

#### **Stap 10: Configureer toestemming en de trigger**

De Conversions API behandelt elke gebeurtenis als toegestaan, tenzij anders wordt aangegeven. Scherm de tag af zodat deze alleen wordt geactiveerd voor bezoekers die marketingcookies hebben geaccepteerd:

* Voeg de toestemmingsvoorwaarde uit [Toestemmingsbeheer, stap 3](https://docs.adpage.io/documentation/documentation-nl/optimaliseer-je-installatie/toestemmingsbeheer.md#step-3-configure-server-side-triggers-based-on-consent) toe aan de trigger.
* Onder **Server Event Data Parameters**, stel de **Ad Storage-toestemming** parameter in op verleend voor deze gebeurtenissen.

Maak een trigger voor de gebeurtenissen die je wilt verzenden. Gebruik beide voorwaarden:

* `{{Event Name}}` komt overeen met RegEx `page_view|purchase` (breid dit uit met je andere gebeurtenissen).
* `{{Client Name}}` is gelijk aan `GA4`.

Stuur `page_view` samen met je conversies. Gebeurtenissen bij het laden van pagina's zijn wat Microsoft gebruikt voor doel-URL-doelen en remarketing.

{% hint style="info" %}
De UET-tag en de Conversions API-tag moeten dezelfde UET Tag ID, gebeurtenisnaam en gebeurtenis-ID gebruiken. Een verschil in één van de drie voorkomt deduplicatie.
{% endhint %}

### Test en valideer de volledige opzet in voorbeeldmodus

Voordat je publiceert, bevestig je dat de klik-ID de servercontainer bereikt en dat de Conversions API-tag deze doorstuurt naar Microsoft.

{% hint style="danger" %}
De Microsoft Conversions API heeft geen testmodus. Elke gebeurtenis die je tijdens het testen verstuurt, wordt als echte gebeurtenis vastgelegd. Test met een klein aantal conversies en houd deze bij.&#x20;
{% endhint %}

**Bereid de test voor**

1. Open een nieuwe browsersessie. Koppel GTM-voorbeeldmodus voor zowel de webcontainer als de servercontainer.
2. Werk in een aparte werkruimte.
3. Open een landingspagina met een testklik-ID, bijvoorbeeld `https://yourdomain.com/?msclkid=0123456789abcdef0123456789abcdef`. Een echte `msclkid` is een hexadecimale tekenreeks van 32 tekens. Je kunt ook op een live advertentie klikken.

**Waar je moet kijken in servervoorbeeld**

| Locatie                         | Wat je moet controleren                                                                                                                                                                                                                        |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Binnenkomend verzoek (client)   | De `cookie` header bevat `_uetmsclkid` en `_uetvid` van de UET-tag, of `uet_msclkid` en `uet_vid` ingesteld door de servertag. Als ze ontbreken, draait de servercontainer waarschijnlijk niet op een first-party domein van de website.       |
| Event Data                      | `page_location` bevat `msclkid` op de landingspagina. `event_id` is aanwezig. De toestemmingsstatus toont dat marketingtoestemming is verleend.                                                                                                |
| Microsoft-tag → Verzoek         | De URL is `https://capi.uet.microsoft.com/v1/<UET-TAG-ID>/events`. De `Autorisatie` header gebruikt het Bearer-schema. De body bevat `eventType`, `eventId`, `eventName`, `eventTime` en een `userData` object met `msclkid` en `anonymousId`. |
| Microsoft-tag → Antwoord        | Status `200`. Een `401` betekent dat de token en Tag ID niet bij elkaar horen. Een `400` geeft het veld met de fout weer.                                                                                                                      |
| Browser → Application → Cookies | `uet_msclkid` en `uet_vid` bestaan met het verwachte domein en de verwachte vervaldatum.                                                                                                                                                       |

**Voer de testsituaties uit**

| # | Scenario                                                              | Verwacht resultaat                                                                                                                                                          |
| - | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1 | Landingspagina met `msclkid` in de URL, marketingtoestemming verleend | De eerste gebeurtenis bevat `msclkid`, gelijk aan de URL-waarde zonder streepjes. De `uet_msclkid` cookie is ingesteld.                                                     |
| 2 | Tweede paginaweergave zonder `msclkid` in de URL                      | `msclkid` komt uit de cookie en heeft dezelfde waarde.                                                                                                                      |
| 3 | Tweede advertentieklik met een andere `msclkid`                       | De nieuwe waarde wordt verzonden en de cookie wordt overschreven.                                                                                                           |
| 4 | Direct bezoek zonder `msclkid`                                        | `msclkid` wordt weggelaten uit de body. Het is geen lege tekenreeks.                                                                                                        |
| 5 | Marketingtoestemming geweigerd                                        | Er gaat geen verzoek naar Microsoft en de UET-tag blijft in de geweigerde modus.                                                                                            |
| 6 | Toestemming gegeven nadat de landingspagina was geladen               | De eerste Microsoft-gebeurtenis na de toestemmingsupdate bevat nog steeds `msclkid` van de URL van de landingspagina.                                                       |
| 7 | UET en Conversions API samen                                          | Beide sturen dezelfde gebeurtenisnaam en gebeurtenis-ID, dus er wordt maar één conversie geteld.                                                                            |
| 8 | Aankoop verzonden vanuit een webshop-webhook                          | Er zijn geen browsercookies beschikbaar. Zie [Webhook- en offline conversies](https://claude.ai/integrations-marketingtools/microsoft-ads/webhook-and-offline-conversions). |

**Controleer de reactie op waarschuwingen**

Een `200` Een reactie betekent niet dat elk veld is geaccepteerd. Microsoft verwijdert optionele velden die niet bruikbaar zijn, zoals een ongeldige hash of valuta, en accepteert de gebeurtenis toch. Open de response body in voorbeeldmodus. Elke invoer met `isWarning: true` is een veld dat Microsoft niet heeft bereikt.

**Controleer het resultaat na publicatie**

Bevestig in de uitgaande request-logs dat:

* Landingspagina's met `msclkid` in de URL dragen `msclkid` in de request-body.
* Vervolg-paginaweergaven dragen dezelfde waarde.
* Aankopen dragen dezelfde `eventId` als de order-ID.
* Het aantal niet-2xx-antwoorden neemt niet toe.

In Microsoft Advertising kunnen conversies enkele uren nodig hebben om in de kolommen van het conversiedoel te verschijnen.

{% hint style="warning" %}
Stuur alleen de klik-ID, gehashte e-mails en cookiewaarden voor bezoekers die marketingtoestemming hebben gegeven.
{% endhint %}


---

# 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/integraties-marketingtools/microsoft-ads.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.
