ad-campaign-analyzer

Grade ad sets Red, Yellow, or Green using CPA, CTR, and fatigue signals.

60|5|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/superamped/ai-marketing-skills --skill ad-campaign-analyzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ad-campaign-analyzer
Source: https://github.com/superamped/ai-marketing-skills/tree/main/skills/ads/ad-campaign-analyzer
Command: npx skills add https://github.com/superamped/ai-marketing-skills --skill ad-campaign-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Grade running ads as Red (stop) / Yellow (hold) / Green (scale) by translating campaign performance data into actionable grades, reducing wasted spend and speeding optimization cycles.

Core Features & Use Cases

  • Automated grading: Assigns a Red/Yellow/Green grade to each ad/ad set based on CPA, CTR, and fatigue indicators.
  • Data-driven scaling: Provides concrete scaling recommendations using the 20% rule and stability checks.
  • Benchmarking & diagnostics: Compares performance against internal targets and industry indicators to surface optimization opportunities.
  • Use Case: A performance marketer reviews a weekly ads dashboard and immediately identifies the few greens to scale while pausing reds.

Quick Start

Upload your campaign data (CSV, table, or pasted text) and target CPA, and receive ad-level Red/Yellow/Green grades with scaling recommendations.

Frequently Asked Questions about ad-campaign-analyzer

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

FAQPage Schema
How do I grade ad sets as red, yellow, or green for scaling decisions?

To grade running ads, upload campaign metrics like impressions, clicks, spend, and conversions via CSV or pasted table, then input your target CPA and AOV to generate red, yellow, or green statuses with scaling recommendations.

What metrics do I need to calculate scaling recommendations for my campaigns?

Calculating scaling recommendations requires campaign data including impressions, clicks, spend, and conversions. You also need clear CPA targets, AOV, and historical data to compute thresholds and apply the 20% scaling rule.

How does fatigue detection work for ad campaign optimization?

Fatigue detection identifies underperforming ads by analyzing impression and click trends within your campaign data, contributing to the red, yellow, or green grade assigned to each ad set based on CPA and CTR thresholds.

Can I use pasted metrics text instead of a CSV for ad analysis?

Yes, ad analysis supports CSV files, tables, or directly pasted metrics text containing your impressions, clicks, spend, and conversions to evaluate performance and generate red, yellow, or green ad grades.

When should I pause or scale an ad set during campaign optimization?

Pause red-graded ad sets to reduce wasted spend and scale green-graded sets using the 20% rule and stability checks. Yellow-graded sets should be held while monitoring CPA, CTR, and fatigue indicators.

Does ad campaign analysis work without a defined target CPA?

No, clear CPA targets and AOV are required to compute performance thresholds. Without these inputs, the analyzer cannot accurately benchmark your campaign data or produce reliable red, yellow, or green scaling decisions.