# How to add UTM parameters to TikTok ads

> The UTM template for TikTok ads, where it goes in TikTok Ads Manager, and what every parameter records.

Source: https://mavendata.ai/docs/utm-convention/tiktok-ads

Paste the template into each ad’s URL parameters. TikTok fills in the campaign, ad group and ad on every click, so Maven can tie each visit to the ad behind it.

## The template

Paste this into the URL parameters of every TikTok ad. The parts in double underscores are TikTok’s dynamic parameters: TikTok replaces them with the real campaign, ad group and ad on every click.

```text
utm_source=tiktok&utm_medium=paid_social&utm_campaign=__CAMPAIGN_NAME__&utm_content=__AID_NAME__&utm_term=__CID_NAME__&utm_mc_id=cm-__CAMPAIGN_ID__-ag-__AID__-cr-__CID__-pl-__PLACEMENT__
```

## Where to paste it in TikTok Ads Manager

1. In **TikTok Ads Manager**, open the campaign, select the ad you want to update and choose **Edit**.
2. Find the website the ad links to, and the URL parameters for that link.
3. Paste the template into the URL parameters, replacing anything already there. If TikTok adds UTM parameters of its own, make sure they don’t replace Maven’s.
4. Save and publish the ad.

TikTok’s dynamic parameters start and end with two underscores. Keep them in capitals, exactly as they are in the template.

TikTok adds its own click ID (ttclid) to every click. Leave it there alongside the template.

## What each parameter records

| Parameter | Value in the template | What it records |
| --- | --- | --- |
| `utm_source` | `tiktok` | The platform the click came from. Always tiktok. |
| `utm_medium` | `paid_social` | The kind of ad: a paid ad on a social platform. |
| `utm_campaign` | `__CAMPAIGN_NAME__` | The campaign name, filled in by TikTok on each click. |
| `utm_content` | `__AID_NAME__` | The ad group name, filled in by TikTok on each click. |
| `utm_term` | `__CID_NAME__` | The ad name, filled in by TikTok on each click. |
| `utm_mc_id` | `cm-__CAMPAIGN_ID__-ag-__AID__-cr-__CID__-pl-__PLACEMENT__` | Maven’s tracking ID: the campaign, ad group and ad IDs, plus the placement, in one value, so a visit ties to the exact ad even after you rename it. |

## The parts of utm_mc_id

utm_mc_id carries the IDs Maven needs to tie a visit to the exact TikTok Ads ad, in one value, so it survives link shorteners and redirects. Each part starts with a short prefix.

| Prefix | TikTok Ads dynamic parameter | Meaning |
| --- | --- | --- |
| `cm-` | `__CAMPAIGN_ID__` | Campaign ID |
| `ag-` | `__AID__` | Ad group ID |
| `cr-` | `__CID__` | Ad ID (TikTok calls it the creative ID) |
| `pl-` | `__PLACEMENT__` | Placement: the app the ad showed in, such as TikTok or Pangle |

## Check it’s working

Click through from the ad to your site. The address should carry `utm_source=tiktok` and a `utm_mc_id` that starts `cm-` followed by the real IDs, not the parameter names in double underscores. Maven reads your ads each morning, and **Attribution settings** shows TikTok Ads as following the convention once TikTok reports the new parameters.

## If your ads use a different convention

Keep it. In Maven, open **Attribution settings** and add an exception for the parameter that differs, for example “On TikTok Ads, utm_medium is paid”. Maven then reads your ads the way you tag them. When Maven sees ads that don’t match the convention, it asks you there whether to keep them that way.

utm_mc_id is the one parameter every ad needs. Without it, Maven can’t tie a visit to the exact ad.

For the whole convention and the other platforms, see [Maven’s UTM convention](https://mavendata.ai/docs/utm-convention).
