Status: available on every plan. Last checked against the app: 5 November 2026.
Meta Ads connects an ad account by signing in with Meta and approving read-only access to its reporting.
What this integration does
Coeff IQ reads these figures for one ad account, by day:
- Amount spent, clicks, click-through rate, CPM and cost per click
- Ad actions, and the cost per action
- Return on ad spend, when your ads track purchases
- Spend, clicks and ad actions for each campaign
Use it to see what your Facebook and Instagram ads cost and what they achieved.
Limitations:
- Ad actions are everything Meta counts, including clicks, reactions, comments, video views and purchases. They are not the same as purchases or leads.
- It cannot create, edit, pause or pay for campaigns.
- It does not read ad creative or targeting.
Before you connect
You need:
- A Meta ad account.
- A Facebook account with access to that ad account, at least enough to view its performance. A Business Portfolio admin can assign this; see Meta's guide to adding people and assigning assets.
- In Coeff IQ: the workspace owner, a workspace admin, the client's client admin or its client login role, with a confirmed email address. Any plan works, within your integration limit.
Connect
- Open the client, then Integrations, and select Connect an integration.
- Choose Meta Ads under Provider.
- Select Connect with Meta.
- Sign in to Facebook and approve read-only access to your ad accounts.
- Back in Coeff IQ, choose the ad account under Which one should Coeff IQ sync? and select Save selection. If there is only one, it is selected for you.
Expected result: Meta Ads is listed as CONNECTED with "Syncing:" and the ad account name.
A successful connection says nothing about ad activity. It means Coeff IQ can read the account. If no ads ran in the period you are viewing, there is nothing to show, and that is not an error.
First sync and viewing results
- Select Sync now at the top of the client page. The first sync is always allowed.
- Wait for the result. You can leave the page.
- If you see "Older history still to fetch — sync again to continue", select Sync now again for the next stage.
History: up to about 13 months on a paid plan and 14 days on the free trial, in stages of about three months.
Where to see it: open Meta Ads in the client navigation. Ad spend also appears on the Overview and Executive Dashboard.
Delays: Meta can revise recent figures, especially ad actions and return on ad spend, for several days. Coeff IQ reads the last week again on later syncs, so the latest numbers may change slightly.
Currency: amounts are in your ad account's currency, but the page always shows them with a $ sign. For an account in euros, for example, "$100" means €100. Coeff IQ does not convert currencies.
Time zone: Meta reports days in the ad account's own time zone, and Coeff IQ keeps each figure on the day Meta reported it.
What you might see:
| You see | Meaning |
|---|---|
| No Meta Ads data yet | Nothing is stored. Connect the account, or run a sync. |
| No ad spend in this period | The connection works, but no money was spent between those dates. Campaigns may be paused, finished or not started. Check Ads Manager, or choose a longer period. |
| No spend in this period (on a campaign) | That campaign spent nothing in the period. |
| No campaigns ran in this period. | No campaign has figures for those dates. |
See also Understand your metrics.
Troubleshooting
- No ad accounts are listed. The Facebook account you used has no access to an ad account. Ask the ad account's admin to add you, then select Reauthorize.
- You signed in with the wrong Facebook account. Select Reauthorize and sign in with the right one. If that account cannot see the selected ad account, the selection is cleared and you choose again.
- The wrong ad account is connected. Select Change resource and choose another. If data is stored, Coeff IQ warns you first that switching clears it.
- "Sign-in expired — reconnect to continue". Select Reauthorize. Stored history is kept. Meta sign-ins last about 60 days and are renewed when you sync, so a connection left unsynced for that long will need this.
- Connected, but no data. Select Sync now if you have not yet. Then compare the period with your campaign dates in Ads Manager.
- The figures differ from Ads Manager. Check that the dates match. Meta's attribution settings and later revisions can also change recent figures.
- The sync failed or stopped part-way. Check Last attempt on the Integrations page, then see Fix integration errors.
Disconnect
- Open the client, then Integrations.
- Select Disconnect on the connection. It takes effect straight away, without a confirmation step.
What happens: syncing stops and Coeff IQ deletes the stored sign-in for this connection. Data already synced is kept. Coeff IQ does not contact Meta, so your Facebook Page connection is not affected.
To remove access at Meta as well: remove Coeff IQ in Facebook's Settings & privacy, under Business integrations. Meta Ads and your Facebook Page connection share one Meta approval, so this stops both.
