Meta Ads × Metabase

How to build Meta Ads dashboards in Metabase

Meta Ads is Meta's advertising platform for Facebook and Instagram campaigns, from awareness to conversion objectives. Metabase is where you turn that marketing data into shared, trustworthy dashboards. This guide covers two complementary paths: a lightweight MCP + CLI route that pulls live data with the Meta Ads MCP server and loads a CSV into Metabase with the Metabase CLI, and a durable pipeline route that syncs Meta Ads daily stats into a database so you can build dashboards anyone can read.

Heads up: Metabase connects to databases and warehouses — it does not ship a native Meta Ads connector, and a BI warehouse is the wrong home for raw click or event streams. Sync daily aggregates, entities, and stats — campaigns, channels, rollups, subscribers — and leave the raw firehose in Meta Ads.

How do you connect Meta Ads to Metabase?

Most teams combine both routes: use MCP and CLI uploads for a fast first pass, then move recurring marketing reporting to a warehouse-backed model.

1 · MCP + CLI route (AI-assisted)

Live data in, quick analysis out

Pair the Meta Ads MCP server with the Metabase CLI. Use MCP for live lookups, write a scoped result to CSV, then load it into Metabase as a ready-to-query table and model.

Best for
  • Quick lookups such as "show me spend and conversions by campaign objective"
  • Loading a Meta Ads export into Metabase in seconds
  • Spot-checks and one-off analyses without a warehouse
Trade-offs
  • Great for exploration, not governed recurring reporting
  • Use read-only/scoped credentials wherever the MCP server supports them
  • CSV uploads are snapshots — refresh or move to the pipeline for history
2 · Pipeline route (warehouse-backed)

Durable dashboards with history

Sync Meta Ads daily stats and entities into a database or warehouse with a connector, custom pipeline, or API, then point Metabase at it.

Best for
  • Meta Ads reporting that marketing leaders depend on
  • Joining Meta Ads data with CRM, revenue, or product data
  • Long-run trends for spend and conversions by campaign objective and roas by campaign and ad set
Trade-offs
  • You own the refresh schedule and the rollup grain
  • Sync daily aggregates and entities — not raw event streams
  • Metric definitions must be consistent across channels and teams

What can you analyze from Meta Ads data in Metabase?

  • Spend and conversions by campaign objective — built from ad set daily insights and the related campaigns, ad sets, ads data your sync exposes.
  • ROAS by campaign and ad set — built from ad set daily insights and the related campaigns, ad sets, ads data your sync exposes.
  • Creative fatigue: frequency vs. CTR — built from ad set daily insights and the related campaigns, ad sets, ads data your sync exposes.
  • Audience performance comparison — built from ad set daily insights and the related campaigns, ad sets, ads data your sync exposes.
  • Cost per result by placement — built from ad set daily insights and the related campaigns, ad sets, ads data your sync exposes.

Which Meta Ads dashboards should you build in Metabase?

For: Performance marketers

Campaign performance

Where spend goes and what it returns.

  • Spend by campaign by week (stacked bar)
  • Conversions and conversion value (combo)
  • ROAS by campaign (bar)
  • Cost per conversion trend (line)
For: Marketing leads

Budget pacing

Whether the month's budget lands where it was planned.

  • Month-to-date spend vs. budget (progress)
  • Daily spend run rate (line)
  • Projected end-of-month spend (number)
  • Pacing by campaign (table)
For: Channel owners

Efficiency signals

The health metrics behind the headline spend.

  • CTR by campaign and ad group (table)
  • CPC and CPM trends (line)
  • Impression share or frequency (line)
  • Wasted spend: high-cost, zero-conversion segments (table)
For: Leadership

Acquisition economics

How paid spend converts into customers and revenue.

  • CAC by channel by month (bar)
  • New customers attributed per channel (bar)
  • Blended vs. channel ROAS (combo)
  • Spend share vs. revenue share by channel (table)

How do you use the Meta Ads MCP server with the Metabase CLI?

Pair the Meta Ads MCP server with the Metabase CLI for fast, hands-on analysis. MCP is useful for scoped lookups and summarized exports; the Metabase CLI's upload command loads CSV data into Metabase and creates a ready-to-query table and model.

Example workflow

  • Ask the MCP server for last month's ad set daily insights with spend, clicks, and conversions by campaign.
  • Export the result as CSV, keeping stable IDs, channels, campaigns, and dates.
  • Run mb upload csv to load it into Metabase as a table and model, then build questions and dashboards on top.

Be honest about the limits

  • MCP lookups are excellent for exploration, not scheduled reporting.
  • A CSV upload is a snapshot; refresh it with mb upload replace or move to the pipeline for real history.
  • Daily stat rows per campaign are required for pacing and trend cards — a one-off export only supports snapshots.
  • mb upload csv needs an uploads database configured under Admin → Settings → Uploads.

How do you set up Meta Ads MCP and the Metabase CLI?

Meta Ads MCP serverofficial

Transport
Hosted remote MCP via Streamable HTTP
Auth
OAuth through your Meta Business account
Best for
Live scoped lookup and export

Metabase CLIofficial

