Tag Docket

Platform pack

UTM parameters for TikTok

Where the tracking goes in TikTok, what its dynamic values fill, the rules the pack checks, and a worked link. Read from the TikTok pack, version 2026.09.1.

Documentation page monitored Verified September 28, 2026

Where the tracking goes

In TikTok, the pack puts UTM parameters in URL parameters. The pack also knows about: Mobile measurement partner ad tag.

TikTok runs two tracking systems. Website destination URLs use a parameter builder with no documented inline macros. The __TOKEN__ macros below are documented under Mobile Measurement Partners, for app measurement ad tags. Whether they also resolve in website URLs is not stated either way — see the open question in the catalogue.

The platform’s own click ID parameter is ttclid.

The platform adds some parameters itself: utm_source=TikTok,utm_medium=Paid.

Source values the pack recognizes for this platform: tiktok.

TikTok 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: double underscores.

Token What it fills Valid in
__CAMPAIGN_ID__ Campaign ID Mobile measurement partner ad tag
__CAMPAIGN_NAME__ Campaign name Mobile measurement partner ad tag
__AID__ AD SET id, despite the name Mobile measurement partner ad tag
__AID_NAME__ AD SET name, despite the name Mobile measurement partner ad tag
__CID__ AD id, despite the name Mobile measurement partner ad tag
__CID_NAME__ AD name, despite the name Mobile measurement partner ad tag
__PLACEMENT__ Placement, for example TikTok or HELO Mobile measurement partner ad tag
__CALLBACK_PARAM__ Conversion callback Mobile measurement partner ad tag
__CALLBACK_URL__ Conversion callback URL Mobile measurement partner ad tag
__IDFA__ iOS advertising identifier Mobile measurement partner ad tag
__GAID__ Android advertising identifier Mobile measurement partner ad tag
__IP__ IP address Mobile measurement partner ad tag
__UA__ User agent Mobile measurement partner ad tag
__SL__ System language Mobile measurement partner ad tag

TikTok's __TOKEN__ variables are for app-install measurement partners, not website links. For a website, TikTok's own URL parameter builder adds its tags (and appends utm_source=TikTok and utm_medium=Paid unless you change them), so Tag Docket adds nothing here.

Rules and pitfalls

The pack checks a link against these before it is minted.

  • Warns

    __CID__ is the AD id, not the campaign. Read as an abbreviation it looks like campaign id, and mapping it to utm_campaign produces a campaign dimension full of ad IDs — a valid URL, populated values, and a report wrong at the wrong level of granularity.

  • Warns

    __AID__ is the AD SET id, not the ad.

  • Warns

    URL Auto-attach is on by default and writes utm_source=TikTok and utm_medium=Paid, both capitalised. GA4 treats Paid and paid as different mediums, so auto-attach fragments channel reporting against anything composed in lowercase.

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 tiktok, the channel is paidsocial (Paid social) and the campaign is spring26_freeestimate_roofing.

Parameters for URL parameters:

utm_source=tiktok&utm_medium=paidsocial&utm_campaign=spring26_freeestimate_roofing

On a plain landing-page link, the same three values read:

https://example.com/free-estimate?utm_source=tiktok&utm_medium=paidsocial&utm_campaign=spring26_freeestimate_roofing

Where GA4 files it. Medium paidsocial lands in: Paid Social for social sites, Paid Other otherwise. See every medium and its GA4 channel.

How this pack is monitored

Documentation page monitored. The macro documentation page is fetched and its parameter table fingerprinted.

The pack is verified (last verified September 28, 2026). Version 2026.09.1, effective September 28, 2026. Source: ads.tiktok.com/help/article/how-to-add-url-parameters-to-your-website-url-in-tiktok-ads-manager.

Related

Questions

Where do I put UTM parameters in TikTok?
Tag Docket's TikTok pack puts them in URL parameters. TikTok's __TOKEN__ variables are for app-install measurement partners, not website links. For a website, TikTok's own URL parameter builder adds its tags (and appends utm_source=TikTok and utm_medium=Paid unless you change them), so Tag Docket adds nothing here.
Does TikTok have dynamic URL macros?
The pack lists 14 (__CAMPAIGN_ID__, __CAMPAIGN_NAME__, __AID__, __AID_NAME__, and more). The double underscores syntax is the platform's own, and Tag Docket passes it through unchanged.
Is the TikTok pack verified, and how is it monitored?
Verified on September 28, 2026. Documentation page monitored: The macro documentation page is fetched and its parameter table fingerprinted.

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.