AMMM Documentation

Build evidence-led marketing attribution

AMMM helps you build, analyse, and optimise Marketing Mix Models using Bayesian methods with PyMC.

Whether you are running your first MMM or iterating on a mature measurement framework, AMMM focuses on reproducible workflows and clear outputs.

Includes: Bayesian inference · Adstock · Saturation · Budget optimisation · Prophet seasonality · Diagnostics (R-hat, ESS) · Model comparison (ELPD)

Documentation Sections

Getting Started

New to AMMM? Start here for installation, data preparation, and running your first model.

Perfect for: First-time users, quick setup

Getting Started
How-to Guides

Practical step-by-step guides for common MMM tasks like configuring models, interpreting results, and optimising budgets.

Perfect for: Completing specific tasks

How-to Guides
Explanation

Deep dives into MMM methodology, model components, statistical concepts, and the theory behind the framework.

Perfect for: Understanding concepts

Explanation
API Reference

Technical details including configuration parameters, output file descriptions, and complete API documentation. API pages are generated at build time by AutoAPI.

Perfect for: Detailed specifications

API Reference
Diagnostics

Data validation tools, model diagnostic checks, and guidance for ensuring robust model performance.

Perfect for: Quality assurance

Diagnostics API
Troubleshooting

Solutions for common errors, performance tips, debugging strategies, and frequently asked questions.

Perfect for: Solving problems

Troubleshooting Guide

MMM Workflow

        graph LR
    A[Prepare Data] --> B[Configure Model]
    B --> C[Fit Model]
    C --> D[Validate Results]
    D --> E[Optimise Budget]
    D --> F{Satisfied?}
    F -->|No| B
    F -->|Yes| G[Deploy Insights]

    style A fill:#FFF4EC,stroke:#D9815E,stroke-width:2px
    style C fill:#FBF7F2,stroke:#1D3D59,stroke-width:2px
    style D fill:#F2F2F2,stroke:#1D3D59,stroke-width:2px
    style E fill:#FFF4EC,stroke:#CF7744,stroke-width:2px
    style G fill:#FBF7F2,stroke:#1D3D59,stroke-width:2px
    

Documentation Structure

  1. Getting Started: Installation and first model tutorials

  2. How-to Guides: Task-oriented guides for specific objectives

  3. Explanation: Conceptual background and methodology

  4. Reference: Technical specifications and API docs

  5. Diagnostics: Validation and quality assurance

  6. Troubleshooting: Problem-solving and debugging


About this documentation

  • Practitioners: Start with Getting Started → Quickstart, then run the pipeline via runme.py.

  • Engineers: See Guides and the API Reference. API pages are produced during the build by AutoAPI.

  • Analysts: Refer to the Output Schema and Guides on interpreting results to work with CSV outputs.

Additional Resources