Install
npm install -g @metabase/cli
Auth
mb auth login
Load data
mb upload csv --file data.csv
Requires
An uploads database (Admin → Settings → Uploads)
MCPExample MCP client config
{
  "mcpServers": {
    "meta-ads": {
      "url": "https://mcp.facebook.com/ads"
    }
  }
}

Meta's hosted server (open beta since April 2026) needs no developer app or App Review — unlike the raw Marketing API. It includes write tools that can edit campaigns, so connect an account with the least privilege that answers your questions.

TerminalLoad a Meta Ads CSV with the Metabase CLI
# Install the Metabase CLI
npm install -g @metabase/cli

# Log in (opens your browser; requires Metabase v62+)
mb auth login --url https://your-metabase.example.com

# Load a ad-set-daily-insights export — creates a table AND a model
mb upload csv --file meta-ads-ad-set-daily-insights.csv --collection root

# Refresh that same table later from a new export
mb upload replace <table-id> --file meta-ads-ad-set-daily-insights.csv

Can you generate a Meta Ads dashboard with AI?

Yes. Use the prompt below with any assistant that can run the Meta Ads MCP server and the Metabase CLI. It works end to end: if Meta Ads tables already exist in Metabase it analyzes those; otherwise it pulls scoped, summarized data over MCP, loads it with mb upload csv, then builds the dashboard and caveats any metric that needs missing history.

Prompt for creating a Meta Ads Advertising Overview dashboard
Create a polished Metabase dashboard for Meta Ads advertising analytics.
Work end to end: get the data into Metabase if it isn't there yet, then build.

Goal: Help marketing and growth leaders understand spend, ROAS, CTR, CPC, budget pacing, and acquisition cost by campaign and channel from Meta Ads data.

Step 1 — Find or load the data:
- First, check what already exists in Metabase (search for meta-ads tables and
  models). If durable Meta Ads data is already present — synced from a warehouse
  or uploaded earlier — use it and skip to Step 2.
- If nothing is there, pull a scoped, summarized export with the Meta Ads MCP server:
  ad set daily insights, plus campaigns, ad sets, ads.
  Prefer daily aggregates over raw events. Write each result to a CSV,
  then load it with the Metabase CLI — run "mb upload csv --file <export>.csv" so
  each upload creates a table and a ready-to-query model. Use "mb upload replace
  <table-id> --file <export>.csv" to refresh an existing table instead of creating
  duplicates.

Step 2 — Inspect before querying:
Do not assume exact table or column names. Inspect available fields, channels,
campaigns, dates, and whether daily history exists before creating trend or
pacing cards.

Important:
- Build on whatever data is present; don't claim Metabase connects natively to
  Meta Ads — it reads a database or CLI-uploaded tables.
- Never try to load raw event or click streams into Metabase; use daily
  aggregates, campaign-grain stats, and entity tables.
- Only compute rates (CTR, conversion rate, ROAS, CAC) when both numerator and
  denominator exist — and state the attribution model when reporting conversions.
- Exclude test campaigns and internal traffic from headline cards, and keep
  currency consistent when spend spans accounts.
- A single CSV is a point-in-time snapshot: only build trend cards if there is a
  usable date column or multiple periods have been uploaded.

Dashboard title: Meta Ads Advertising Overview

Sections:
1. Executive summary: Spend this month; Conversions; ROAS; CAC; Budget pacing
   vs. plan.
2. Campaigns: Spend, clicks, conversions, and ROAS by campaign by week.
3. Efficiency: CTR, CPC, and cost-per-conversion trends; wasted-spend table.
4. Pacing: Month-to-date spend vs. budget; projected end-of-month spend.
5. Acquisition: CAC and new customers by channel, joined to revenue where synced.

Filters: Date range, Channel, Campaign, Country, Device, Segment.

Output: Build the dashboard if you have permission; otherwise provide the exact
questions, SQL, model definitions, and layout. Include caveats for any metric
that cannot be calculated from the available data.

How do you sync Meta Ads data into a database or warehouse?

For dashboards that need history and reliability, land Meta Ads daily stats and entities in a database first, then connect Metabase to that database.

Connector options

  • Managed ETL — use a connector when one covers the objects you need.
  • Custom pipeline — use the Meta Marketing API (Insights) for control over grain, fields, and refresh cadence.
  • MCP + CSV — use this for quick exploration and one-off slices.

Sync ad accounts, campaigns, ad sets, and daily insights with the dlt facebook_ads verified source, the Airbyte Facebook Marketing source, or Fivetran's Facebook Ads connector — production API access requires App Review, and attribution-window settings change conversion numbers.

Notes

  • Decide the rollup grain first (daily per campaign/channel is the workhorse) — it drives warehouse cost and every trend card.
  • Land raw entity tables first, then build clean Metabase models on top.
  • Normalize channel, campaign, ad-group, date, spend, impressions, clicks, and conversions fields.

How should you model Meta Ads data in Metabase?

Core tables

