Tag Docket

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.

Machine-readable, checked daily Verified September 28, 2026

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: 2048
  • finalUrlChars: 2048
  • customParamsPerEntity: 8
  • customParamsPerExtension: 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

Questions

Where do I put UTM parameters in Microsoft Advertising?
Tag Docket's Microsoft Advertising pack puts them in Final URL suffix. Microsoft Advertising fills these in when the ad is clicked. Its variables mirror Google's, with {adid} where Google has {creative}.
Does Microsoft Advertising have dynamic URL macros?
The pack lists 13 ({campaignid}, {adgroupid}, {adid}, {keyword}, and more). The single braces syntax is the platform's own, and Tag Docket passes it through unchanged.
Is the Microsoft Advertising pack verified, and how is it monitored?
Verified on September 28, 2026. 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.

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.