# TikTok Ads

Integrating TikTok Ads with our platform takes a few clicks right from **Integrations** in your account.

{% hint style="warning" %}
You will need **Admin** or **Operator** permissions for the TikTok Business Center that owns the ad accounts.

**Pro Tip:** Ensure you are already logged into the correct TikTok Business account in your current browser tab before clicking "Connect" to avoid authorization errors.
{% endhint %}

<figure><img src="/files/Mov2ASI4uVzhr7iQifFx" alt=""><figcaption></figcaption></figure>

## Connect TikTok Ads

{% stepper %}
{% step %}
**Head over to Integrations**

Sign into [your Flip.to account](https://manage.flip.to/) and navigate to **Platform → Mission Control** or **Account Settings → Integrations**
{% endstep %}

{% step %}
**Click on TikTok Ads**

You'll find it in the **Marketing & Ads** section.
{% endstep %}

{% step %}
**Click Connect**

A TikTok authorization window will appear.

* **Login:** Ensure you log in with your TikTok For Business credentials (not your personal TikTok profile).
* **Authorize:** You will be asked to grant Flip.to permissions to access your ad performance data. Review the list and click **Confirm** or **Authorize**.

{% hint style="info" %}
Flip.to only requires "Read" access to your data to pull performance insights. We will never post to your TikTok account or edit your ads.
{% endhint %}
{% endstep %}

{% step %}
**Select your TikTok Ads accounts**

After you've authorized Flip.to, you'll be prompted to select one or more of the TikTok Ads accounts that you'd like to connect to our platform.

{% hint style="warning" %}
**Don't see your account?** If your ad account is missing from the list, it is usually because your TikTok user profile has "Member" access instead of "Admin/Operator" access. Verify your permissions in the TikTok Business Center.
{% endhint %}
{% endstep %}
{% endstepper %}

**Click Save** — one more thing to do.

## Add tracking parameters to your ads

{% stepper %}
{% step %}
**Head over to TikTok Ads**

Sign in to [your TikTok Ads Manager portal](https://ads.tiktok.com/business/en-US/solutions/ads-manager) and go to the **Campaign** tab. Drill down to the **Ad** level.

Below is the breakdown of how TikTok data is mapped to your analytics:

<table><thead><tr><th width="174.05078125">Parameter</th><th width="208.6796875">TikTok Macro</th><th>Purpose</th></tr></thead><tbody><tr><td><code>utm_campaign</code></td><td><code>__CAMPAIGN_NAME__</code></td><td>The human-readable name of your campaign (e.g., "Spring_Launch_2026").</td></tr><tr><td><code>utm_id</code></td><td><code>__CAMPAIGN_ID__</code></td><td>The unique Campaign ID for backend attribution.</td></tr><tr><td><code>utm_content</code></td><td><code>__CID_NAME__</code></td><td>The name of your ad creative (e.g., "User_Testimonial_V2").</td></tr><tr><td><code>tt_adgroup</code></td><td><code>__AID__</code></td><td>The Ad Group ID, used for grouping ads by targeting strategy.</td></tr><tr><td><code>tt_adid</code></td><td><code>__CID__</code></td><td>The unique Creative ID for granular ad-level tracking.</td></tr><tr><td><code>tt_adid_smart</code></td><td><code>__ADID_V2__</code></td><td>The Ad ID used in Smart+ campaigns (empty for standard campaigns).</td></tr><tr><td><code>tt_placement</code></td><td><code>__PLACEMENT__</code></td><td>Tracks if traffic came from TikTok Feed, Search, or Pangle.</td></tr></tbody></table>

{% hint style="info" %}
**Smart+ Campaigns:** The `tt_adid_smart` parameter captures the Ad-level ID unique to TikTok's upgraded Smart+ campaign structure. For standard campaigns, this parameter will be empty.
{% endhint %}
{% endstep %}

{% step %}
**Configure URL parameters**

**Step 1: Ad Level Configuration**

Tracking parameters must be applied at the **Ad Level** in TikTok Ads Manager.

1. Scroll to the bottom of the ad creation page to the **Destination page** section.
2. Locate the **URL** text box.
3. Delete all existing URL parameters.
   1. To do this, delete everything starting from and including the question mark (`?`) to the very end of the link.
   2. *Example:* If your URL is `https://overlookhotel.com?utm_source=tiktok&utm_medium=paid`, delete the `?utm_source=tiktok&utm_medium=paid` portion. Your URL should now look exactly like this: `https://overlookhotel.com`
4. Paste the exact string provided below directly onto the end of your clean destination URL

```
?utm_source=tiktok&utm_medium=paid&utm_campaign=__CAMPAIGN_NAME__&utm_id=__CAMPAIGN_ID__&utm_content=__CID_NAME__&tt_adgroup=__AID__&tt_adid=__CID__&tt_adid_smart=__ADID_V2__&tt_placement=__PLACEMENT__
```

{% hint style="warning" %}
Do not include a `?` at the beginning if you are using the dedicated "URL Parameters" box; TikTok appends it automatically.

**Case Sensitivity**: Macros must be in ALL CAPS. `__cid__` will fail; it must be `__CID__`.

**Double Underscores**: Ensure there are exactly two underscores before and after each macro name.
{% endhint %}

{% hint style="info" %}
**Existing ads:** To apply these parameters to ads that are already running, navigate to the **Ad** tab, click **Edit** on the ad, and paste the same string into the Tracking module. Note that editing a running ad will trigger TikTok's re-review process and restart the learning phase.
{% endhint %}

**Step 2: Disable Auto-UTMs**

TikTok offers a "URL Auto-attach" feature that automatically appends generic UTM values (e.g., `utm_source=tiktok`, `utm_medium=paid`). For Flip.to integrations, it is highly recommended to **toggle this OFF**.

{% hint style="info" %}
TikTok's documentation recommends enabling Auto-attach for general use. We recommend disabling it specifically because Flip.to's integration uses custom macro-based parameters that provide more granular tracking than the auto-generated defaults.
{% endhint %}

**Step 3: Verify the Macro**

After pasting your URL, click the **Preview** button in TikTok Ads Manager.

You should see the macro names (e.g., `__CID__`) in the URL.

{% hint style="info" %}
The preview will not show your real Ad ID yet; it will only show the placeholder to confirm the code is recognized.
{% endhint %}
{% endstep %}
{% endstepper %}

**And that's it.** Once connected and tracking parameters are in place, TikTok campaign performance data will begin flowing into Spacetime in the next 24-48 hours.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flip.to/docs/integrations/advertising/tiktok-ads.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.