TableGrainKey columns
meta_ads_insightsone row per ad set per dayad_set_id, campaign_id, stat_date, impressions, clicks, spend, reach, frequency, conversions, conversion_value
meta_ads_campaignsone row per campaignid, name, objective, status, buying_type, created_at
meta_ads_ad_setsone row per ad setid, campaign_id, name, optimization_goal, daily_budget, targeting_summary, status

Modeling advice

  • Build a clean ad_performance_daily model with common columns across tools, so multi-channel dashboards don't fork definitions.
  • Separate entity tables (campaigns, audiences, pages) from daily time-series rollups.
  • Exclude test campaigns and internal traffic from headline metrics; keep channel and campaign as explicit columns.
  • Use stable IDs for campaign, channel, and user joins; display names change.

Which Meta Ads metrics should you track in Metabase?

MetricDefinitionNotes
ROASConversion value divided by ad spend, per campaign or channel.State the attribution model next to the number.
Customer acquisition costSpend divided by new customers acquired in the period.Decide blended vs. paid-only CAC once.
Cost per clickSpend divided by clicks — the price of attention.Compare within a channel, not across channels.
Click-through rateClicks divided by impressions per campaign or ad.A creative-health signal, not a business outcome.
Cost per leadSpend divided by leads or signups generated.Define what counts as a qualified lead first.

What SQL powers Meta Ads dashboards in Metabase?

These assume a cleaned analytical model in a warehouse (PostgreSQL dialect). Adjust table and column names to match your pipeline.

Spend, conversions, and ROAS by campaign by weekPostgreSQL

The core paid-performance trend.

SELECT
  campaign_name,
  date_trunc('week', stat_date) AS week,
  ROUND(SUM(spend), 2) AS spend,
  SUM(conversions) AS conversions,
  ROUND(SUM(conversion_value) / NULLIF(SUM(spend), 0), 2) AS roas
FROM ad_performance_daily
GROUP BY 1, 2
ORDER BY 2, spend DESC;
CTR, CPC, and cost per conversion by channelPostgreSQL

Efficiency signals across the account.

SELECT
  channel,
  date_trunc('month', stat_date) AS month,
  ROUND(100.0 * SUM(clicks) / NULLIF(SUM(impressions), 0), 2) AS ctr_pct,
  ROUND(SUM(spend) / NULLIF(SUM(clicks), 0), 2) AS cpc,
  ROUND(SUM(spend) / NULLIF(SUM(conversions), 0), 2) AS cost_per_conversion
FROM ad_performance_daily
GROUP BY 1, 2
ORDER BY 1, 2;
CAC by channel by monthPostgreSQL

Spend joined to newly acquired customers.

WITH monthly_spend AS (
  SELECT
    channel,
    date_trunc('month', stat_date) AS month,
    SUM(spend) AS spend
  FROM ad_performance_daily
  GROUP BY 1, 2
),
monthly_customers AS (
  SELECT
    acquisition_channel AS channel,
    date_trunc('month', acquired_at) AS month,
    COUNT(*) AS new_customers
  FROM customers
  GROUP BY 1, 2
)
SELECT
  s.channel,
  s.month,
  ROUND(s.spend, 2) AS spend,
  COALESCE(c.new_customers, 0) AS new_customers,
  ROUND(s.spend / NULLIF(c.new_customers, 0), 2) AS cac
FROM monthly_spend s
LEFT JOIN monthly_customers c
  ON c.channel = s.channel AND c.month = s.month
ORDER BY 1, 2;

What are common mistakes when analyzing Meta Ads in Metabase?

Syncing raw click or event streams into the warehouse.→ Land daily aggregates, campaign-grain stats, and entity tables. Raw streams belong in Meta Ads; the warehouse is for trends and joins.
Comparing platform-reported conversions as one number.→ Each platform attributes conversions under its own model and window — summing them double-counts. Keep per-platform columns, or use one source of truth for conversions.
Averaging ROAS across campaigns with different objectives.→ A brand-awareness campaign and a retargeting campaign aren't comparable. Segment by objective and funnel stage before ranking.
Building dashboards from live MCP lookups only.→ MCP is useful for exploration; durable dashboards need a database-backed model with history.

Related analytics

Related dashboards

Related integrations

FAQ

Does Metabase connect natively to Meta Ads?
No. Metabase reads databases and warehouses. Sync Meta Ads daily stats and entities into a database first, or upload a CSV with the Metabase CLI, then build Metabase models and dashboards on top.
Should Metabase replace Meta Ads?
No — they answer different questions. Meta Ads is built for running campaigns and day-to-day operations in its own UI. Metabase is where you build governed, shareable reporting on top of the same data, and join it with CRM, product, and revenue data.
Should I sync every Meta Ads click or impression event?
No. Daily stats by campaign and ad group answer almost every reporting question at a fraction of the volume. Sync daily performance aggregates plus entity tables (campaigns, ad groups, ads) — click-level data only matters for specialized attribution work.
Can I compare ROAS across ad platforms in Metabase?
Yes — that's the point of a warehouse. Union each platform's daily stats into one ad_performance_daily model with consistent channel, spend, and conversion columns. Just label the attribution caveat: each platform self-reports conversions under its own attribution model, so cross-channel ROAS comparisons are directional, not gospel.