# GeoLift Documentation

Welcome to GeoLift - Advanced Causal Inference and Marketing Attribution with Sparse Synthetic Control.

## Key Business Questions Answered

### 🎯 What are you solving for?
GeoLift measures the **true incremental impact** of your regional marketing campaigns. It answers: "How much additional sales/conversions did my campaign actually generate?" by comparing treated markets against a scientifically-constructed control group.

### 💡 Why is this important and what does it help prove?
- **Prove ROI**: Demonstrate actual return on marketing investment with statistical confidence
- **Optimize Budget**: Identify which regional campaigns deliver the best results
- **Avoid False Positives**: Distinguish real campaign impact from natural market fluctuations
- **Support Budget Requests**: Provide rigorous evidence for marketing effectiveness to leadership

### 🔗 Is this the only thing I need or part of a wider solution?
GeoLift is **one component** of a comprehensive marketing measurement stack:
- **Complements**: Media Mix Modeling (MMM), Attribution, A/B testing
- **Specializes in**: Geo-based campaigns where randomized testing isn't feasible
- **Integrates with**: Your existing analytics tools and data pipelines
- **Best used for**: Regional campaigns, store rollouts, local advertising tests

### 💰 Cost and ROI?
- **Software Cost**: Proprietary license - contact for pricing
- **Implementation**: 2-4 weeks for setup and training
- **ROI Delivery**: Typically 5-10x return through improved campaign optimization
- **Payback**: Most clients see payback within first campaign optimization cycle

### ⚙️ How does it work? What's the process?
**Simple 3-Step Process:**
1. **Find Fair Comparison** → Identify control markets that behave like your test markets
2. **Check Test Strength** → Ensure your experiment can detect meaningful results
3. **Measure the Lift** → Calculate actual incremental impact with statistical confidence

---

## Documentation Structure

Our documentation follows a layered approach to reduce cognitive load while providing clear paths for users at different expertise levels:

```{toctree}
:maxdepth: 2
:caption: Getting Started

QUICK_START
USER_GUIDE
FAQ
```

```{toctree}
:maxdepth: 2
:caption: Technical Reference

API_REFERENCE
COMPARISON
ADVANCED_TOPICS
```

## Quick Navigation

- **[Quick Start Guide](QUICK_START.md)** - Get running in 5 minutes
- **[User Guide](USER_GUIDE.md)** - Complete business workflow
- **[FAQ](FAQ.md)** - Common questions and troubleshooting
- **[API Reference](API_REFERENCE.md)** - Technical documentation
- **[Methodology Comparison](COMPARISON.md)** - How GeoLift compares to other approaches
- **[Advanced Topics](ADVANCED_TOPICS.md)** - Mathematical background and production deployment

## Documentation Philosophy

1. **Business Value First** - Understand what problem we solve
2. **Quick Start** - Get immediate value with examples
3. **Complete Workflow** - Learn the full process
4. **Technical Details** - Deep dive when needed
5. **Advanced Topics** - Mathematical foundations and production features

This structure ensures that business stakeholders can quickly understand the value proposition while technical users can access the depth they need.