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.
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
- 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 TikTok?
Does TikTok have dynamic URL macros?
Is the TikTok 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.