TikTok Ads

Setting up your Tiktok Ads URL tagging for attribution and reporting drill down

TikTok Ads UTM Tagging

Ruler supports TikTok Ads attribution through standard UTM parameters and TikTok's dynamic URL parameters.

For the best attribution accuracy and campaign reporting granularity within Ruler, we recommend adding the following parameters to your TikTok landing page URLs.

TikTok supports dynamic parameters that automatically populate campaign, ad group, and ad-level information when someone clicks an advert. These dynamic values are represented using double underscores (__) and are replaced by TikTok at click time.


Supported Parameters

ParameterRecommended Value
utm_sourcetiktok
utm_mediumcpc
utm_campaign__CAMPAIGN_NAME__
utm_termNot applicable
utm_content__CID_NAME__
campaign_id__CAMPAIGN_ID__
ad_group_id__AID__
ad_id__CID__
keyword_idNot applicable

Recommended URL Parameters

Copy the following URL parameters into your TikTok Ads tracking configuration:

utm_source=tiktok&utm_medium=cpc&utm_campaign=__CAMPAIGN_NAME__&utm_content=__CID_NAME__&campaign_id=__CAMPAIGN_ID__&ad_group_id=__AID__&ad_id=__CID__

Important

Ensure the dynamic parameters remain unchanged, including the double underscores (__). TikTok will replace these values automatically when an advert is clicked.


Configure URL Parameters in TikTok Ads Manager

To add your tracking parameters:

  1. Open TikTok Ads Manager.
  2. Navigate to your campaign.
  3. Select the relevant ad.
  4. Open the Tracking section.
  5. Add the URL parameters above to the URL Parameters field.
  6. Save and publish your changes.

TikTok applies these parameters when users click your ads, allowing Ruler to capture campaign, ad group, and ad-level information.


Testing Your Tracking

After publishing your changes:

  1. Click on a live TikTok ad.
  2. Confirm the landing page URL contains the expected parameters.
  3. Check that the dynamic values have populated correctly.

Important

Using unsupported parameter names or changing the dynamic parameter format may result in incorrect attribution or limit reporting drill-downs within Ruler.


Frequently Asked Questions

What if I already have UTM parameters?

If you already have TikTok UTM tracking configured, you do not need to replace your existing setup. Simply append Ruler's recommended ID parameters (campaign_id, ad_group_id, and ad_id) to your existing URL parameters.

This allows Ruler to provide more detailed campaign and ad-level reporting while keeping your existing tracking structure.


What happens if I don't update my UTM tagging?

Ruler may still identify TikTok traffic using existing UTMs, but without the recommended dynamic parameters your reporting will be limited.

You may see more "(not set)" values and have reduced visibility into campaign, ad group, and ad-level performance.


If you need assistance configuring TikTok tracking or reviewing your existing URL parameters, contact the Ruler support team at [email protected].