Connecting Meta Ads gives Vortex IQ access to your Facebook and Instagram campaign data. Once connected, 65 KPI cards become available in Nerve Centre—covering campaign performance, budget monitoring, funnel conversion, keyword intelligence, and real-time anomaly alerts. Vortex Mind can cross-reference Meta Ads spend with Shopify or BigCommerce revenue to diagnose paid traffic waste.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.
What Vortex IQ reads from Meta Ads
| Category | Example cards |
|---|---|
| Executive Overview | Total Spend, Total Revenue, ROAS, CPA Trend, Impressions Trend |
| Budget Monitoring | Spend vs Budget, Budget Utilisation, Overspending Campaigns, Underspending Campaigns |
| Campaign Performance | ROAS by Campaign, Revenue by Campaign, Conversion Rate by Campaign, Campaign Comparison |
| Funnel & Conversion | Conversion Funnel, Conversion Lag, Clicks vs Conversions, Conversion Rate Trend |
| Alerts & Anomalies | Conversion Drop Alert, CPC Anomaly, CTR Decline Alert, Spend Anomaly, Zero-Conversion Spend |
| Geography | Conversions by Country, Spend by Country, CPA by Region |
| Device | Conversion Rate by Device, Spend by Device, ROAS by Device |
| Day & Time | Conversions by Hour, Spend by Hour, Conversions by Day of Week |
How to connect
Go to Connected Sources
In Vortex IQ, navigate to Settings → Connected Sources and click Add Source.
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.
Select ad accounts
Choose which Meta ad accounts to import. You can add more accounts later without re-authenticating.
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.