Skip to content

Microsoft Ads UET Conversions API with TSO

Conversions to Microsoft Advertising through the UET Conversions API, deduplicated with the UET tag, plus cost import.

What is transferred

FieldMeaning
Event actionStandard events under Microsoft's names (lead: submit_lead_form, purchase: purchase, appointment: book_appointment, registration: sign_up), custom events under their own name.
Event IDThe same ID as the pixel or tag, so each event counts once.
Click ID and UET IDmsclkid and the UET tag's visitor ID.
Contact detailsEmail and phone, hashed.
Value and currencyFor payments and won deals.

Setup

  1. 01Connect a Microsoft loginUnder "Ad accounts", connect a Microsoft login. Campaigns and costs arrive in TSO; every sync extends the login, unused it expires after 90 days.
  2. 02Set the tracking template (recommended)At ad level, enter the tracking template from TSO; Microsoft replaces {lpurl} with the final URL.
  3. 03Connect the UET tagTag ID and token are in Microsoft Advertising under "Tools" → "UET tag": edit tag → "Use Conversions API" → "Copy token".
  4. 04Create conversion goalsIn Microsoft Advertising, create conversion goals of type "Event" whose action matches the event name, e.g. submit_lead_form for leads and purchase for purchases.
  5. 05Set the rulesDecide which data goes to Microsoft and which conversions count.
  6. 06Load the UET tag (optional)Load the UET tag through the TSO script if the page doesn't have its own yet.

What TSO does with Microsoft Ads

  • UET Conversions API: conversions with msclkid, UET visitor ID and hashed contact details, with the same event ID as the UET tag.
  • UET tag: loaded through the TSO script if you like.
  • Cost import: campaigns, costs and metrics.

More on the conversion API page.

Common problems and solutions

ProblemSolution
Conversions don't show up in any goal.The conversion goal must be of type "Event" and its action must match the event name (e.g. submit_lead_form).
Costs are no longer imported.Unused Microsoft logins expire after 90 days. Reconnect the login under "Ad accounts".
Events are counted twice.Don't load the pixel or tag through TSO as well if the page already has its own.

Frequently asked questions

Does TSO use Microsoft's offline conversions API?

No, TSO sends through the UET Conversions API.

Which names do my custom events get?

They go under their own name as event action; create a matching conversion goal for them.

More integrations

Find out which ads pay off.

Hosted in Germany · Built in Austria