Skip to content
meta-ads-healthcheck logo

Meta Ads Healthcheck

meta-ads-healthcheck

[Didoo AI] Fast on-demand campaign status check — answers \"are my ads working?\" using Green/Yellow/Red thresholds. For daily routine monitoring, use meta-ads-daily-pulse instead.

SKILL.md

Full skill instructions

Required Credentials

CredentialWhere to GetUsed ForOAuth Scope
META_ACCESS_TOKENMeta Developer Console → Graph API Explorer → Generate TokenFetching campaign and adset dataads_read (read-only)
META_AD_ACCOUNT_IDAds Manager URL: adsmanager.facebook.com/​act_XXXXXXXXXIdentifying which account to query—

When to Use

When user wants a quick "are my ads working?" check — not a deep diagnostic, just a status update. Use before a meeting, or any time something feels off.

meta-ads-healthcheckmeta-ads-daily-pulse
Primary question"Is this campaign healthy or not?""Did anything change vs. last week?"
Comparison basisFixed Green/​Yellow/​Red thresholdsSame day of prior week (WoW)
Best forOn-demand check when something feels wrong; meeting prepDaily routine, morning scan
Output styleCampaign-by-campaign status reportChange alerts ranked by revenue impact

Step 1: Get the Basics

Pull the user's Meta Ads data for today and the past 7 days:

  • Campaign name, status, spend
  • Results, cost per result
  • CTR, frequency
  • Any alerts or issues (delivery low, learning limited, paused)

Use Meta Marketing API to fetch campaign and adset level data.


Step 2: Traffic Light Assessment

Score each campaign as Green / Yellow / Red:

SignalGreenYellowRed
DeliverySpending normally< 80% of budget< 50% or zero
Cost per resultAt or below target10–30% above target (and variance is normal)30%+ above target and sustained (not just a spike)
Frequency< 33–4> 4
LearningOut of learningIn learning (< 7 days)Stuck in learning
CTR> 1%0.5–1%< 0.5%

Step 3: Check for Normal Performance Fluctuations

Before flagging a campaign as Yellow or Red, confirm it's not normal fluctuation.

Normal fluctuation — monitor only:

  • CPA is bouncing around day-to-day (up to ±30%) but the rolling average is stable — this is normal Meta Ads volatility, not a problem
  • Weekend vs. weekday differences
  • Gradual changes over weeks
  • Variation while in Learning Phase

Concerning — investigate today:

  • CPA average has shifted up and stayed there for 3+ consecutive days (not just a one-day spike) — this is a real trend, not fluctuation
  • Delivery dropping to near zero with no budget change
  • Conversion rate declining while spend increases
  • Performance degradation after a recent edit

Before diagnosing problems, ask:

  1. Is the ad set still in Learning Phase? (if yes, delay judgment — data is unstable)
  2. What's the baseline for normal variation for this campaign?
  3. Are there external factors — seasonality, competitor activity, or platform changes?
  4. Is sample size sufficient? (typically need 7+ days of data for stable ad sets)

Step 4: Surface Key Issues

For each Yellow or Red campaign, identify:

  • What is the specific problem?
  • How urgent is it? (Needs attention today / this week / monitor)
  • What likely caused it?

Creative Refresh Trigger — Frequency > 3: When frequency reaches 3 or higher, flag the campaign as "Creative Refresh Needed": "Campaign [X] has frequency at [N] — audience is seeing the same ads too often. This typically causes CTR to drop and CPL to rise. Creative refresh is indicated."

Note: When this flag appears, the appropriate next step is meta-ads-recommendation — it will prescribe the specific creative refresh action based on the full analysis context. Do not trigger meta-ads-builder directly from this skill.


Step 5: Quick Output

Overall Status: [N] campaigns running | [N] Green | [N] Yellow | [N] Red

For each Red/​Yellow campaign:
- Campaign name
- Status: [Issue]
- Spend / Results / CPL
- What happened (1 sentence)
- Suggested focus area (1 sentence)

Everything else: brief healthy summary.

Priority Sort — What to Check First

When you have 10+ active campaigns:

  1. Red campaigns with spend > $50/​day → Check today
  2. Yellow campaigns where CPL is 20%+ above target → Check today
  3. New campaigns (< 7 days, still in Learning) → Flag as "Learning Phase — Do Not Judge Yet"
  4. Green campaigns → Review weekly

When to Escalate

  • If the health check surfaces a real problem: suggest meta-ads-analysis for a full diagnostic
  • For daily routine monitoring: suggest meta-ads-daily-pulse instead

Skill Boundary

  • This is a quick scan, not a deep diagnostic — don't draw conclusions beyond what's clearly broken or healthy
  • Do not make optimization recommendations in this skill — that's meta-ads-recommendation's job
  • Do not re-fetch data if it was recently pulled in the same session

More Marketing skills

copywriting logo
Marketing

copywriting

Marketing copy for homepages, landing pages, pricing pages, and other conversion-focused web pages.

53.3K 216.1K
View
flux-2-klein logo
Marketing

flux-2-klein

Fast image generation with Flux 2 Klein, optimized for sub-second iteration and multi-reference brand styling.

52 176.2K
View

Psychological principles and mental models for understanding customer behavior and influencing marketing decisions.

53.3K 153K
View

Plan searchable and shareable content that drives traffic, builds authority, and generates leads.

53.3K 150.9K
View

Build SEO-optimized pages at scale using templates, data, and proven playbook patterns.

53.3K 140.1K
View

Brainstorm and prioritize marketing strategies tailored to your SaaS stage, budget, and goals.

53.3K 137.2K
View
ai-seo logo
Marketing

ai-seo

Optimize content for discovery, citation, and visibility across AI search platforms and LLM assistants.

53.3K 136.7K
View
copy-editing logo
Marketing

copy-editing

Systematic improvement of existing marketing copy through seven focused editing passes.

53.3K 136.4K
View

Plan and optimize your website's page hierarchy, navigation, URL structure, and internal linking.

53.3K 112.8K
View
revops logo
Marketing

revops

Design and optimize systems connecting marketing, sales, and customer success into a unified revenue engine.

53.3K 104.9K
View

Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.

179.7K 100.1K
View

Convert websites into professional HyperFrames videos with guided storyboarding and brand-aligned composition.

57K 93.5K
View

Sales & marketing AI tools

KreadoAI logo
Sales & marketing

KreadoAI

Revolutionize Video Creation with AI-Generated Avatars and Voices

Paid
View
Followr logo
Sales & marketing

Followr

Social media on autopilot

Paid
View
Logodiffusion logo
Sales & marketing

Logodiffusion

Design custom logos instantly with AI.

Paid
View
I
Sales & marketing

Ideogram

Text-heavy marketing and design images

Freemium
View
Prompt Silo logo
Sales & marketing

Prompt Silo

Boost Your SEO with Content and SEO Silos

Free
View
Marketing Blocks logo
Sales & marketing

Marketing Blocks

Revolutionize Your Marketing with AI-Powered MarketingBlocks!

Paid
View
Scrip AI logo
Sales & marketing

Scrip AI

10X faster & free AI content creation for 100+ use cases

Free
View
Tribescaler logo
Sales & marketing

Tribescaler

Tribescaler | Make Your Tweets Go Viral

Paid
View