> ## Documentation Index
> Fetch the complete documentation index at: https://docs.innkeepr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Ads

> [card] Connection Info
>
> The TikTok Ads Connection is an **Advertising** and **Signals** connection.
>
> * **Advertising:** Innkeepr reads campaigns and spend data.
> * **Signals:** Innkeepr sends Signals to this platform.

[TikTok Ads](https://ads.tiktok.com) lets you reach people in the TikTok feed with video ads. Add TikTok Ads as a Connection to Innkeepr to send Audience Signals to TikTok and to measure which ad groups create incremental results.

## Getting Started

1. From your workspace's **Connections** page, click **Add connection**.
2. Choose **TikTok Ads**.
3. Click **Connect**, log in to TikTok for Business, and allow access for the Innkeepr app.
4. Select the ad accounts you want to sync.
5. Enter your **Ad ID parameter**. This is the URL parameter name you use to pass the ad ID in your ads (see below).
6. Select the **pixel** your campaigns optimize on.
7. Click **Save**.

## How Innkeepr sends Audience Signals

Innkeepr sends every user of an Audience Signal to your pixel through the TikTok Events API. Each Audience Signal has its own event, `innkeepr_targeting_<signal-id>`, for example `innkeepr_targeting_64f1a2b3c4d5e6f7a8b9c0d1`. You find these events in **TikTok Ads Manager** > **Tools** > **Events Manager** on the pixel you connected.

Innkeepr does not create the audience in TikTok. You create it once per Audience Signal:

1. In **TikTok Ads Manager**, go to **Assets** > **Audiences** and click **Create audience**.
2. Choose **Custom Audience** > **Website traffic**.
3. Select your pixel and the event of the Audience Signal.
4. Set the time range: **30 days** for Seed Signals, **180 days** for Exclusion and Retargeting Signals.
5. Save the audience.

TikTok needs 24–48 hours to populate the audience and at least 1,000 users before it can be used as a Lookalike source.

**Matching**

Innkeepr sends these identifiers with every event. TikTok needs at least one of email address, phone number, `ttclid`, or `_ttp` to match a user:

| Identifier | Source |
| :- | :- |
| Email address (hashed) | Shop integration, such as [Shopify](https://docs.innkeepr.ai/connections/sources/shopify.md), or [Identify](https://docs.innkeepr.ai/connections/spec-identify.md) |
| Phone number (hashed) | Shop integration or [Identify](https://docs.innkeepr.ai/connections/spec-identify.md) |
| User ID (hashed) | [Identify](https://docs.innkeepr.ai/connections/spec-identify.md) |
| TikTok Click ID (`ttclid`), if available | URL of the ad click |
| TikTok cookie (`_ttp`), if available | TikTok Pixel on your website |

The more users have an email address or phone number, the more of them TikTok can match.

## URL Parameter

Innkeepr reads your ad groups as Treatments. To match website visits to them, Innkeepr needs the TikTok ad ID as a URL parameter. You choose the parameter name yourself. Make sure it matches the **Ad ID parameter** in the connection settings.

**Parameters**

Add the following to the URL parameters of your ads, replacing `your_parameter` with the parameter name you configured in Innkeepr. TikTok macros must be written in capital letters:

`your_parameter=__CID__`

If you already use URL parameters, add the Innkeepr parameter at the end with `&`:

`&your_parameter=__CID__`

If you do not use URL parameters yet and want a complete setup including UTMs:

`utm_source=tiktok&utm_medium=paid&utm_campaign=__CAMPAIGN_NAME__&utm_term=__AID_NAME__&utm_content=__CID_NAME__&your_parameter=__CID__`

> [!NOTE]
>
> Upgraded **Smart+** campaigns pass the ad ID with `__ADID_V2__` instead of `__CID__`. Use the same parameter name in these campaigns: `your_parameter=__ADID_V2__`

**Implementation**

For a single ad:

1. In **TikTok Ads Manager**, open the ad and click **Edit**.
2. In the **Destination** section, click **Build URL parameters**.
3. Add the parameter and click **Apply**.
4. Click **Preview** to check that the URL contains the parameter, then publish your changes.

For many ads, use **Bulk Import & Export**:

1. In **TikTok Ads Manager**, go to the **Campaign** tab and select the campaigns, ad groups, or ads you want to edit.
2. Click **Bulk export/import** and export the ads into a spreadsheet.
3. Add the parameter to the destination URL of every ad. Do not change the Campaign ID, Ad Group ID, or Ad ID columns.
4. Import the spreadsheet again.

## Permissions

To connect TikTok Ads, the TikTok user who logs in needs these permissions:

**Ad account**

The user needs the **Admin** or **Operator** permission on the ad account. This is required to:

* Read campaigns, ad groups, and their spend
* Manage audiences

> [!WARNING]
>
> The **Analyst** permission is not sufficient. Analysts cannot manage audiences.

**Pixel**

The pixel must be linked to the ad account you connect. If the pixel belongs to a Business Center, share it there with the ad account. Innkeepr only sends events to the pixel and never changes it, so no permission to edit pixels is needed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.