metric-tree-diagnostic

Diagnose full-funnel metric bottlenecks in Meta weekly reports.

Updated Jan 2, 2026
One-click install
npx skills add https://github.com/foreverjojo/Ivyhousetw-META --skill metric-tree-diagnostic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: metric-tree-diagnostic
Source: https://github.com/foreverjojo/Ivyhousetw-META/tree/main/project_skills/metric_tree_diagnostic
Command: npx skills add https://github.com/foreverjojo/Ivyhousetw-META --skill metric-tree-diagnostic

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automatically diagnoses the root causes of declining performance in full-funnel marketing reports, pinpointing specific stages of the customer journey that are underperforming.

Core Features & Use Cases

  • Full-Funnel Analysis: Breaks down key metrics like ROAS into their constituent parts (AOV, CPA, CPM, CTR, CVR) to identify performance drivers.
  • Bottleneck Identification: Pinpoints the most likely stage of the funnel (e.g., traffic, landing page, add-to-cart, checkout, purchase) contributing to poor results.
  • Actionable Recommendations: Provides concrete, low-effort next steps for improvement based on the diagnostic findings.
  • Use Case: When ROAS drops, this Skill helps you quickly understand if the issue lies with ad spend efficiency (CPM/CTR), website conversion rates (CVR), or average order value (AOV), guiding your optimization efforts.

Quick Start

Execute the metric tree diagnostic for the current weekly report.

Frequently Asked Questions about metric-tree-diagnostic

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

FAQPage Schema
How do I diagnose funnel bottlenecks when my Meta ROAS drops?

Funnel bottleneck diagnostic breaks down ROAS into constituent metrics like AOV, CPA, CPM, CTR, and CVR to pinpoint underperforming customer journey stages. It identifies whether ad spend efficiency, website conversion rates, or average order value drives the decline.

What is metric tree analysis for full-funnel marketing reports?

Metric tree analysis deconstructs high-level marketing metrics into their component variables to reveal performance drivers. It automatically identifies specific funnel stages like traffic, landing page, add-to-cart, or checkout that cause poor results.

How do I identify which funnel stage causes poor ROAS in Meta weekly reports?

Analyzing Meta weekly reports requires specific funnel event data to perform a deterministic full-funnel metric tree diagnostic. This process isolates the exact stage, from ad delivery to checkout, contributing to declining performance.

Do I need specific event data to run funnel analysis on Meta ads?

Yes, funnel analysis requires specific funnel event data from report_summary.json and kpi.meta files. These inputs provide the necessary metric components like CPM, CTR, and CVR to execute the deterministic diagnostic.

Does metric tree diagnostic provide actionable next steps for optimization?

Yes, metric tree diagnostic provides concrete, low-effort next steps for optimization based on diagnostic findings. After identifying the funnel bottleneck, it suggests targeted actions to improve underperforming stages.

When should I use metric tree diagnostic instead of standard funnel analysis?

Use metric tree diagnostic when ROAS drops and you need to quickly understand the root cause. It differs from standard analysis by mathematically breaking down metrics into constituent parts to pinpoint exact performance drivers.