Skip to main content
Ocular connects to Facebook Ads using OAuth — the easiest option. Token refresh is fully managed by Ocular; you sign in once and pick the ad accounts to sync.

What you need

Admin access to a Meta Business Manager with one or more ad accounts.

What it unlocks

Marketing report, Ad & Campaign Performance, Creative Deep Dive, blended ROAS.
Set up ad tracking first. UTM parameters and fbclid tracking must be configured at the Ad level in Meta Ads Manager before you turn on the connector — retroactive tagging doesn’t work. Walk through the Ad Tracking Setup Guide before continuing here.

​
Connect via OAuth

Start the OAuth flow

In Ocular, go to Data Management → Connectors → Add Connector → Facebook Ads, then select Connect with Facebook (OAuth).
Image 20260406 093008

Log in and grant permissions

You’ll be redirected to Facebook’s login page. Sign in and select your Business Manager and Admin ad account(s). Approve the displayed list of permissions requested automatically by Ocular.

Auto-configuration

Ocular automatically fetches all ad accounts linked to the selected Business Manager. Choose the account(s) you want to sync. Tokens are managed by Ocular — no manual refresh needed.

Save and sync

You will be redirected to the connector page where you can see the YOUR META ACCOUNT IS CONNECTED message. Select the account(s) you want to sync and click Create Connector. Data ingestion begins automatically.

​
Troubleshooting

Confirm the Facebook account you’re signing in with has Admin access to the Business Manager — view-only or analyst roles can’t authorise the scopes Ocular needs.
The account must be inside the Business Manager you selected. If it’s a personal ad account or owned by a different BM, move or share it into the right BM, then retry the OAuth.
Creative-level breakdowns require that your ads are set up with consistent UTM parameters and the asset IDs are populated. If fbclid and the Ocular custom UTM parameters weren’t configured before the campaign launched, retroactive ingestion won’t fill them — fix the tagging and Ocular will pick up new ads from that point forward.
For ticket-writing format when filing a connector issue, see Working with the Ocular team → Connector-not-working tickets.