URL parameters
Add UTM parameters to your TikTok ads so Tapper Block ties every captured click to the right campaign.
Tapper Block recognizes a TikTok ad click by the ttclid that TikTok adds to your landing page. TikTok passes no ad ID that Tapper can read from the click, so Tapper ties the click to your campaign through its UTM parameters. Add one UTM parameter to each ad once, and attribution works from then on.
Recommended parameter
| Parameter | Value | What it gives Tapper |
|---|---|---|
utm_campaign | __CAMPAIGN_ID__ | The campaign ID, which Tapper matches to the campaign the click came from. |
The value is a TikTok macro: TikTok replaces it with the real campaign ID when the ad is clicked.
If you already use utm_campaign for your own campaign names, keep it, and put __CAMPAIGN_ID__ in utm_term instead.
How Tapper reads the parameters
Tapper looks at utm_campaign, utm_source, utm_content and utm_term, in that order, and uses the first value it can match:
- A campaign ID gives Tapper the campaign.
- An ad ID, such as the value of
__CID__, gives Tapper the ad, its ad group and its campaign. - An ad group ID gives Tapper the ad group and its campaign.
- A campaign name also matches, but IDs are more reliable. A name that two of your campaigns share, or one that looks like a generic value such as
tiktok, is never matched.
When a click carries the ID of a campaign that Tapper has not read from your account, such as one you just launched, Tapper reads your TikTok campaigns again, at most once every 45 minutes, and tries the click once more.
Add the parameter
Open the ad
In TikTok Ads Manager, open the ad you want to set up and click Edit.
Find the URL parameters
Scroll to the Tracking section of the ad and find URL parameters, or Build URL parameter.
Add the parameter
Set utm_campaign to __CAMPAIGN_ID__. Keep any UTM parameters you already use for other fields.
Repeat for other ads
Apply the same parameter to every ad you want Tapper to attribute.
Review and publish
- Check that your destination URL now carries
utm_campaign=__CAMPAIGN_ID__. - Publish the changes. TikTok may send the edited ads for review again.