> 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.
