What Vortex IQ reads from Meta Ads
Key Metrics cards (the most prominent KPIs shown at the top of your Nerve Centre dashboard) include: ROAS, Spend vs Budget, Total Spend, Total Revenue, Wasted Spend, and Zero-Conversion Spend.
How to connect
1
Go to Connected Sources
In Vortex IQ, navigate to Settings → Connected Sources and click Add Source.
2
Select Meta Ads
Search for “Meta Ads” or “Facebook Ads” and select it from the catalogue.
3
Authorise via OAuth
Click Connect. A Meta login pop-up opens. Log in with the Facebook account that has admin access to your ad account, then grant the requested permissions.
4
Select ad accounts
Choose which Meta ad accounts to import. You can add more accounts later without re-authenticating.
5
Save
Click Save. An initial data pull begins. Your Meta Ads KPI cards appear in Nerve Centre within a few minutes.
The Meta account you use to connect must have Admin or Advertiser access to the ad accounts you want to import. Analyst-level access does not grant the API permissions Vortex IQ requires.
Troubleshooting
OAuth pop-up blocked
OAuth pop-up blocked
Disable your browser’s pop-up blocker for
app.vortexiq.ai and try again.Ad accounts not appearing after connect
Ad accounts not appearing after connect
Only ad accounts where your Facebook user has Admin or Advertiser access are listed. Ask your Meta Business Manager admin to grant access, then reconnect.
Data stops refreshing
Data stops refreshing
Meta OAuth tokens expire after 60 days. Go to Settings → Connected Sources → Meta Ads → Reconnect to re-authorise.
ROAS looks wrong
ROAS looks wrong
Vortex IQ reads ROAS as reported by Meta (click-attributed). If your attribution window differs from Meta’s default, the ROAS card reflects Meta’s attribution-not your internal model.