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

# Meta Ads

> Connect Facebook and Instagram ads so Superscale can analyze performance, build campaigns, and publish with your approval.

## Connect Meta

Superscale connects through Meta's official OAuth as a reviewed, approved app: you authorize from Meta's own login, never share a password, and can revoke access anytime. Connecting is read-first, so analysis works the moment you connect, while publishing and budget changes need Meta's ads-management permission that you grant deliberately. Nothing spends or goes live without your approval.

<Steps>
  <Step title="Sign in" icon="plug">
    Choose Meta Ads in your workspace and sign in through Meta's own login.
  </Step>

  <Step title="Grant access" icon="shield-check">
    Pick the ad account, Pages, and Instagram accounts to use. Read-only is fine for analysis; add the ads-management permission when you want to publish.
  </Step>
</Steps>

<Tip>
  Missing an ad account, Page, or Instagram account? Check Business Manager access, the selected account's permissions, and Page access, then reconnect.
</Tip>

## At a glance

What you can do with a connected Meta account. Each supported capability links to how it works.

| Capability                                                       | Supported | Notes                                             |
| ---------------------------------------------------------------- | :-------: | ------------------------------------------------- |
| [Analyze performance and creative](#analyze-performance)         |     ✅     | Live, read-only                                   |
| [Build campaigns, ad sets, and ads](#build-campaigns)            |     ✅     | With your approval                                |
| [Add an ad set or ad to an existing campaign](#build-campaigns)  |     ✅     | With your approval                                |
| [Publish creative live on Meta](#publish-and-go-live)            |     ✅     | Needs ads-management permission; otherwise export |
| [Pause, resume, archive, or change budget](#manage-and-optimize) |     ✅     | With your approval                                |
| Custom audiences, lookalikes, interest targeting                 |     ❌     | Targeting stays broad by design                   |
| Automated rules (auto-pause or auto-scale)                       |     ❌     | On the roadmap                                    |
| Anything that spends or goes live without you                    |     ❌     | Always your call                                  |

## Analyze performance

Connect an account and Superscale reads it like an analyst. It pulls performance at the campaign, ad set, and ad level: spend, impressions, reach, clicks, CTR, CPC, CPM, ROAS, and conversions, over any date range you ask for, and compares creatives and audiences against each other. This is read-only, so it changes nothing while it learns. Numbers come back per campaign, ad set, or ad rather than broken down by placement or demographic.

*Try: "Audit my Meta account and flag the ads that are fatiguing."*

<div className="ss-shot">Product walkthrough: an account audit, from connect to action list</div>

## Read your creative

It goes past the numbers to the creative itself. For every running ad it reads the copy, headline, and call to action, and runs an AI visual analysis of each image and video, so it can tie a result back to the hook, format, and offer that drove it. It can also pull your ad account's image and video libraries, your Page posts, and your pixels.

*Try: "Find my top creative and tell me why it's working."*

<div className="ss-shot">Product walkthrough: creative analysis tying results to hooks and formats</div>

## Build campaigns

From approved creative, Superscale assembles a campaign in Meta's three levels: the campaign carries your objective, the ad set carries budget and targeting, and the ad carries the creative. It can start a campaign from scratch, or add a new ad set or a new ad to a campaign you already run, because each step accepts an existing parent. Each creation step gets its own approval card, and everything starts paused.

Objectives cover Awareness, Traffic, Engagement, Leads, and Sales. Targeting stays deliberately broad, country, age, and gender, which is how Meta's delivery performs best now: you test the angle in the creative and let the system find the audience. Budgets are daily and set on the ad set.

For the ad itself you have two shapes. Dynamic Creative packs up to five primary texts, five headlines, and five descriptions into a single ad and lets Meta rotate them to find the winner. Or you can run up to ten separate single-creative ads in one ad set, each with its own image or video. You can also skip new creative and promote an existing Page post.

*Try: "Add a new ad set to my Q4 campaign and put two of my best videos in it."*

<div className="ss-shot">Product walkthrough: building and launching a campaign from chat</div>

## Manage and optimize

Once ads are live, Superscale can pause, resume, or archive at any level, or flip a whole campaign on or off in a single approved action. It can change an ad set's daily budget and swap the creative on an individual ad. What it will not do is act on its own: automated rules that pause losers or scale winners without you are on the [roadmap](/roadmap), not running quietly in the background.

*Try: "Pause every ad with a frequency above 5 and raise budget on my top two ad sets."*

<div className="ss-shot">Product walkthrough: pausing, scaling, and swapping creative with approval</div>

## Publish and go live

Publishing live needs Meta's ads-management permission and access to the Page you're advertising from. With those granted, Superscale sets the campaign, ad set, and ad active through Meta's official API and your ads start delivering. Without them, you export the finished ads and upload them in Ads Manager, so a missing permission never blocks you. Either way, going live is an explicit step that waits for your approval.

*Try: "Publish the approved ads to my connected account."*

## Approval behavior

Meta write actions are approval-gated one step at a time. Approving a campaign, ad set, or ad creation card sends that entity to Meta immediately. If you decline a later step, Superscale does not automatically roll back earlier approved entities; they remain paused unless you approve a delivery change.

For full-campaign publish, pause, or archive, Superscale uses one explicit campaign delivery approval that covers the campaign, its ad sets, and its ads. Targeted edits such as one ad-set budget change or one creative replacement each get their own approval card.

## Capability reference

The granular view, capability by capability.

| Capability                                                                  | Function | Supported | Notes                           |
| --------------------------------------------------------------------------- | -------- | :-------: | ------------------------------- |
| Campaign, ad set, and ad insights (spend, CTR, CPC, CPM, ROAS, conversions) | Analyze  |     ✅     | Any date range                  |
| Compare creatives and audiences                                             | Analyze  |     ✅     |                                 |
| Demographic or placement breakdowns                                         | Analyze  |     ❌     | Aggregate per entity            |
| Read copy, headline, and CTA from live ads                                  | Creative |     ✅     |                                 |
| AI visual analysis of each image and video                                  | Creative |     ✅     |                                 |
| Image and video libraries, Page posts, pixels                               | Creative |     ✅     |                                 |
| Create campaign (Awareness, Traffic, Engagement, Leads, Sales)              | Build    |     ✅     | Approval-gated, starts paused   |
| App Promotion objective                                                     | Build    |     ❌     | Not supported yet               |
| Add an ad set to a new or existing campaign                                 | Build    |     ✅     | Approval-gated                  |
| Add ads to a new or existing ad set                                         | Build    |     ✅     | Up to 10 per ad set             |
| Dynamic Creative: up to 5 texts, headlines, descriptions                    | Build    |     ✅     | Meta rotates the variants       |
| Image or video creative                                                     | Build    |     ✅     | Video auto-uploaded to Meta     |
| Promote an existing Page post                                               | Build    |     ✅     |                                 |
| Targeting by country, age, and gender                                       | Build    |     ✅     | Broad by design                 |
| Custom audiences, lookalikes, interest targeting                            | Build    |     ❌     |                                 |
| Daily budget                                                                | Build    |     ✅     | Set on the ad set               |
| Lifetime budget or start/end scheduling                                     | Build    |     ❌     |                                 |
| Pause, resume, archive (any level or whole campaign)                        | Manage   |     ✅     | Approval-gated                  |
| Change ad-set daily budget                                                  | Manage   |     ✅     | Approval-gated                  |
| Swap an ad's creative                                                       | Manage   |     ✅     | Approval-gated                  |
| Automated rules (auto-pause or auto-scale)                                  | Manage   |     ❌     | Roadmap                         |
| Publish live through Meta's API                                             | Publish  |     ✅     | Needs ads-management permission |
| Export and upload manually                                                  | Publish  |     ✅     | Always available                |
| Launch without your approval                                                | Publish  |     ❌     | Never                           |

<Note>
  Use [Instagram](/integrations/instagram) for organic posts and Reels. Meta Ads covers paid Facebook and Instagram placements.
</Note>

<Card title="What every integration can do" href="/integrations/capabilities" horizontal>
  The cross-platform view of analysis, publishing, and what stays in your control.
</Card>
