meta-ads-analyzer

Diagnose Meta Ads campaign and ad set performance from CSV exports.

1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/yahav123147/paid-ads-cro-skills --skill meta-ads-analyzer-yahav123147
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: meta-ads-analyzer
Source: https://github.com/yahav123147/paid-ads-cro-skills/tree/main/skills/meta-ads-analyzer
Command: npx skills add https://github.com/yahav123147/paid-ads-cro-skills --skill meta-ads-analyzer-yahav123147

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you interpret Meta Ads performance data and determine why CPA/ROAS changed, so you can generate reliable, testable optimization actions without falling into the Breakdown Effect trap.

Core Features & Use Cases

  • Breakdown Effect-safe diagnosis: Evaluates the correct level (campaign vs ad set) and explains recommendations through marginal efficiency, not average CPA.
  • Meta Ads root-cause analysis: Uses learning phase status, pacing dynamics, ad relevance diagnostics, and auction mechanics to attribute performance issues to likely causes.
  • Actionable recommendation reports: Produces structured reports with evidence, standardized metric naming, and hypothesis-framed changes.

Quick Start

Provide your Meta Ads export (CSV) or key metrics by campaign/ad set, and ask for a breakdown-effect-aware diagnosis with 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 diagnose Meta Ads performance issues from a CSV export?

To diagnose Meta Ads performance from a CSV export, you evaluate exported metrics, learning phase status, and auction mechanics to identify root causes and generate actionable optimization recommendations.

What is the Breakdown Effect in Meta Ads and how do I avoid it?

The Breakdown Effect in Meta Ads causes misleading performance readings by evaluating average CPA instead of marginal efficiency. Avoid it by enforcing evaluation at the correct campaign or ad set level.

Why did my Purchase ROAS drop during the learning phase?

Purchase ROAS often drops during the learning phase due to unstable pacing dynamics and auction mechanics. Analyzing ad relevance diagnostics and learning phase status attributes the performance issue to likely causes.

Can I use screenshots of Ads Manager to troubleshoot CPA and ROAS evaluation?

Yes, you can use screenshots of Ads Manager for CPA and ROAS evaluation. The analysis reviews screenshot-based performance data to generate structured reports with evidence-backed, hypothesis-framed changes.

How do I standardize metric naming for Meta Ads campaign diagnosis?

Standardize metric naming for Meta Ads campaign diagnosis by enforcing strict labels like CPC (Link Click) and Purchase ROAS, and clearly disambiguating Clicks (all) versus Link Clicks in reports.

What is the best way to troubleshoot placement and audience breakdown effects?

The best way to troubleshoot placement and audience breakdown effects is to evaluate the correct campaign or ad set level, ensuring recommendations are explained through marginal efficiency rather than average CPA.