# TikTok Ads

> Connect TikTok Ads so your AI can report on TikTok ad spend, video views, clicks, conversions and ROAS next to your other ad platforms. Read-only.

Connect TikTok Ads and your AI can report on every TikTok ad account you share with Plugsight, in the same conversation as Google Ads, Microsoft Advertising and Meta Ads. Plugsight only reads: it never changes campaigns, ad groups, ads, budgets or audiences.


> [!IMPORTANT]
> TikTok Ads is coming soon. TikTok is still reviewing Plugsight's access to its API for Business. Until TikTok approves it, only Plugsight admins can connect TikTok Ads, and it doesn't appear in your **Connector catalog**. If you already have a TikTok Ads connection, you can still reconnect it.


## What your AI can do

- Report on ad accounts, campaigns, ad groups and ads, for any date range, per day or per month.
- Show spend, impressions, reach, frequency, clicks, CTR, CPC and CPM.
- Show conversions, cost per conversion, results, website purchases, purchase value and ROAS.
- Show video views, 2-second and 6-second views, how far people watched (25%, 50%, 75% and 100%), likes, comments, shares, follows and profile visits.
- Break results down by age, gender, country and device platform.
- Show campaign settings: status, objective and budget.
- Include TikTok Ads in the account overview and period comparison deep dives.

