meta-ads-analyzer

Diagnose Meta Ads campaign performance issues using the Breakdown Effect framework.

408|59|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/mathiaschu/meta-ads-analyzer --skill meta-ads-analyzer-mathiaschu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: meta-ads-analyzer
Source: https://github.com/mathiaschu/meta-ads-analyzer/tree/main/skill
Command: npx skills add https://github.com/mathiaschu/meta-ads-analyzer --skill meta-ads-analyzer-mathiaschu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Meta Ads advertisers frequently misinterpret performance breakdown data, leading to incorrect budget allocation decisions that raise overall campaign costs. This skill eliminates that risk by applying Meta's official system mechanics and the Breakdown Effect framework to deliver accurate, compliant analysis.

Core Features & Use Cases

  • Breakdown Effect-aware analysis: Correctly interprets marginal vs average efficiency to avoid pausing high-performing segments based on misleading average CPA metrics.
  • Comprehensive performance diagnosis: Identifies root causes of issues including Learning Phase delays, Auction Overlap, Pacing inefficiencies, Creative Fatigue, and low Ad Relevance Diagnostics.
  • Compliant structured reporting: Generates reports with standardized metric naming, actionable testable recommendations, and alignment with Meta's official API guidance and legal terminology requirements.
  • Use case: If your campaign has an ad set with a higher average CPA than others, this skill will analyze time-series marginal efficiency data to determine if the system is correctly shifting budget to lower overall costs, rather than recommending a harmful pause.

Quick Start

Use the meta-ads-analyzer skill to analyze your exported Meta Ads campaign data and generate a structured diagnosis report with actionable optimization recommendations.

Frequently Asked Questions about meta-ads-analyzer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze Meta Ads performance data to avoid incorrect budget allocation?

To analyze Meta Ads performance data safely, you must apply the Breakdown Effect framework to interpret marginal vs average efficiency, preventing incorrect budget allocation decisions that raise overall campaign costs.

Why does my Meta Ads campaign have a high average CPA but the system is still allocating budget to it?

Your Meta Ads campaign maintains a high average CPA because the system is shifting budget based on marginal efficiency rather than average metrics, a mechanism known as the Breakdown Effect.

What is the best way to diagnose Learning Phase delays and Auction Overlap in Meta Ads Manager?

The best way to diagnose Learning Phase delays and Auction Overlap is to analyze exported Meta Ads Manager data using official system mechanics to identify root causes and generate actionable optimization recommendations.

Can I use exported Meta Ads Manager data to identify Creative Fatigue and Pacing inefficiencies?

Yes, you can use exported Meta Ads Manager data or live API data to identify Creative Fatigue, Pacing inefficiencies, and low Ad Relevance Diagnostics by applying standardized metric naming and compliant reporting.

Does Meta Ads campaign analysis support live API data for generating structured diagnosis reports?

Meta Ads campaign analysis supports both exported Meta Ads Manager data and live API data, satisfying requirements for compliant, standardized reporting with correct metric naming and actionable testable recommendations.

When should I not pause an underperforming ad set during Meta Ads campaign analysis?

You should not pause an underperforming ad set when time-series marginal efficiency data indicates the system is correctly shifting budget to lower overall costs, which prevents harmful budget allocation decisions.