Connect Meta Ads to clariBI
Sync Facebook and Instagram ad performance data into clariBI. Ask questions about spend, ROAS, audiences, and placements in plain English - no spreadsheets or manual exports required.
Powered by the Meta Graph API v25.0 with OAuth consent, long-lived token management, and 12 report types with daily breakdowns.
What is Meta Ads?
Meta Ads (formerly Facebook Ads) is the advertising platform for Facebook, Instagram, Messenger, and the Audience Network. It lets businesses run campaigns across Meta's properties to reach billions of users with precise targeting based on demographics, interests, and behaviours.
Advertisers use Meta Ads to drive awareness, traffic, leads, and conversions across multiple placements including News Feed, Stories, Reels, and the Audience Network. The platform generates enormous volumes of performance data - impressions, clicks, spend, reach, frequency, video views, and conversion events - spread across campaigns, ad sets, and individual ads.
clariBI connects via the Meta Graph API v25.0 using the ads_read OAuth scope. After authorization through Facebook's consent screen, clariBI exchanges the short-lived token for a long-lived token (valid for 60 days) and refreshes it automatically before expiry. It then syncs 12 report types with daily breakdowns covering account-level metrics, campaign/ad set/ad performance, demographic breakdowns, geographic data, placements, device performance, video metrics, and conversion details.
Instead of exporting CSVs from Ads Manager or building custom API scripts, any team member can ask clariBI a question like "What was our CPM for Instagram Stories last month?" and get an instant, chart-ready answer sourced directly from your ad account.
Learn more about Meta Ads at facebook.com/business/ads →How to connect Meta Ads to clariBI
The entire setup takes under two minutes. You will need a Facebook account with at least Analyst access to the ad account you want to connect.
Open Data Sources and click "Connect Meta Ads"
From your clariBI workspace, navigate to Data Sources in the left sidebar. Click + Add Data Source and select Meta Ads from the advertising integrations category.
Authorize your Meta account
You will be redirected to Facebook's OAuth consent screen. clariBI only requests ads_read access. It never creates, pauses, or modifies your campaigns. After you approve, clariBI exchanges the short-lived token for a long-lived token (60 days) and handles all future refreshes automatically.
Select your ad account
After authorization, clariBI lists all ad accounts accessible to your Facebook user. Pick the one you want to analyze and confirm the account ID (e.g. act_123456789).
Choose date range and reports
Select how far back to sync (last 7 days to all-time). By default, all 12 report types are synced. clariBI pulls data from the Meta Insights API and creates datasets for each report type with daily breakdowns.
Start asking questions in plain English
Your data is ready. Ask questions like "What was my CPM for Instagram Stories last month?", "Show spend by campaign for Q1", or "Which age group has the highest conversion rate?" and get instant, chart-ready answers.
Data clariBI syncs
12 report types with daily breakdowns from the Meta Graph API v25.0. All data syncs automatically after your initial connection.
-
Account Overview
Impressions, clicks, spend, reach, frequency, CPM, CPC, CTR, actions, and conversions at the account level.
-
Campaign Performance
Per-campaign metrics including spend, impressions, clicks, actions, and conversions with daily granularity.
-
Ad Set Performance
Targeting-level performance with all core metrics. See how each audience segment performs.
-
Ad Performance
Individual ad creative performance. Compare headlines, images, and copy variations side by side.
-
Age & Gender Demographics
Performance breakdown by age group and gender. Identify your highest-value audience segments.
-
Countries & Regions
Geographic performance by country and region/state. Find where your ads deliver the best results.
-
Placements
Performance by placement: Feed, Stories, Reels, and Audience Network. Optimize your creative mix.
-
Devices
Performance by device type and platform. Understand how mobile vs. desktop audiences respond.
-
Hourly Performance
Performance by hour of day. Find the optimal times to run your campaigns for maximum engagement.
-
Video Performance
Views, 25%/50%/75%/100% completion rates, and average watch time. Optimize your video ad creative.
-
Conversions by Action Type
Detailed breakdown of all conversion action types. See which events your campaigns are driving.
Connection details
Reference these parameters when configuring your Meta Ads connection in clariBI. All authentication is handled through Facebook's OAuth flow.
| Parameter | Value / Notes |
|---|---|
| API | Meta Graph API v25.0 (Insights endpoint) |
| Auth method | OAuth 2.0 via Facebook consent screen |
| OAuth scope | ads_read (read-only; clariBI never modifies your campaigns) |
| Token management | Short-lived token exchanged for long-lived token (60 days); auto-refreshed before expiry |
| Report types | 12 report types with daily breakdowns |
| Account identifier | Ad Account ID (e.g. act_123456789) |
| Required access | At least Analyst access to the ad account in Facebook Business Manager |
| Data freshness | Syncs on a configurable schedule; data typically available within minutes of the last sync |
Use cases
Meta Ads generates massive volumes of performance data. clariBI makes it instantly accessible to every team member without touching Ads Manager.
Campaign Optimization
Compare campaign performance side by side. Identify which campaigns deliver the best cost per conversion and reallocate budget to top performers. Ask "Which campaign had the lowest CPA this month?" and get an instant answer.
Audience Analysis
Break down performance by age, gender, and geography to find your highest-value audience segments. Use demographic insights to refine targeting and reduce wasted spend on underperforming audiences.
Placement Strategy
See which placements (Feed, Stories, Reels, Audience Network) deliver the best results and adjust your creative strategy accordingly. Compare CPM and CTR across placements in a single dashboard.
Video Performance
Track video completion rates (25%, 50%, 75%, 100%) and average watch time to optimize video ad creative. Identify which videos hold attention and which ones lose viewers early.
Cross-Channel Reporting
Combine Meta Ads with Google Ads and GA4 in a single dashboard to see the full paid media picture. Compare ROAS and CPA across channels without switching between platforms or merging spreadsheets.
Budget Allocation
Analyze spend efficiency across campaigns and ad sets to make data-driven budget decisions. Identify campaigns where additional spend would improve results and campaigns where spend is being wasted.
Security & requirements
Your ad data is valuable. Here is how clariBI protects your Meta Ads connection and what you need to get started.
Security measures
-
Read-only OAuth scope
clariBI requests only
ads_readaccess. It can never create, pause, modify, or delete your campaigns, ad sets, or ads. -
Encrypted token storage
OAuth tokens are encrypted at rest using Fernet symmetric encryption. The encryption key is managed separately from the data store.
-
Automatic token refresh
Long-lived tokens (60 days) are refreshed automatically before expiry. If a refresh fails, clariBI notifies you to re-authorize.
-
Revocable at any time
You can disconnect the integration from clariBI or revoke access from your Facebook Business Settings at any time. No data lock-in.
-
Audit logging
All sync operations and data access events are logged in clariBI's audit trail, visible to workspace administrators.
Prerequisites
-
Facebook account with ad account access
Your Facebook account must have at least Analyst access to the ad account you want to connect. Admin access is not required.
-
Active Meta ad account
The ad account must be active and in good standing. Disabled or restricted accounts cannot be connected.
-
No software installation required
Everything runs through Meta's OAuth flow and Graph API. No SDKs, browser extensions, or server-side software to install.
-
Works with Business Manager
Fully compatible with Facebook Business Manager. Connect any ad account your Facebook user has access to, including agency-managed accounts.
-
Historical data available
Sync data from the last 7 days up to 37 months (the maximum window supported by the Meta Insights API).
Pricing & availability
Meta Ads integration is included on all paid clariBI plans and the free 14-day trial. No extra fees, no per-sync charges.
Annual billing saves up to 17% • All plans include unlimited dashboards, reports, and data source connections within your plan's limits • See full pricing details
Connect Meta Ads in minutes
Start your free 14-day trial and have your first Meta Ads dashboard live today. No credit card required.
12 report types • Daily breakdowns • Auto-refreshing tokens • All paid plans from $99/month