De inzet van de Microsoft Ads conversion API in combinatie met server-side tagging is een langverwachte CAPI waar Microsoft Ads toch enigszins achter Meta Ads, Pinterest Ads en andere advertentieplatformen heeft aangehobbeld. Het wint aan populariteit vanwege zijn vermogen om pixel-blocking door ITP’s en AdBlockers te omzeilen en de levensduur van de Microsoft-cookies te verlengen.
Let op: Microsoft Ads heeft ook Bing onder zich. Veel van de bronnen op websites blijven herkenbaar als Bing-bronnen. Daarom gebruiken we beide namen (Microsoft Ads conversion API en Bing conversion API) door elkaar.
Nog een let op: De Microsoft Ads CAPI is op het moment van schrijven (2 dec 2025) nog in Bèta. Onderstaande informatie kan daardoor verouderd zijn, maar we doen ons best om het up-to-date te houden.
Snel naar
Waar vind je de Microsoft Ads authorization token?
Om de Microsoft/Bing Ads CAPI succesvol in te stellen, heb je een Microsoft Ads Authorization Token nodig. Deze kun je niet altijd terugvinden in je Microsoft Ads account, omdat de CAPI nog in pilotfase is op het moment van schrijven (2 dec 2025). Je moet je Microsoft Ads contactpersoon/account vertegenwoordiger aanhaken zodat het voor je kan worden aangezet binnen je ads account. Je neemt vervolgens de volgende stappen:
- Ga naar Microsoft advertising > Conversies > UET-tag.
- Klik achter de tagnaam op het potloodje (tag bewerken).
- Stap 1: Creëer UET-tag kun je overslaan aangezien je de tag al hebt. Klik op Opslaan en volgende.
- Kies onder “Tagging instellen” bij stap 2 voor “De conversion API gebruiken”.
Klik vervolgens op de token kopiëren.
Andere stappen kun je negeren en doorklikken. Je hebt de token nu verkregen.
Microsoft Ads/Bing Conversion API (CAPI) instellen met Google Tag Manager in 3 stappen
Voor het gemak kun je het beste je web container (client side) en je de server container (server side) naast elkaar open zetten, je hebt ze namelijk allebei nodig.
Stap 1: Voeg de Microsoft Ads CAPI tag toe aan je server Google Tag Manager container
- Ga naar je server GTM container.
- Vervolgens ga je naar templates.
- Doorzoek de Tag Template gallery > Zoek op “Microsoft Ads UET Conversion API by Stape”
- Klik vervolgens op Toevoegen aan werkruimte. Het template is nu toegevoegd en klaar om als tag ingesteld te worden.
- Ga nu naar Tags in het menu.
- Klik op Nieuw > Klik bij Tag configuratie op het template wat je net hebt toegevoegd.
- Geef de tag een logische naam, bijvoorbeeld “Microsoft Ads – Purchase” als je de aankoop conversie server-side wil meten.
- Vul de Microsoft UET Tag ID in. Je kan hier een constant variabele voor aanmaken om deze makkelijk te hergebruiken in andere tags. De Microsoft Advertising UET Tag ID vind je in je Microsoft Advertising account onder “Conversies” > “UET tag” > Tag-ID.
- Voeg het Microsoft Ads Authorization Token toe. Je kan hier een constant variabele voor aanmaken om deze makkelijk te hergebruiken in andere tags. Let op: Het kan zijn dat je deze niet terugvindt in je account op het moment van schrijven (2 dec 2025), zie het deel “Waar vind je de Microsoft Ads authorization token?”.
- Voeg nu ook de Microsoft Customer ID / Manager Account ID toe. Je vindt de ID als volgt: Zoek de url af naar de cid url parameter. Achter cid= zie je je ID staan tot aan het volgende & teken. Je kan hier een constant variabele voor aanmaken om deze makkelijk te hergebruiken in andere tags.
- Laat de Enable Client-Side ID Sync aanstaan (de default zou aan moeten zijn). Hierdoor kunnen je interne ID’s worden toegewezen aan Microsoft ID’s voor betere gebruikersmatching en remarketing. Het is echter wel aangeraden om dan ook een User-ID mee te sturen. Hierover later meer in deze uitleg.
- We zijn geen fan van use-optimistic scenario, laat deze liever uit staan. Hiermee zal de tag namelijk altijd succes teruggeven tijdens het testen, terwijl dat niet per se zo hoeft te zijn.
Let op: Op het moment van schrijven (20 september 2025) is de Microsoft/Bing CAPI nog in Beta. Het ontdubbelen (deduplication) van de gebeurtenissen/events in Google Tag Manager is hierdoor nog niet mogelijk. Daarom kun je het beste een 2de conversie inregelen naast je bestaande conversie die specifiek voor server-side Google Tag Manager is.
Stap 2: De Microsoft Ads tag/conversies kiezen en verder inregelen
In de tag heb je de mogelijkheid om te kiezen tussen de Inherit from client of de Standaard event setup methodes. Inherit from client zal de volgende gebeurtenissen automatisch voor je mappen aan de hand van de GA4 standaard:
- page_view → pageLoad
- search → custom (Page Type = searchresults; Event Name = search)
- view_search_results → custom (Page Type = searchresults; Event Name = view_search_results)
- view_item → custom (Page Type = product; Event Name = view_item)
- view_cart → custom (Page Type = cart; Event Name = view_cart)
- purchase → custom (Page Type = purchase; Event Name = purchase)
Indien je voor een basis e-commerce setup gaat is dit perfect, in andere gevallen zul je voor de standaard event setup moeten gaan.
Controleer de onderstaande instellingen bij je event tag:
- Stuur de click ID mee. Click ID: uet_msclkid
- Stuur de anonymous ID mee. Anonymous ID: uet_vid
- Consent granted for event. Kun je op automatisch zetten als je in de sGTM container ad_storage consent = granted in je trigger hebt zitten.
- Server event data parameter > Event ID > voeg de Event ID toe. Als het goed is stuur je de Event ID al mee vanuit de webcontainer en heb je deze als server event data variabele beschikbaar om hier in te vullen.
- Automap event parameters. Deze zal de event gegevens op basis van GA4 proberen te mappen en door te sturen naar Microsoft Ads. Als je gebruikt maakt van de standaard GA4 indeling (deze kun je hier vinden) dan zal dit goed werken,
Stap 3: Valideren of het werkt
Nu is het tijd om te controleren of alles goed werkt. Preview je server container en trigger het event dat je wil testen. Check vervolgens of de tag goed is afgevuurd. Voor meer inzicht kun je de “log during preview” optie in de tag nog aanzetten.
FAQ
- Waar kan ik de Microsoft Authorization Token vinden?
Op het moment van schrijven (2 december 2025) kun je de token nog alleen zelf uit je Microsoft ads omgeving halen indien je Microsoft Ads account manager dit voor je heeft aangezet. Neem hiervoor contact op met je Microsoft Ads account manager.
Bronnen
- Microsoft UET Conversion API Tag for Google Tag Manager Server-Side tag repository op Github:
https://github.com/stape-io/microsoft-capi-tag - De Microsoft Ads conversion API documentatie van Microsoft zelf:
https://learn.microsoft.com/nl-nl/advertising/guides/uet-conversion-api-integration?view=bingads-13