> ## 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 Meta Ads (Facebook) to Vortex IQ

> Connect Meta Ads to Vortex IQ to monitor 65 KPI cards covering spend, ROAS, conversions, and performance across your Facebook and Instagram campaigns.

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.

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

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

<Steps>
  <Step title="Go to Connected Sources">
    In Vortex IQ, navigate to **Settings → Connected Sources** and click **Add Source**.
  </Step>

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

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

  <Step title="Select ad accounts">
    Choose which Meta ad accounts to import. You can add more accounts later without re-authenticating.
  </Step>

  <Step title="Save">
    Click **Save**. An initial data pull begins. Your Meta Ads KPI cards appear in Nerve Centre within a few minutes.
  </Step>
</Steps>

<Note>
  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.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth pop-up blocked">
    Disable your browser's pop-up blocker for `app.vortexiq.ai` and try again.
  </Accordion>

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

  <Accordion title="Data stops refreshing">
    Meta OAuth tokens expire after 60 days. Go to **Settings → Connected Sources → Meta Ads → Reconnect** to re-authorise.
  </Accordion>

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