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
| Field | Meaning |
|---|
| Event action | Standard events under Microsoft's names (lead: submit_lead_form, purchase: purchase, appointment: book_appointment, registration: sign_up), custom events under their own name. |
| Event ID | The same ID as the pixel or tag, so each event counts once. |
| Click ID and UET ID | msclkid and the UET tag's visitor ID. |
| Contact details | Email and phone, hashed. |
| Value and currency | For payments and won deals. |
Setup
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.
02Set the tracking template (recommended)At ad level, enter the tracking template from TSO; Microsoft replaces {lpurl} with the final URL.
03Connect the UET tagTag ID and token are in Microsoft Advertising under "Tools" → "UET tag": edit tag → "Use Conversions API" → "Copy token".
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.
05Set the rulesDecide which data goes to Microsoft and which conversions count.
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
| Problem | Solution |
|---|
| 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.
Find out which ads pay off.
Hosted in Germany · Built in Austria