Platform pack
UTM parameters for Microsoft Advertising
Where the tracking goes in Microsoft Advertising, what its dynamic values fill, the rules the pack checks, and a worked link. Read from the Microsoft Advertising pack, version 2026.09.1.
Where the tracking goes
In Microsoft Advertising, the pack puts UTM parameters in Final URL suffix. The pack also knows about: Final URL, Tracking template, Custom parameters.
The platform’s own click ID parameter is msclkid.
Limits the pack enforces:
trackingTemplateChars: 2048finalUrlChars: 2048customParamsPerEntity: 8customParamsPerExtension: 3
Source values the pack recognizes for this platform: bing, microsoft, microsoftads, microsoft_ads, msads.
Microsoft Advertising macros (dynamic values)
Dynamic insertion means the platform replaces a token with the real value, such as a campaign ID, when the ad is clicked. Tag Docket leaves these tokens untouched. Syntax: single braces.
| Token | What it fills | Recommended for | Valid in |
|---|---|---|---|
{campaignid} | Campaign ID | utm_id | |
{adgroupid} | Ad group ID | ||
{adid} | Ad ID | utm_content | |
{keyword} | Matching keyword | utm_term | |
{matchtype} | Match type | ||
{network} | o owned and operated | ||
{device} | Device type | ||
{msclkid} | Microsoft click identifier, a 32-character GUID | ||
{lpurl} | Landing page URL | Tracking template | |
{unescapedlpurl} | Landing page URL, unescaped | Tracking template | |
{escapedlpurl} | Landing page URL, escaped | Tracking template | |
{lpurl+2} | Escaped twice | Tracking template | |
{lpurl+3} | Escaped three times | Tracking template |
Which UTM field each value is for
Microsoft Advertising fills these in when the ad is clicked. Its variables mirror Google's, with {adid} where Google has {creative}.
utm_id={campaignid}. The Microsoft Advertising campaign ID.utm_term={keyword}. The keyword that matched.utm_content={adid}. The ad ID, so GA4 can tell ads apart.
Source, medium and campaign stay your own values, from your naming convention.
Rules and pitfalls
The pack checks a link against these before it is minted.
- Blocks
Microsoft caps the tracking template at 2,048 characters, protocol included.
- Blocks
Microsoft caps the final URL at 2,048 characters, protocol included.
- Blocks
A tracking template must begin with http://, https://, {lpurl} or {unescapedlpurl}.
- Blocks
Account, campaign and ad group templates must contain at least one landing page tag.
- Blocks
A final URL suffix may not start with ?, & or #.
- Blocks
A final URL suffix may not contain {ignore}, {lpurl}, {escapedlpurl} or other landing page placeholders.
- Blocks
Microsoft does not validate that a custom parameter exists. An undefined {_name} is neither substituted nor removed, so it arrives at the landing page as literal text with no error anywhere in the interface.
- Blocks
Microsoft accepts the first 8 custom parameters on campaigns, ad groups, criteria and ads.
A worked example
Built from the base preset’s convention: lowercase, _ between parts,
utm_source={platform}, utm_medium={channel} and
utm_campaign={season}_{offer}_{service}. Here the platform is bing,
the channel is cpc (Paid search) and the campaign is
spring26_freeestimate_roofing.
Parameters for Final URL suffix:
utm_source=bing&utm_medium=cpc&utm_campaign=spring26_freeestimate_roofing With the pack’s recommended values added:
utm_source=bing&utm_medium=cpc&utm_campaign=spring26_freeestimate_roofing&utm_id={campaignid}&utm_term={keyword}&utm_content={adid} On a plain landing-page link, the same three values read:
https://example.com/free-estimate?utm_source=bing&utm_medium=cpc&utm_campaign=spring26_freeestimate_roofing Where GA4 files it. Medium cpc lands in:
Paid Search for search engines, Paid Other otherwise. See every medium and its GA4 channel.
How this pack is monitored
Machine-readable, checked daily. Microsoft publishes these docs from a public GitHub repository, so a change arrives as a real commit rather than a rendered diff. The only genuinely machine-readable source.
The pack is verified (last verified September 28, 2026). Version 2026.09.1, effective September 28, 2026. Source: learn.microsoft.com/en-us/advertising/guides/url-tracking-upgraded-urls?view=bingads-13.
Related
- Free UTM checker: check a tagged link before it ships.
- UTM naming convention template for agencies
- All 8 platform packs
- Start free trial: every plan includes every platform pack.
Questions
Where do I put UTM parameters in Microsoft Advertising?
Does Microsoft Advertising have dynamic URL macros?
Is the Microsoft Advertising pack verified, and how is it monitored?
Bring the spreadsheet. We’ll show you the registry.
Start a free trial, no card needed. Your team signs in with an email link, no passwords.