> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ocular.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Choose your path

> A persona-routed reading order for the Ocular docs — pick the role closest to yours (founder, marketer, analyst, ops) and follow the curated path.

Ocular serves three primary audiences. Each has a different reason to open the docs, and each benefits from a different starting point. Pick the one closest to your role.

<Tip>
  Not sure which one fits? Most ecommerce teams have someone in each of these roles. Read the role description and pick the one whose questions you spend the most time on.
</Tip>

<CardGroup cols={3}>
  <Card title="Operator" icon="bag-shopping" href="#operator">
    Founders, CXOs, heads of ecommerce, GMs
  </Card>

  <Card title="Marketer" icon="bullhorn" href="#marketer">
    Growth leads, performance marketers, brand & creative
  </Card>

  <Card title="Data & analytics" icon="database" href="#data-team">
    Analysts, data engineers, BI leads
  </Card>
</CardGroup>

***

## <Icon icon="bag-shopping" iconType="solid" /> Operator \[#operator]

*Founder, CXO, head of ecommerce, GM*

<CardGroup cols={2}>
  <Card title="You spend your time on" icon="briefcase">
    The P\&L, channel-level profitability, inventory, pricing strategy, vendor and marketplace negotiations.
  </Card>

  <Card title="Your typical questions" icon="circle-question">
    "What's my true contribution margin this month?" "Which channel is actually profitable?" "Are returns eating my margin?" "Is our discount strategy working?"
  </Card>
</CardGroup>

**Your reading order:**

<Steps>
  <Step title="What is Ocular" icon="compass">
    [Read the 5-minute orientation](/overview/what-is-ocular).
  </Step>

  <Step title="Start with the question → Profitability & Margins" icon="circle-question">
    [Every question an operator typically asks](/overview/start-with-the-question#profitability), mapped to the right module.
  </Step>

  <Step title="P&L" icon="chart-column">
    The waterfall view and channel comparison are the operator's home base. *(in Use Your Data → P\&L)*
  </Step>

  <Step title="Sales Performance" icon="cart-shopping">
    Top products, discount depth, holiday performance, new vs. repeat mix. *(in Use Your Data → Sales Performance)*
  </Step>

  <Step title="Purchase Retention Cohort" icon="repeat">
    When leadership asks about LTV, CAC payback, or acquisition vs. retention. *(in Use Your Data → Cohorts)*
  </Step>

  <Step title="FAQs → Reconciliation" icon="circle-info">
    For the moments when a number doesn't look right.
  </Step>
</Steps>

<Note>
  **Skip for now:** the breakdown-level data models and the metric/dimension dictionary. You don't need them.
</Note>

***

## <Icon icon="bullhorn" iconType="solid" /> Marketer \[#marketer]

*Growth lead, performance marketer, brand & creative*

<CardGroup cols={2}>
  <Card title="You spend your time on" icon="briefcase">
    Ad spend allocation, creative briefs, attribution, campaign performance, channel mix, retargeting.
  </Card>

  <Card title="Your typical questions" icon="circle-question">
    "Is my ad spend actually working?" "Which creatives should I brief next?" "Which campaigns are wasting budget?" "Why doesn't my Meta ROAS match Shopify?"
  </Card>
</CardGroup>

**Your reading order:**

<Steps>
  <Step title="What is Ocular" icon="compass">
    [Orientation](/overview/what-is-ocular).
  </Step>

  <Step title="Start with the question → Marketing & Creative" icon="circle-question">
    [Your most common workflows](/overview/start-with-the-question#marketing) mapped to modules.
  </Step>

  <Step title="Marketing report" icon="chart-line">
    Blended ROAS, MER, per-platform performance, demographic and dayparting heatmaps.
  </Step>

  <Step title="Ad & Campaign Performance" icon="bullseye">
    Storefront Net ROAS vs. Ad Platform ROAS, attribution model selection, bubble chart for budget decisions.
  </Step>

  <Step title="Creative Deep Dive" icon="wand-magic-sparkles">
    For creative brief prep.
  </Step>

  <Step title="Ad Tracking Setup Guide" icon="link">
    UTM, fbclid, gclid configuration. Do this once at the start of every new ad account.
  </Step>

  <Step title="Ad & Campaign Naming Convention" icon="tag">
    Make downstream reporting useful by getting names right at the source.
  </Step>

  <Step title="Attribution philosophy" icon="diagram-project">
    When you need to defend the numbers, this is why Ocular says what it says.
  </Step>
</Steps>

<Note>
  **Skip for now:** the data-model deep dives. The Marketing, Ad & Campaign Performance, and Creative Deep Dive modules surface everything you need without going to Chart Builder.
</Note>

***

## <Icon icon="database" iconType="solid" /> Data & analytics team \[#data-team]

*Analyst, data engineer, BI lead*

<CardGroup cols={2}>
  <Card title="You spend your time on" icon="briefcase">
    Custom analyses, building dashboards for the org, validating numbers against source systems, owning the team's understanding of how Ocular's semantic layer is built.
  </Card>

  <Card title="Your typical questions" icon="circle-question">
    "How does Ocular define contribution margin?" "How do I build a custom retention cohort in Chart Builder?" "Why doesn't Shopify's revenue match Ocular's net revenue?"
  </Card>
</CardGroup>

**Your reading order:**

<Steps>
  <Step title="What is Ocular + Salient features" icon="compass">
    Context. [What is Ocular](/overview/what-is-ocular) · [Salient features](/overview/salient-features).
  </Step>

  <Step title="Data modeling philosophy" icon="layer-group">
    How raw data becomes the unified semantic layer; facts, dimensions, derived metrics.
  </Step>

  <Step title="How your data flows" icon="diagram-project">
    Ingestion → cleaning → enrichment → semantic layer.
  </Step>

  <Step title="Data Dictionary" icon="book">
    The metric and dimension reference, A–Z. The single most-linked page in the docs.
  </Step>

  <Step title="Data Model deep dives" icon="cubes">
    Sales, Customer Activity, Fulfilment, Meta Ads, Google Ads. One page per model.
  </Step>

  <Step title="Common analyses" icon="flask">
    Recipes for ROAS, retention, LTV, contribution margin, return rate — built in Chart Builder.
  </Step>

  <Step title="Chart Builder" icon="wand-sparkles">
    For ad-hoc analyses and sharing the result with non-technical stakeholders.
  </Step>

  <Step title="Reconciliation FAQs" icon="scale-balanced">
    The patterns you'll get asked to explain.
  </Step>
</Steps>

<Note>
  **Skip for now:** nothing. The data team typically needs the deepest read of the docs.
</Note>

***

## Not sure where to start?

<CardGroup cols={3}>
  <Card title="Evaluating Ocular" icon="magnifying-glass" href="/overview/what-is-ocular">
    Read **What is Ocular**, **Salient features**, then skim **Start with the question** to see if your real-world questions are covered.
  </Card>

  <Card title="Implementing for the first time" icon="rocket" href="/overview/setting-up-your-workspace">
    Go to **Setting up your workspace**, then **Implementation checklist**.
  </Card>

  <Card title="Stuck on a specific issue" icon="circle-question" href="/overview/start-with-the-question">
    **Start with the question** is the fastest path. If a number doesn't match a source, jump to **FAQs → Reconciliation**.
  </Card>
</CardGroup>
