What Vortex IQ reads from TikTok Ads
| Category | Example cards |
|---|---|
| Executive Overview | Total Spend, Total Revenue, ROAS, CPA Trend, Impressions Trend, Clicks vs Conversions |
| Budget Monitoring | Spend vs Budget, Budget Utilisation, Overspending Campaigns, Underspending Campaigns |
| Campaign Performance | ROAS by Campaign, Revenue by Campaign, Conversion Rate by Campaign, Top Performing Campaigns |
| Funnel & Conversion | Conversion Funnel, Conversion Lag, Conversion Rate Trend, Conversion Actions Breakdown |
| Alerts & Anomalies | Conversion Drop Alert, CPC Anomaly, CTR Decline Alert, Spend Anomaly, Zero-Conversion Spend |
| Geography | Conversions by Country, Spend by Country, Top Cities by Conversions |
| Device | Conversion Rate by Device, ROAS by Device, Spend by Device |
| Day & Time | Conversions by Hour, Spend by Hour, Conversions by Day of Week |
How to connect
Authorise via OAuth
Click Connect. A TikTok login pop-up opens. Log in with the account that has admin access to your TikTok Ads account, then grant the required permissions.
Select ad accounts
Choose which TikTok ad accounts to import. Multiple accounts can be added in one connection.
You need Admin access on the TikTok Ads account. Operator-level access may not expose all required API scopes.
Troubleshooting
No data after connecting
No data after connecting
TikTok Ads requires at least one active or recently active campaign to return data. If your account has no spend in the last 90 days, some cards may show empty states.
OAuth pop-up blocked
OAuth pop-up blocked
Allow pop-ups from
app.vortexiq.ai in your browser settings and retry the connection.Token expired
Token expired
TikTok OAuth tokens require periodic re-authorisation. Go to Settings → Connected Sources → TikTok Ads → Reconnect.