# Meta Troubleshooting & Root Cause Framework v1.0

## Enterprise Operating System Guide
Purpose: Diagnose performance issues, identify root causes, implement corrective actions, validate resolution, and capture learning.

# 12 Decision Trees

## Decision Tree 1: Is There A Problem?
```text
Issue detected -> Investigate -> Validate -> Decide
```

## Decision Tree 2: Measurement Valid?
```text
Issue detected -> Investigate -> Validate -> Decide
```

## Decision Tree 3: Measurement or Performance?
```text
Issue detected -> Investigate -> Validate -> Decide
```

## Decision Tree 4: Audience or Creative?
```text
Issue detected -> Investigate -> Validate -> Decide
```

## Decision Tree 5: Reach or Frequency?
```text
Issue detected -> Investigate -> Validate -> Decide
```

## Decision Tree 6: Delivery or Conversion?
```text
Issue detected -> Investigate -> Validate -> Decide
```

## Decision Tree 7: Attribution or Incrementality?
```text
Issue detected -> Investigate -> Validate -> Decide
```

## Decision Tree 8: Internal or External Cause?
```text
Issue detected -> Investigate -> Validate -> Decide
```

## Decision Tree 9: Corrective Action Selection
```text
Issue detected -> Investigate -> Validate -> Decide
```

## Decision Tree 10: Escalation Path
```text
Issue detected -> Investigate -> Validate -> Decide
```

## Decision Tree 11: Validation Complete?
```text
Issue detected -> Investigate -> Validate -> Decide
```

## Decision Tree 12: Learning Captured?
```text
Issue detected -> Investigate -> Validate -> Decide
```

# QA Framework
- Issue defined
- Evidence collected
- Root cause validated
- Corrective action assigned
- Validation completed
- Learning recorded

# RACI Framework
Detection | Validation | Diagnosis | Resolution | Audit | Registry

# Root Cause Registry
Issue ID | Symptom | Root Cause | Action | Owner | Status | Learning

# Audit Framework
Audit false diagnoses, repeated incidents, measurement failures, unresolved actions, and documentation gaps.

# 100 Expanded Diagnosis Templates

## Measurement Scenarios

### 1. Purchase Event Missing
- Finding: Purchase Event Missing detected.
- Evidence Required: KPI trend, segmentation, configuration, and validation data.
- Likely Causes: Measurement issue, delivery pressure, audience change, creative change, business change, or external factors.
- Primary Root Cause: Determined after validation.
- Contributing Factors: Supporting conditions increasing risk.
- Business Impact: Efficiency, volume, reach, revenue, profit, or customer outcome risk.
- Corrective Actions: Validate data, isolate driver, implement targeted fix.
- Validation Criteria: KPI stabilizes or returns to expected range.
- Escalation Criteria: Material commercial, reputational, compliance, or delivery risk.
- Confidence: High / Medium / Low based on evidence quality.

(The full 100-item registry mirrors this template for each of the following scenarios, grouped by category:

**Measurement Scenarios (1-25):** Purchase Event Missing, Lead Event Missing, Duplicate Events, Revenue Inflation, Revenue Deflation, Attribution Conflict, CRM Conflict, Analytics Conflict, Finance Conflict, CAPI Failure, Pixel Failure, Deduplication Failure, Timezone Mismatch, Currency Mismatch, Event Delay, Offline Conversion Upload Failure, Value Corruption, Parameter Mismatch, Funnel Break, Session Mismatch, Identity Mismatch, Consent Impact, Reporting Latency, Conversion Lag Distortion, Tracking Deployment Issue.

**Performance Scenarios (26-50):** CPA Rising, CPA Falling, ROAS Rising, ROAS Falling, Reach Plateau, Reach Decline, Frequency Inflation, Frequency Decline, Audience Saturation, Audience Overlap, Creative Fatigue, Creative Deterioration, Creative Winner Fails, Budget Inefficiency, Scaling Inefficiency, Prospecting Deterioration, Retargeting Saturation, Incrementality Decline, Incrementality Improvement, Brand Lift Mismatch, Conversion Lift Mismatch, View Through Inflation, Placement Inefficiency, Device Inefficiency, Learning Instability.

**Delivery Scenarios (51-75):** Underspend, Overspend, CPM Spike, CPM Collapse, Delivery Concentration, Auction Volatility, Reels Underdelivery, Stories Underdelivery, Feed Concentration, Audience Eligibility Decline, Bid Restriction, Creative Approval Issue, Inventory Restriction, Market Delivery Imbalance, Cross Market Inconsistency, Reach Compression, Frequency Concentration, Budget Pacing Issue, Automation Instability, Asset Coverage Issue, Placement Eligibility Issue, Cost Control Issue, Signal Degradation, Opportunity Exhaustion, Delivery Disruption.

**Business Scenarios (76-100):** Qualified Lead Decline, MQL Decline, SQL Decline, Opportunity Decline, Revenue Decline, Margin Decline, Profit Decline, New Customer Decline, Retention Decline, Store Visits Decline, Brand Awareness Decline, Consideration Decline, Market Share Decline, Forecast Miss, Forecast Beat, Inventory Constraint, Product Outage, Demand Decline, Promotion Distortion, Market Disruption, Existing Customer Inflation, Attribution Inflation, Revenue Inflation Business, ROAS Inflation, Incremental Value Decline.

Each of these 100 items follows the identical template structure shown above for "Purchase Event Missing" — Finding, Evidence Required, Likely Causes, Primary Root Cause, Contributing Factors, Business Impact, Corrective Actions, Validation Criteria, Escalation Criteria, and Confidence.)

# Maturity Model
1 Reactive
2 Structured
3 Root Cause
4 Preventative
5 Enterprise Diagnostic Operating System