> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect TikTok Ads to Vortex IQ

> Link TikTok Ads to Vortex IQ to track spend, ROAS, conversions, and creative performance across your TikTok campaigns alongside all your other ad platforms.

Connecting TikTok Ads brings your TikTok campaign metrics into Nerve Centre alongside every other ad platform in your stack. Vortex Mind can then cross-reference TikTok spend against your commerce platform revenue to identify paid traffic waste and conversion drop patterns-without you switching between dashboards.

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

<Steps>
  <Step title="Go to Connected Sources">
    Navigate to **Settings → Connected Sources** and click **Add Source**.
  </Step>

  <Step title="Select TikTok Ads">
    Search for "TikTok Ads" and select it from the catalogue.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Select ad accounts">
    Choose which TikTok ad accounts to import. Multiple accounts can be added in one connection.
  </Step>

  <Step title="Save">
    Click **Save**. Nerve Centre populates your TikTok Ads KPI cards once the initial data pull completes.
  </Step>
</Steps>

<Note>
  You need **Admin** access on the TikTok Ads account. Operator-level access may not expose all required API scopes.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="OAuth pop-up blocked">
    Allow pop-ups from `app.vortexiq.ai` in your browser settings and retry the connection.
  </Accordion>

  <Accordion title="Token expired">
    TikTok OAuth tokens require periodic re-authorisation. Go to **Settings → Connected Sources → TikTok Ads → Reconnect**.
  </Accordion>
</AccordionGroup>