Microsoft Ads: UET en de Conversions API via je servercontainer

Microsoft Advertising meet met de UET-tag in de browser en, sinds 2025, met een Conversions API die dezelfde events van je server aanneemt. De serverkant blijft tellen als UET geblokkeerd wordt en draagt gehashte klantgegevens voor enhanced conversions. Eén ding is anders dan bij Meta of TikTok: de twee kanten ontdubbelen niet tegen elkaar, dus jij kiest waar elk doel telt.

Wat je nodig hebt

• UET-tag-ID: Microsoft Advertising → Tools → Conversion tracking → UET tags.
• Conversions API-token: op de pagina van de UET-tag onder Conversions API.
• Klant-ID (optioneel): het klant-ID van je account, uit de accountinstellingen. Vul je het in, dan gaat client-side ID-sync aan, wat de matching verbetert.

Stap 1 · Voeg het toe aan je meetopzet

Open het domein in je dashboard, ga naar de pagina Settings en zoek Measurement setup. Vink de kaart van de bestemming aan en vul de ID's hieronder in. Tokens en API-sleutels worden versleuteld opgeslagen, buiten de setup zelf. De setup verstuurt zelf niets: het is de referentie waar de tracking audit en de templatebouwer van uitgaan, dus wat je hier invult is wat de audit in je containers verwacht te vinden.

Stap 2 · Genereer en importeer de containers

Ga naar Resources → GTM templates in het dashboard. Vink onder Destinations het platform aan (Google Analytics 4 en de e-commerce-events staan standaard aan; kies de Shopify-, WordPress- of Shopware-datalayer als je site een van onze plugins draait). Vul in de volgende stap dezelfde ID's in, kies Web + server onder Containers en download de twee JSON-bestanden.

Open in Google Tag Manager elke container, ga naar Admin → Import Container, kies het bijbehorende bestand, kies een nieuwe workspace en Merge. De import voegt alleen toe: nieuwe tags, triggers en variabelen met eigen namen, plus de galerijtemplates die ze nodig hebben. Controleer het resultaat in Preview en publiceer dan.

Stap 3 · Wat de import bevat

Webcontainer: de ingebouwde Microsoft Advertising-tags van Tag Manager: Bing - _Config laadt UET op elke pagina, en view_item, add_to_cart, begin_checkout en purchase worden als UET-events verstuurd met waarde en valuta.

Servercontainer: de template Microsoft Ads UET Conversion API (Stape, uit de galerij) als één tag die naar elk GA4-event luistert en de eventnamen zelf koppelt, met gehasht e-mailadres en telefoonnummer, IP-adres, user agent en msclkid. Met een ingevuld klant-ID doet de tag ook de ID-sync.

Stap 4 · Kies waar elk doel telt

Microsoft ontdubbelt een UET-event alleen tegen een Conversions API-event als beide hetzelfde event-ID dragen, en de ingebouwde UET-tag van Tag Manager kan er geen sturen. Bouw je conversiedoelen in Microsoft Advertising op één bron per doel: de Conversions API-events voor aankopen en leads, UET voor alles wat je alleen in de browser meet. Allebei voor hetzelfde doel verdubbelt de telling.

Stap 5 · Enhanced conversions

De servertag stuurt het gehashte e-mailadres en telefoonnummer dat hij op het event vindt. Onze Shopify-app, WordPress-plugin en Shopware-plugin pushen die velden bij aankopen en leads; push op een maatwerksite user_data mee met het event. Zet enhanced conversions aan voor de UET-tag in Microsoft Advertising.

Stap 5 · Toestemming

De geïmporteerde tags dragen de toestemmingsinstellingen van de referentiecontainers waaruit ze gekopieerd zijn. Controleer ze tegen je eigen toestemmingsopzet voordat je publiceert: een browserpixel hoort ad_storage te vereisen onder Aanvullende toestemmingscontroles of af te gaan op het event van je toestemmingstool, en de servertags horen alleen te sturen als de hit advertentietoestemming draagt. De toestemmingscontroles van de audit en de gids over tags die afgaan vóór toestemming laten zien hoe je allebei controleert.

Stap 6 · Testen

Gebruik de browserextensie UET Tag Helper voor de browserkant. Voor de serverkant toont Microsoft Advertising → Conversion tracking binnen een paar uur de Conversions API-events die onder de UET-tag binnenkomen.

Open aan de Measurebase-kant de pagina Requestlogs: als je door je site klikt, zie je GA4-events met een groene 200 bij je servercontainer binnenkomen. Open de previewmodus van de servercontainer om de servertag op die events te zien afgaan, met het event-ID en de gebruikersgegevens die hij oppikte.

Click-ID's

Safari en Brave strippen msclkid uit landings-URL's. Click ID Restorer herstelt hem vanuit een backup-parameter: stel een Final URL suffix in zoals backup_msclkid={msclkid} in Microsoft Advertising, en Measurebase zet de echte parameter op elk request terug. Cookie Keeper houdt de UET-cookies voorbij de 7-dagenlimiet van Safari.

Wat de tracking audit controleert

Elke nacht vergelijkt de tracking-audit je meetopzet met je live containers en je site. Voor elke bestemming controleert hij dat de tags bestaan in de container die je opzet verwacht, dat het ID in de container overeenkomt met dat in je opzet, dat een browserpixel en zijn servertag een event-ID delen, en welke cookies van het platform nog gezet worden nadat een bezoeker weigert. Bevindingen openen een melding de eerste keer dat ze verschijnen; wat de audit kan herstellen, stelt hij voor als wijziging in een aparte Measurebase-workspace in je container.

Veelgestelde vragen

Dekt de import ook Microsoft Clarity?

Clarity is een eigen bestemming in de templatebouwer en de meetopzet, alleen in de browser. Laad je Clarity via UET, dan kan de audit geen project-ID van de pagina lezen en slaat hij die controle over.