Catches unusual performance changes across your accounts — CPC spikes, CVR drops, spend surges, impression collapses, CTR shifts — and flags them with context about what likely changed. The goal is to catch problems in hours instead of discovering them days later during a routine check. Platform: Google and Meta.
git clone https://github.com/irinabuht12-oss/marketing-skills.git--- name: anomaly-detection description: Catches unusual performance changes across your accounts — CPC spikes, CVR drops, spend surges, impression collapses, CTR shifts — and flags them with context about what likely changed. The goal is to catch problems in hours instead of discovering them days later during a routine check. Platform: Google and Meta. metadata: platform: Google and Meta --- # 6/ Anomaly Detection — Google + Meta ## What it does Catches unusual performance changes across your accounts — CPC spikes, CVR drops, spend surges, impression collapses, CTR shifts — and flags them with context about what likely changed. The goal is to catch problems in hours instead of discovering them days later during a routine check. ## How it works Claude compares current performance against your recent baseline (typically 7-14 day rolling average) and flags any metric that moves beyond a threshold you set. It then cross-references the anomaly against common causes — budget changes, auction shifts, ad disapprovals, audience exhaustion, landing page issues, or external events. ## Practical example Thursday at 2pm, your branded search CPC jumps 47% compared to the 14-day average. Claude flags it and identifies that a competitor started bidding on your brand terms (impression share dropped from 94% to 71% simultaneously). It also catches that a Meta campaign's CVR dropped 60% — the landing page started returning 404 errors after a site deployment at 1:30pm. ## What you get back - List of anomalies ranked by financial impact (estimated wasted or lost spend) - Each anomaly paired with the most likely cause based on correlated data shifts - Recommended immediate actions for each issue - Severity rating so you know what to fix now vs what can wait - Baseline comparison data so you can see exactly how far off normal the metric is ## When to use it - Daily monitoring across all active accounts - After website deployments or landing page changes - During high-spend periods like Black Friday or product launches - When managing multiple accounts and you can't manually check everything daily ## Data access (Ryze MCP) This skill works best with live account data. Connect the free Ryze MCP once and Claude reads your Google Ads, Meta Ads, GA4 and Search Console directly: - claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → `https://connector.get-ryze.ai/mcp` - Claude Code: `claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp` - Cursor: Settings → MCP → add the same URL Setup guide: https://www.get-ryze.ai/how-to-connect-claude-to-google-meta-ads-mcp
[{"step":"Gather your data. Export performance reports from [PLATFORM: Google Ads/Meta Ads Manager] for the [DATE_RANGE] you want to analyze. Include metrics like CPC, CVR, spend, impressions, and CTR. Save the data as a CSV or connect your account via API if your tool supports it.","tip":"Use Google Data Studio or Meta Ads Manager's built-in reporting to pull the last 7 days of data. Ensure your time zone settings match to avoid discrepancies in anomaly timing."},{"step":"Customize the prompt. Replace [ACCOUNT_NAME], [DATE_RANGE], [PLATFORMS], [METRICS], and [THRESHOLD] with your specific details. Adjust the [TIME_WINDOW] if you want to focus on a shorter or longer period.","tip":"For Meta Ads, include both Instagram and Facebook placements in your data export. For Google Ads, ensure you’re pulling data for Search, Display, and Video campaigns separately if you want granular insights."},{"step":"Run the analysis. Paste the customized prompt into your AI tool (e.g., ChatGPT, Claude) and generate the report. If using an API-connected tool, upload your data file and run the analysis directly.","tip":"For large accounts, break the analysis into smaller chunks (e.g., by campaign type or platform) to avoid overwhelming the AI with too much data at once."},{"step":"Review and act. Use the AI-generated report to prioritize anomalies based on their potential revenue impact. Implement the recommended actions and monitor the changes in real-time.","tip":"Set up alerts in your ad platform (e.g., Google Ads' 'Change History' alerts or Meta's 'Anomaly Detection' alerts) to catch similar issues automatically in the future."},{"step":"Document and iterate. Save the report for your records and note which anomalies were resolved successfully. Use this data to refine your thresholds or improve your anomaly detection strategy over time.","tip":"Track false positives (e.g., anomalies that weren’t actionable) to adjust your [THRESHOLD] or [TIME_WINDOW] in future analyses."}]
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/irinabuht12-oss/marketing-skills/tree/main/skills/anomaly-detectionCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Analyze [ACCOUNT_NAME] performance data for [DATE_RANGE] across [PLATFORMS: Google/Meta]. Identify any anomalies in [METRICS: CPC, CVR, spend, impressions, CTR] that deviate more than [THRESHOLD: 20%] from the 7-day rolling average. For each anomaly, provide: 1) the metric affected, 2) the magnitude of change, 3) the likely cause (e.g., 'bid adjustment,' 'budget exhaustion,' 'competitor activity'), and 4) recommended actions to investigate or remediate. Focus on changes that occurred in the last [TIME_WINDOW: 24 hours].
### Anomaly Detection Report for Acme Corp (Google Ads & Meta) - Last 24 Hours **1. Google Ads - CPC Spike in Search Campaigns** - **Metric:** Cost Per Click (CPC) - **Change:** +42% (from $1.28 to $1.82) - **Time:** 10:45 AM UTC, June 5, 2024 - **Likely Cause:** Bid strategy shift from 'Maximize Clicks' to 'Manual CPC' with higher bids for high-value keywords. Confirmed by checking the campaign settings history. - **Action:** Revert to 'Maximize Clicks' or adjust manual bids downward by 25% to align with previous performance. Monitor for 4 hours post-change. **2. Meta Ads - CVR Drop in Lead Generation Ads** - **Metric:** Conversion Rate (CVR) - **Change:** -38% (from 3.2% to 2.0%) - **Time:** 2:15 PM UTC, June 5, 2024 - **Likely Cause:** Audience overlap detected between two overlapping ad sets targeting similar demographics. The overlap increased from 12% to 35% after a recent audience expansion. - **Action:** Pause the underperforming ad set and exclude its audience from the other ad set. Test a new lookalike audience with a 1% seed audience size. **3. Meta Ads - Impression Collapse in Brand Awareness Campaign** - **Metric:** Impressions - **Change:** -55% (from 1.2M to 540K) - **Time:** 6:30 PM UTC, June 5, 2024 - **Likely Cause:** Budget cap reached at 80% of daily spend due to sudden traffic spike from a viral post. The campaign's $10K daily budget was exhausted by 4 PM UTC. - **Action:** Increase daily budget to $15K and implement dayparting to avoid early budget exhaustion. Monitor frequency to ensure it stays below 3.0. **4. Google Ads - CTR Shift in Display Campaigns** - **Metric:** Click-Through Rate (CTR) - **Change:** +67% (from 0.12% to 0.20%) - **Time:** 8:00 AM UTC, June 5, 2024 - **Likely Cause:** New ad creatives (videos) introduced with higher engagement potential. The previous static images had lower interaction rates. - **Action:** Pause underperforming static image ads and allocate 70% of the budget to the new video creatives. A/B test two new video variations. **Summary:** 4 critical anomalies detected in the last 24 hours, all requiring immediate action. Prioritize the CPC spike and CVR drop as they have the highest revenue impact potential. Recommended next steps: 1) Adjust bids and budgets, 2) Resolve audience overlap, 3) Optimize creatives, and 4) Monitor changes for 12 hours.
skills-collection
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan