Skip to main content
Meta Ads Kit gives you a focused set of reports designed to replace your daily Ads Manager routine. Each report answers a specific question about your campaigns.

​
Available Reports

​
Daily Check

Your morning briefing. Answers the 5 Daily Questions in a single command. 
./scripts/meta-ads.sh daily-check
What you get:
  1. Spend pacing vs daily budget
  2. Active campaign status
  3. 7-day performance metrics
  4. Top 3 winners and bottom 3 losers
  5. Fatigue signals (CTR trends, frequency, CPC movement)
When to use: Every morning. This is your starting point.
Run this as a cron job and pipe it to Slack or Telegram for automated morning briefings.

​
Overview

Account-level summary with campaign breakdown. 
./scripts/meta-ads.sh overview --preset last_30d
What you get:
  • Total spend, impressions, clicks, conversions
  • Campaign-by-campaign breakdown
  • Week-over-week comparisons
When to use: Monthly reviews, reporting to stakeholders, understanding overall account health.

​
Campaigns

List all campaigns with optional status filtering. 
# All active campaigns
./scripts/meta-ads.sh campaigns --status ACTIVE

# All campaigns (active, paused, archived)
./scripts/meta-ads.sh campaigns
What you get:
  • Campaign names and IDs
  • Status (active/paused)
  • Budget settings
  • Objective
When to use: Auditing your account structure, checking what’s currently running.

​
Top Creatives

Ad-level performance ranked by results. 
./scripts/meta-ads.sh top-creatives --preset last_7d
What you get:
  • Ads sorted by CTR or conversions
  • Spend and efficiency metrics
  • Creative performance trends
When to use: Finding your best performers to scale, identifying winning creative patterns.

​
Bleeders

Ads burning budget with poor performance. 
./scripts/meta-ads.sh bleeders --preset last_7d
What you get:
  • Ads with CTR < 1% or frequency > 3.5
  • High spend, low return candidates
  • Clear pause recommendations
When to use: Daily or weekly cleanup. Stop budget waste fast.
Review bleeders carefully. Sometimes low CTR is fine if conversion rate is strong. Check full funnel metrics before pausing.
Learn more about bleeders →

​
Winners

Top performing ads ready to scale. 
./scripts/meta-ads.sh winners --preset last_7d
What you get:
  • Highest CTR ads with volume
  • Low CPC, high efficiency
  • Scaling headroom analysis
When to use: Finding scale opportunities, allocating more budget to proven performers. Learn more about winners →

​
Fatigue Check

Daily creative health monitoring. 
./scripts/meta-ads.sh fatigue-check
What you get:
  • CTR trends (declining day-over-day)
  • Frequency creep warnings
  • CPC inflation signals
  • Severity ratings (critical/warning/monitor)
When to use: Daily. Catch creative fatigue before it kills ROAS. Learn more about fatigue detection →

​
Custom Reports

Full control over level, fields, and breakdowns. 
./scripts/meta-ads.sh custom --level ad --fields "ad_name,spend,ctr,cpc" --breakdowns "age,gender"
What you get:
  • Any metric combination
  • Demographic/placement/device breakdowns
  • Campaign, adset, or ad level data
When to use: Deep dives, audience analysis, custom dashboards. Learn more about custom reports →

​
Date Presets

All reports accept a --preset flag to control the time range:
PresetRangeUse case
todayToday onlyReal-time monitoring
yesterdayYesterday onlyDaily recap
last_7dLast 7 daysDefault — Weekly trends
last_30dLast 30 daysMonthly reporting
last_90dLast 90 daysQuarterly analysis

​
Example Usage

./scripts/meta-ads.sh overview --preset today
Most performance decisions are made on 7-day data. Use last_7d (the default) for daily checks, and last_30d for strategic reviews.
  1. Morning: Run daily-check — get the full picture in 2 minutes
  2. Review bleeders: Check if any need pausing
  3. Review winners: Identify scale opportunities
  4. Check fatigue: Spot creatives that need rotation
  5. Take action: Pause bleeders, scale winners (with approval)
All reports are read-only by default. The system will never pause ads or change budgets without explicit approval.

​
Next Steps

Bleeders & Winners

Learn how to identify and act on underperformers and top performers

Fatigue Detection

Understand fatigue signals and severity levels

Custom Reports

Build your own reports with breakdowns and custom fields

5 Daily Questions

Deep dive into the core workflow

Build docs developers (and LLMs) love

Get started for freeTalk to us