Update to Ad Superpowers

{
  "description": "This skill should be used when the user asks to \"troubleshoot Google Ads performance\", \"diagnose CPA increase\", \"fix conversion drops\", \"investigate impression share decline\", or mentions \"ROAS degradation\", \"budget issues\", or \"performance problems\". Do NOT use for: full account audits (use account-auditor), keyword strategy planning (use keyword-strategy-planner).",
  "included_files": [
    {
      "relative_path": "references/decision-trees.md",
      "size_in_bytes": 47062
    }
  ],
  "name": "google-ads-performance-troubleshooter",
  "skill_md_contents": "---\nname: google-ads-performance-troubleshooter\ndescription: \"This skill should be used when the user asks to \\\"troubleshoot Google Ads performance\\\", \\\"diagnose CPA increase\\\", \\\"fix conversion drops\\\", \\\"investigate impression share decline\\\", or mentions \\\"ROAS degradation\\\", \\\"budget issues\\\", or \\\"performance problems\\\". Do NOT use for: full account audits (use account-auditor), keyword strategy planning (use keyword-strategy-planner).\"\n---\n# Performance Troubleshooter\n\nSystematic guide for diagnosing and resolving Google Ads performance problems. Start with the quick diagnosis below, then follow the detailed decision trees in references.\n\n## Quick Diagnosis Guide\n\n```\nWHAT PROBLEM DO YOU HAVE?\n│\n├─► CONVERSIONS DROPPED\n│   ���── Check 1: Is tracking intact? (tag firing, consent mode)\n│   ├── Check 2: Have clicks dropped? (traffic issue vs conversion rate)\n│   ├── Check 3: Landing page changed? (speed, mobile, form broken)\n│   ├── Check 4: Traffic quality changed? (search terms, device mix)\n│   ├── Check 5: Competition/seasonality? (Auction Insights)\n│   └── Detailed tree: See references/decision-trees.md \"Conversion Drop Diagnosis\"\n│\n├─► CPA INCREASED / ROAS DECREASED\n│   ├── Check: Is conversion volume stable? (CPA up with same volume = bid issue)\n│   ├── Check: New keywords/audiences? (lower intent traffic diluting efficiency)\n│   ├── Check: Auction competition? (competitor CPCs rising)\n│   ├── Check: Smart Bidding learning? (recent strategy change = 2-week volatility)\n│   └── Detailed tree: See references/decision-trees.md \"Efficiency Degradation\"\n│\n├─► IMPRESSIONS / CLICKS DROPPED\n│   ├── Check: Budget sufficient? (Limited by budget status)\n│   ├── Check: Impression Share Lost (Budget vs Rank)\n│   ├── Check: Ad disapprovals? (Policy violations)\n│   ├── Check: Keyword status? (Low search volume, below first page bid)\n│   └── Detailed tree: See references/decision-trees.md \"Volume Decline\"\n│\n├─► NO DELIVERY (0 impressions)\n│   ├── Check: Campaign/ad group/ad enabled?\n│   ├── Check: Budget > €0 and not exhausted?\n│   ├── Check: Targeting not too narrow?\n│   ├── Check: Negative keywords blocking all traffic?\n│   └── Detailed tree: See references/decision-trees.md \"Delivery Problems\"\n│\n├─► QUALITY SCORE DROPPED\n│   ├── Check: Expected CTR (ad relevance vs competition)\n│   ├── Check: Ad Relevance (keyword-to-ad alignment)\n│   ├── Check: Landing Page Experience (speed, relevance, mobile)\n│   └── Detailed tree: See references/decision-trees.md \"Quality Score\"\n│\n└─► SMART BIDDING NOT WORKING\n    ├── Check: Sufficient conversions? (Min 30/month for tCPA, 50 for tROAS)\n    ├── Check: Learning period? (2 weeks after changes)\n    ├── Check: Targets realistic? (not > 20% from actual performance)\n    ├── Check: Conversion lag? (report may not yet show recent conversions)\n    └── Detailed tree: See references/decision-trees.md \"Bidding Problems\"\n```\n\n## MCP Tool Integration\n\n```\nSTEP 1: Quick performance overview\ngoogle_ads_run_gaql(query=\"\n  SELECT\n    campaign.name,\n    campaign.status,\n    campaign.bidding_strategy_type,\n    metrics.cost_micros,\n    metrics.conversions,\n    metrics.cost_per_conversion,\n    metrics.conversions_from_interactions_rate,\n    metrics.search_impression_share,\n    metrics.search_budget_lost_impression_share,\n    metrics.search_rank_lost_impression_share\n  FROM campaign\n  WHERE campaign.status = 'ENABLED'\n    AND segments.date DURING LAST_14_DAYS\n  ORDER BY metrics.cost_micros DESC\n\")\n\nSTEP 2: Period-over-period comparison (detect degradation)\ngoogle_ads_run_gaql(query=\"\n  SELECT\n    segments.date,\n    metrics.impressions,\n    metrics.clicks,\n    metrics.conversions,\n    metrics.cost_micros,\n    metrics.average_cpc\n  FROM campaign\n  WHERE campaign.name = 'CAMPAIGN_NAME'\n    AND segments.date DURING LAST_30_DAYS\n  ORDER BY segments.date DESC\n\")\n\nSTEP 3: Ad group & keyword drill-down (find the problem area)\ngoogle_ads_run_gaql(query=\"\n  SELECT\n    ad_group.name,\n    metrics.impressions,\n    metrics.clicks,\n    metrics.conversions,\n    metrics.cost_micros,\n    metrics.cost_per_conversion\n  FROM ad_group\n  WHERE campaign.name = 'CAMPAIGN_NAME'\n    AND ad_group.status = 'ENABLED'\n    AND segments.date DURING LAST_14_DAYS\n  ORDER BY metrics.cost_micros DESC\n\")\n\nSTEP 4: Search terms quality check\ngoogle_ads_run_gaql(query=\"\n  SELECT\n    search_term_view.search_term,\n    metrics.impressions,\n    metrics.clicks,\n    metrics.conversions,\n    metrics.cost_micros\n  FROM search_term_view\n  WHERE segments.date DURING LAST_14_DAYS\n    AND metrics.impressions > 10\n  ORDER BY metrics.cost_micros DESC\n  LIMIT 50\n\")\n```\n\n## Key Thresholds\n\n```\nWHEN TO WORRY (vs normal fluctuation)\n──────────────────────────────────────\n├── CPA: > 30% increase sustained 7+ days\n├── Conversions: > 25% drop week-over-week\n├── CTR: > 20% decline (ad fatigue or relevance issue)\n├── Impression Share: > 15% drop (budget or competition)\n├── Quality Score: Drop of 2+ points on key keywords\n├── Smart Bidding: No improvement after 2-week learning period\n└── ROAS: > 25% decline for 7+ consecutive days\n```\n\n## Output: Troubleshooting Report Template\n\n```markdown\n# Performance Troubleshooting Report\n\n## Issue Summary\n- **Problem detected:** [Description]\n- **First signal:** [Date]\n- **Impacted campaigns:** [List]\n- **Severity:** [Critical/Warning/Info]\n\n## Symptoms\n| Metric | Previous Period | Current Period | Change |\n|--------|----------------|----------------|--------|\n| Impressions | [X] | [X] | [%] |\n| Clicks | [X] | [X] | [%] |\n| CTR | [X]% | [X]% | [%] |\n| Conversions | [X] | [X] | [%] |\n| CPA | €[X] | €[X] | [%] |\n| ROAS | [X]% | [X]% | [%] |\n\n## Root Cause Analysis\n\n### Investigated Factors\n- [ ] Conversion tracking: [OK/Issue found]\n- [ ] Landing page: [OK/Issue found]\n- [ ] Ad copy/creatives: [OK/Issue found]\n- [ ] Bidding strategy: [OK/Issue found]\n- [ ] Budget: [OK/Issue found]\n- [ ] Competition: [Changed/Stable]\n- [ ] Seasonality: [Yes/No]\n\n### Identified Cause\n**[Describe root cause]**\n\nEvidence:\n1. [Evidence 1]\n2. [Evidence 2]\n3. [Evidence 3]\n\n## Solutions\n\n### Immediate Actions (Now)\n1. [Action 1]\n2. [Action 2]\n\n### Short Term (This Week)\n1. [Action 1]\n2. [Action 2]\n\n### Long Term (Prevention)\n1. [Action 1]\n2. [Action 2]\n\n## Monitoring Plan\n- Daily check: [Metrics to monitor]\n- Weekly review: [KPIs]\n- Escalation trigger: [When to escalate again]\n```\n"
}