Meta Ads integration

Meta is the first ad platform. Read insights, campaigns, ads and creatives, and create drafts paused through a controlled, approved flow.

Request access All integrations

Meta Ads

ROASfinity

Read-only firstWrites only after a yes

Stock photos and example labels, not customers.

How the data moves

From Meta Ads to your report. Back only with a yes.

The top row is reading, which is all a new connection does. The bottom row is writing, switched on per account only after you grant the rights.

Meta AdsReads insights and metrics
🔑Token vaultRead-only token, encrypted on the server
One recordStored per client, with currency and time zone kept
▦Your reportSource, formula and sync time on every number
✎ProposalA change such as: create, update and pause, and media upload, where the permissions are granted
✓Preview and yesBefore and after, then a person with the right role approves
⎙Written onceAn idempotency key, so a retry cannot repeat the change
↻Read back, loggedMeta Ads is read again, compared and logged

Read: on by default, read-onlyWrite: off until you grant it, then every change needs approval

Meta Ads in daily use

What it reads first

Insights and metrics

What it can change, after a yes

Create, update and pause, and media upload, where the permissions are granted

Photos are stock images. App screens show test data.

In numbers

3things it reads

1things it can change, after approval

3things you need to connect

2limits stated

Meta Ads: reads, writes and limits

Insights and metrics
Campaigns, ad sets and ads
Creatives and their assets

Create, update and pause, and media upload, where the permissions are granted

Always after preview and approval.

A Meta developer app with business permissions and OAuth
App review and the right Marketing API access tier
Pages and Instagram access is separate and needs its own review

API versions change often and are maintained actively.
The Ad Library API does not provide competitor spend or ROAS.

Before you connect

Your ticks stay in this browser only.

Ask for access through the agency's own business account, with a role that can read reports. Do not ask for anyone's personal login.
Write down who can change budgets, audiences and pixel settings. Keep that list to the people who need it.
Write down the ad account time zone and currency. Check that they match the store and the other sources.
Write down which conversion event counts as a sale, and whether a report uses the platform count or the store count.
Pull one closed week of spend and purchases from the platform and from the store. Write the gap down before you change any campaign.

Common data differences

General practice, not a claim about any one account.

Difference

Attribution windows and view-based credit

Ad platforms credit a sale to a click or view inside a window they set. The store credits the last visit it saw, or nothing if the visitor came back later. Different windows and rules give different sales for the same days. Both can be right for their own rule.

Difference

Reporting time zone and day cut-off

The ad account has its own time zone. A purchase late at night can fall on one date in the store and the next date in the ad report. Compare both sources on the same date range and the same time zone.

Difference

Modelled and estimated conversions

Ad platforms may estimate conversions where measurement is limited, for example when visitors decline cookies. The totals then include estimates the store does not count. Note which figures are measured and which are estimated before you compare.

Modules that use Meta Ads

Each module page says what it reads and what it will not claim.

Reports

Client, channel, campaign and product reports where every figure shows its source, formula and update time.

Creative analytics

Results by creative ID, version, format, hook, offer and persona, joined to spend.

Ad launcher

Bulk matrices of product, variant, copy, format and audience uploaded paused, then read back.

AI insights

Checks for drops, anomalies, frequency and missing new creatives, explained with numbers you can verify.

Change log

Every change with before and after, author, reason, time, API response and what happened next.

Signals

Alerts for inactive accounts, rejected ads, CPM and CPA jumps, weak spend, broken URLs and stale connectors.

Questions about Meta Ads

Is the Meta Ads connection read-only?

It starts read-only. Changes are added only where the platform grants the permission, and each one is previewed, approved, sent once, read back and logged.

Where is the token stored?

In an encrypted vault on the server, never in the browser, in logs or in an AI prompt.

Is the Meta Ads connector available now?

Not yet. It goes live after the platform access is in place. Request access to be told when it does.