> For the complete documentation index, see [llms.txt](https://docs.smaq.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smaq.io/documentation/connections/tiktok-ads.md).

# TikTok Ads

### What SMAQ pulls

* Campaign, ad group, and ad-level performance
* Impressions, clicks, conversions, spend, CPM, CPC, CPA
* Video metrics: views, watch time, completion rate
* Creative-level performance with thumbnails

### What you'll need

* A TikTok for Business account with **at least Operator** access on the ad account.

### Steps to connect

1. **Data Source → Add data source**.
2. Pick **TikTok Ads**.
3. Authorize via TikTok OAuth.
4. Pick the advertiser account from the dropdown.
5. Name and click **Connect**.

> **\[Screen video needed]** TikTok OAuth + advertiser picker. \~45 seconds.

### Tips

* **Video performance is the differentiator.** Track average watch time and completion rate alongside CPM — TikTok rewards engagement.
* **TikTok's conversion windows differ from Meta.** Default is 7-day click + 1-day view.

### Troubleshooting

* **"No advertiser accounts"** — your TikTok login isn't associated with an ad account. Get added in TikTok Ads Manager.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.smaq.io/documentation/connections/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.