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

# Connect Meta Ads

> Read ad performance — spend, leads, and cost per lead — straight into a report.

Connecting Meta Ads lets Rivvi read your campaign performance — spend, impressions, clicks, leads, cost per lead, and conversions — straight into a marketing report. Ask *"which campaigns produced leads last month"* or *"where is spend working"* without leaving the chat.

<Note>
  Meta Ads reads **aggregate metrics only** — no personal data leaves Meta.
</Note>

## What you'll need

A long-lived **System User access token** from your own Meta Business Manager, with the `ads_read` permission on your ad account:

* **System User access token**
* **Default ad account ID** — *(optional)* e.g. `act_123456789`, used when a request doesn't name one

<Card title="Meta: System User tokens" icon="arrow-up-right-from-square" href="https://developers.facebook.com/docs/marketing-api/system-users">
  Meta's guide to generating a System User token.
</Card>

## Connect it

<Steps>
  <Step title="Generate a System User token">
    In Meta **Business Settings → System Users → Add**, generate a token with the `ads_read` permission on your ad account.
  </Step>

  <Step title="Open Rivvi's connector settings">
    **Settings → Connectors**, select **Meta Ads**, click **Connect**.
  </Step>

  <Step title="Paste your credentials">
    | Field                        | What to paste                                                          |
    | ---------------------------- | ---------------------------------------------------------------------- |
    | **System User access token** | Your long-lived System User token                                      |
    | **Default ad account ID**    | *(Optional)* `act_123456789` — found in Ads Manager → Account Overview |
  </Step>
</Steps>

## What Rivvi can do with Meta Ads

* List the ad accounts your token can read.
* List campaigns in an ad account, with status and objective.
* Read aggregate performance — spend, impressions, clicks, leads, cost per lead, and conversions — by campaign, ad set, or ad over a date range.

## Try it

```text theme={null}
Which ad campaigns produced leads last month, and at what cost per lead?
Where is our ad spend working best right now?
```

## Next

<Card title="Google Workspace" icon="google" href="/connectors/google-workspace">
  Pair with GA4 for a fuller paid-media view.
</Card>