TikTok Ads — Connector Overview
The TikTok Ads connector lets you connect TikTok ad accounts to LightLead and pull statistics across campaigns, ad groups, and individual ads. Uses TikTok Ads API v2.
Capabilities
- Full statistics across all levels: campaign, ad group, ad
- Automatic OAuth token refresh
- Advertiser list retrieval from IDs
- Payload normalization via normalizeTikTokApiPayload
- Rate limit tracking via x-ratelimit-remaining header
Supported Entities
| Entity | Description |
|---|---|
| Advertiser | Ad account (advertiser_id, currency, status) |
| Campaign | AUCTION_CAMPAIGN level |
| Ad Group | AUCTION_ADGROUP; aliases adset_* ← adgroup_* |
| Ad | AUCTION_AD level |