See [How your AI analyses marketing data](https://docs.plugsight.app/connectors/marketing-data.md) for how these tools work.

### Example questions

- "How much did we spend on TikTok last month, and what was the ROAS by campaign?"
- "Which TikTok ads have the best video completion rate this month?"
- "Which age groups are cheapest per conversion on TikTok?"
- "Compare TikTok, Meta and Google Ads spend and conversions for the last 30 days."

## What you need

- A **Pro** or **Agency** plan. See [Plans](https://docs.plugsight.app/get-started/plans.md).
- A TikTok for Business login that can open your ad accounts in TikTok Ads Manager.

## Connect TikTok Ads

1. Open **Connections** and click **Add connection**.
2. Choose **TikTok Ads**.
3. Log in to TikTok for Business with the login that can open your ad accounts, if you aren't logged in already.
4. TikTok shows that Plugsight wants access to your ad accounts. Choose the ad accounts your AI may read, then confirm.
5. You're back on **Connections**, with a message such as "Connected Acme Shop and 1 more: 2 TikTok ad accounts."

Then add the connection to an MCP server (or use a server set to **All accounts**). If this is your first marketing connection, [refresh the tools list](https://docs.plugsight.app/ai-apps/refresh-tools.md) in your AI app and start a new chat.

To choose which ad accounts your AI can see, click **Show sites & accounts** next to the connection. See [Choose which sites and accounts your AI can see](https://docs.plugsight.app/connectors/hide-sites-and-accounts.md). To add an ad account you didn't share the first time, connect TikTok Ads again and choose it too: the existing connection is updated.

## What it can and can't change

TikTok Ads is **read-only** in Plugsight. Plugsight only ever reads reports, ad accounts and campaign settings from TikTok, so your AI can't pause campaigns, change budgets or bids, or edit ads and audiences.

## Limits

- Conversions are TikTok's own conversions column: the event each ad group is set to optimise for. Conversion value and ROAS use website purchase value. To see other results, ask for purchases or results instead.
- TikTok reports at most 30 days at a time. Plugsight reads longer periods in 30-day parts and adds them up.
- Reach counts each person once, so it can't be added up across days, 30-day parts or ad accounts. Ask for reach per day, or over 30 days or less, without a monthly split, for one ad account at a time.
- When TikTok doesn't report a figure, it shows as empty, not as zero.
- Rates and averages TikTok calculates, such as its own CTR or cost per conversion asked for by name, show as empty wherever rows are combined (across 30-day parts, months or ad accounts). Plugsight's own CTR, CPC, CPM, cost per conversion and ROAS are worked out from the totals, so they are given whenever the figures behind them are known. If TikTok doesn't report one of those figures, the result is empty, not zero.
- If TikTok is busy or briefly down when Plugsight renews a sign-in, your AI is told to try again in a few minutes. You only need to reconnect if TikTok refuses the sign-in.
- TikTok Ads reads at most 10,000 rows per ad account for each question. When an answer says it's partial, ask about a shorter period, fewer breakdowns or fewer ad accounts.
- Accounts in different currencies are added as-is, and your AI is told so. Ask it to split results by account.

## Set up TikTok's developer app (server administrators)

This is only needed if you run your own Plugsight server and see "TikTok Ads isn't set up on this server yet." TikTok needs a developer app before anyone can connect. Follow TikTok's own guides, linked below:

1. Register as a developer on TikTok API for Business with your TikTok for Business account. See [TikTok's developer registration guide](https://business-api.tiktok.com/portal/docs?id=1738855099573250).
2. Create a developer app for Plugsight. As the advertiser redirect URL, enter your server's address followed by `/auth/tiktok/callback`, for example `https://app.plugsight.app/auth/tiktok/callback`. See [TikTok's guide to creating a developer app](https://business-api.tiktok.com/portal/docs?id=1738855242728450).
3. Give the app read-only permissions only: reading ad account details and reporting. Plugsight never needs permission to manage ads.
4. Submit the app and wait for TikTok to approve it.
5. Copy the app's ID and secret into the server's `TIKTOK_APP_ID` and `TIKTOK_APP_SECRET` settings and restart it. TikTok Ads then appears under **Add connection**.

TikTok's [authentication guide](https://business-api.tiktok.com/portal/docs?id=1738373164380162) explains how advertisers authorise an app.

## Troubleshooting

### Marketing and analytics connectors (…) are on the Pro plan. Upgrade under Billing to connect them.

**What it means:** Your plan doesn't include marketing connectors.

**How to fix it:** Upgrade to Pro or Agency on **Billing**, then connect again.

### TikTok Ads is coming soon.

**What it means:** TikTok hasn't approved Plugsight's access to its API for Business yet, so TikTok Ads isn't open to everyone.

**How to fix it:** Nothing to do for now. This article and [What's new](https://docs.plugsight.app/whats-new.md) say when it's available.


### TikTok Ads isn't set up on this server yet.

**What it means:** This Plugsight server has no TikTok developer app set up.

**How to fix it:** Contact info@plugsight.app. If you run your own server, see [Set up TikTok's developer app](#set-up-tiktoks-developer-app-server-administrators).

### The TikTok sign-in didn't finish. Click Connect and sign in again.

**What it means:** TikTok didn't confirm the sign-in, for example because it took too long or you cancelled on TikTok's screen. The message may end with what TikTok said.

**How to fix it:** Connect again and confirm on TikTok's screen.

### No TikTok ad account was shared with Plugsight. Click Connect again and choose at least one ad account.

**What it means:** You confirmed on TikTok's screen without choosing an ad account.

**How to fix it:** Connect again and choose the ad accounts your AI may read.

### This login doesn't reach anything yet.

**What it means:** The ad accounts you shared have since been removed from your TikTok for Business login, or you no longer have access to them.

**How to fix it:** Ask the ad account's admin to give your login access in TikTok Ads Manager, then connect TikTok Ads again.

### TikTok no longer accepts this TikTok Ads sign-in: access was removed or the authorisation was revoked. Reconnect TikTok Ads on the Connections page.

**What it means:** TikTok stopped accepting the sign-in, for example because Plugsight's access was removed from the ad account.

**How to fix it:** On **Connections**, connect TikTok Ads again. Your hidden ad accounts and MCP servers stay as they were.

### This TikTok Ads sign-in expired on …, and TikTok can't renew it. Reconnect TikTok Ads on the Connections page.

**What it means:** TikTok gave this sign-in an end date, and it has passed.

**How to fix it:** On **Connections**, connect TikTok Ads again.

### TikTok is limiting requests right now. Wait a few minutes before asking again, and ask for fewer accounts or a shorter date range.

**What it means:** TikTok allows only so many requests in a short time. Plugsight already waited and tried again a few times.

**How to fix it:** Wait a few minutes, then ask again, ideally about fewer ad accounts or a shorter period.

### TikTok can't return that much data at once. Ask for a shorter date range, fewer fields or fewer accounts.

**What it means:** The question asked TikTok for more data than it returns in one go.

**How to fix it:** Ask about a shorter period, fewer breakdowns or fewer ad accounts.

## Related articles

- [How your AI analyses marketing data](https://docs.plugsight.app/connectors/marketing-data.md)
- [Choose which sites and accounts your AI can see](https://docs.plugsight.app/connectors/hide-sites-and-accounts.md)
- [Meta Ads](https://docs.plugsight.app/connectors/meta-ads.md)
- [Google Ads](https://docs.plugsight.app/connectors/google-ads.md)
- [Reconnect a connection](https://docs.plugsight.app/troubleshooting/reconnect-needed.md)

---

Web version: https://docs.plugsight.app/connectors/tiktok-ads
