Meta Ads

Connect

1. Open Settings > Integrations, click Add Data Source and choose Meta Ads under Apps.
2. Enter a Data Source Name and click Connect to Meta Ads.
3. Sign in with Facebook in the window that opens and allow access. clariBI asks only for permission to read ads data (ads_read).
4. Choose the ad account and a date range: 30 days, 90 days, 6 months, 12 months, 2 years, or the maximum Meta allows (37 months).
5. Click Create Data Source. For more ad accounts, add one source per account.

What is synced

One row per day in each dataset:

• Account overview: spend, impressions, clicks, reach
• Campaigns, ad sets and ads
• Age and gender, country, region
• Placements (feed, stories, reels) and devices
• Conversions and cost per conversion by action type
• Video views and watch time per ad
• An hour-of-day table in the advertiser's time zone

Reach is not de-duplicated across age and gender buckets, so adding it up across them overstates it. Creative files (images and videos) are not imported.

Example questions

• "What was our cost per click by campaign last month?"
• "Show spend and conversions by country for the last 30 days."
• "Which placement had the lowest cost per conversion?"

Problems

• No ad accounts listed: the Facebook user you signed in with needs access to the ad account in Meta Business Manager.
• Authorization errors: clariBI renews Meta tokens on a schedule, but a revoked permission needs a new sign-in. Add the source again with the same account.
• Recent numbers change: Meta revises the last few days as attribution settles. Later syncs pick up the revised values.