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.
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.
“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?”
Blended ROAS, MER, per-platform performance, demographic and dayparting heatmaps.
Ad & Campaign Performance
Storefront Net ROAS vs. Ad Platform ROAS, attribution model selection, bubble chart for budget decisions.
Creative Deep Dive
For creative brief prep.
Ad Tracking Setup Guide
UTM, fbclid, gclid configuration. Do this once at the start of every new ad account.
Ad & Campaign Naming Convention
Make downstream reporting useful by getting names right at the source.
Attribution philosophy
When you need to defend the numbers, this is why Ocular says what it says.
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.
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.
Your typical questions
“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?”
Read What is Ocular, Salient features, then skim Start with the question to see if your real-world questions are covered.
Implementing for the first time
Go to Setting up your workspace, then Implementation checklist.
Stuck on a specific issue
Start with the question is the fastest path. If a number doesn’t match a source, jump to FAQs → Reconciliation.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ocular","description":"Step-by-step guides for every product—platform setup, analytics, and integrations in one place.","colors":{"primary":"#E34400","light":"#FF6B33","dark":"#B83400"},"logo":{"light":"https://mintcdn.com/ocular/5e9OtNFmlhdxQdXZ/images/ocular_logo_primary.png?fit=max\u0026auto=format\u0026n=5e9OtNFmlhdxQdXZ\u0026q=85\u0026s=5d162ce47c03edf182cc50de242007d0","dark":"https://mintcdn.com/ocular/5e9OtNFmlhdxQdXZ/images/ocular_logo_secondary.svg?fit=max\u0026auto=format\u0026n=5e9OtNFmlhdxQdXZ\u0026q=85\u0026s=28208f4e1b7ad51a7b5d558b44241fcb"},"favicon":{"light":"https://mintcdn.com/ocular/d11hcEgDLXJHAiK9/images/favicon.png?fit=max\u0026auto=format\u0026n=d11hcEgDLXJHAiK9\u0026q=85\u0026s=2fba4ee1bcf53a5b1c1abeb95d465e27","dark":"https://mintcdn.com/ocular/d11hcEgDLXJHAiK9/images/favicon.png?fit=max\u0026auto=format\u0026n=d11hcEgDLXJHAiK9\u0026q=85\u0026s=2fba4ee1bcf53a5b1c1abeb95d465e27"},"appearance":{"default":"light","strict":false},"background":{"decoration":"gradient"},"navbar":{"links":[],"primary":{"type":"button","label":"Get started","href":"https://ocular.dev/get-started"}},"footer":{"socials":{"x":"https://x.com/yourcompany","linkedin":"https://linkedin.com/company/yourcompany"}},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"section","latex":false},"contextual":{"options":["copy","view","assistant","mcp","add-mcp"],"display":"header"},"navigation":{"directory":"card","pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ocular","hasAudioNarration":false,"actualSubdomain":"ocular","customDomains":["docs.ocular.dev"],"gitSource":{"type":"github","owner":"shubham-fornax","repo":"docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6accc6e5965aa326a0240b8b","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Overview","count":40},{"language":"default","tag":"Connectors","count":21},{"language":"default","tag":"Data Models","count":20},{"language":"default","tag":"Data models","count":20},{"language":"default","tag":"Brand Data","count":12},{"language":"default","tag":"Product","count":10},{"language":"default","tag":"Integrations","count":9},{"language":"default","tag":"Google Ads","count":8},{"language":"default","tag":"Start with the question","count":8},{"language":"default","tag":"Meta Ads","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--default-border-color: var(--gray-200)}.dark{--default-border-color: var(--gray-800)}#sidebar .nav-dropdown-trigger{border:none!important;background:transparent!important;box-shadow:none!important;padding-left:0.375rem}#sidebar .nav-dropdown-trigger:hover{background-color:rgb(0 0 0 / 0.04)!important}.dark #sidebar .nav-dropdown-trigger:hover{background-color:rgb(255 255 255 / 0.06)!important}#sidebar .nav-dropdown-trigger .nav-dropdown-item-icon{border:none!important;background:transparent!important;height:auto!important;width:auto!important;padding:0!important}.nav-dropdown-content{}.nav-dropdown-content .nav-dropdown-item{}.nav-dropdown-content .nav-dropdown-item-icon{border:none!important;background:transparent!important;height:auto!important;width:auto!important;padding:0!important}.nav-dropdown-content .nav-dropdown-item-description{display:none!important}#sidebar .nav-anchor span{font-family:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;font-size:12px;font-weight:500;letter-spacing:-0.02em;text-transform:uppercase}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"]{color:rgb(var(--primary))!important;font-weight:600!important}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"] span{color:inherit!important}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"] svg{background-color:rgb(var(--primary))!important}.dark body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"]{color:rgb(var(--primary-light)/var(--tw-text-opacity,1))!important}.dark body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"] svg{background-color:rgb(var(--primary-light)/var(--tw-text-opacity,1))!important}:is(#content-area[data-current-path=\"/\"],[data-current-path=\"/\"] #content-area):has([data-product-guide-index]){background:transparent!important;padding:0!important}:is(#content-area[data-current-path=\"/\"],[data-current-path=\"/\"] #content-area):has([data-product-guide-index])>div:first-child{background:transparent!important;padding-right:0!important;padding-bottom:0!important;padding-left:0!important}[data-product-guide-index] a:not(.product-guide-feature-card){background-color:#fafafa!important}.dark [data-product-guide-index] a:not(.product-guide-feature-card){background-color:#09090b!important}.product-guide-feature-card{grid-column:1 / -1;display:flex!important;flex-direction:column!important;justify-content:space-between!important;min-height:260px;background:url('/images/sample-feature-light.png') center / cover no-repeat!important;border:none!important;box-shadow:none!important;color:white!important;.dark \u0026 {\n background-image: url('/images/sample-feature-dark.png') !important;\n }}.product-guide-feature-card>div{display:flex!important;flex:1;flex-direction:column!important;justify-content:space-between!important}.product-guide-feature-card :is(h2,h3,p,span,svg){color:white!important}.product-guide-feature-card :is(svg,[class*=\"icon\"]){background-color:white!important;width:2em!important;height:2em!important;margin-top:2px}.product-guide-feature-card-title{font-size:1.2em;font-weight:500}.product-guide-feature-card :is(h2,h3,p,span,svg).product-guide-feature-card-description{font-size:1.05em;font-weight:400;color:rgb(var(--gray-50) / 62.5%)!important;.dark \u0026 {\n color: rgb(var(--gray-50) / 50%) !important;\n }}img.nav-logo{max-width:220px;height:auto}"}],"page":{"pagePath":"overview/choose-your-path","slug":"/overview/choose-your-path","pageMetadata":{"title":"Choose your path","description":"A persona-routed reading order for the Ocular docs — pick the role closest to yours (founder, marketer, analyst, ops) and follow the curated path.","icon":"signs-post","href":"/overview/choose-your-path"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"A persona-routed reading order for the Ocular docs — pick the role closest to yours (founder, marketer, analyst, ops) and follow the curated path.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,em:`em`,hr:`hr`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Card,CardGroup,Heading,Icon,Note,Step,Steps,Tip}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Icon)_missingMdxReference(`Icon`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`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.`})}),`\n`,_jsxs(CardGroup,{cols:3,children:[_jsx(Card,{title:`Operator`,icon:`bag-shopping`,href:`#operator`,children:_jsx(_components.p,{children:`Founders, CXOs, heads of ecommerce, GMs`})}),_jsx(Card,{title:`Marketer`,icon:`bullhorn`,href:`#marketer`,children:_jsx(_components.p,{children:`Growth leads, performance marketers, brand \u0026 creative`})}),_jsx(Card,{title:`Data \u0026 analytics`,icon:`database`,href:`#data-team`,children:_jsx(_components.p,{children:`Analysts, data engineers, BI leads`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(Heading,{level:`2`,id:`operator-#operator`,children:[_jsx(Icon,{icon:`bag-shopping`,iconType:`solid`}),` Operator [#operator]`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.em,{children:`Founder, CXO, head of ecommerce, GM`})}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`You spend your time on`,icon:`briefcase`,children:_jsx(_components.p,{children:`The P\u0026L, channel-level profitability, inventory, pricing strategy, vendor and marketplace negotiations.`})}),_jsx(Card,{title:`Your typical questions`,icon:`circle-question`,children:_jsx(_components.p,{children:`“What’s my true contribution margin this month?” “Which channel is actually profitable?” “Are returns eating my margin?” “Is our discount strategy working?”`})})]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Your reading order:`})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`What is Ocular`,icon:`compass`,children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/overview/what-is-ocular`,children:`Read the 5-minute orientation`}),`.`]})}),_jsx(Step,{title:`Start with the question → Profitability \u0026 Margins`,icon:`circle-question`,children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/overview/start-with-the-question#profitability`,children:`Every question an operator typically asks`}),`, mapped to the right module.`]})}),_jsx(Step,{title:`P\u0026L`,icon:`chart-column`,children:_jsxs(_components.p,{children:[`The waterfall view and channel comparison are the operator’s home base. `,_jsx(_components.em,{children:`(in Use Your Data → P\u0026L)`})]})}),_jsx(Step,{title:`Sales Performance`,icon:`cart-shopping`,children:_jsxs(_components.p,{children:[`Top products, discount depth, holiday performance, new vs. repeat mix. `,_jsx(_components.em,{children:`(in Use Your Data → Sales Performance)`})]})}),_jsx(Step,{title:`Purchase Retention Cohort`,icon:`repeat`,children:_jsxs(_components.p,{children:[`When leadership asks about LTV, CAC payback, or acquisition vs. retention. `,_jsx(_components.em,{children:`(in Use Your Data → Cohorts)`})]})}),_jsx(Step,{title:`FAQs → Reconciliation`,icon:`circle-info`,children:_jsx(_components.p,{children:`For the moments when a number doesn’t look right.`})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Skip for now:`}),` the breakdown-level data models and the metric/dimension dictionary. You don’t need them.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(Heading,{level:`2`,id:`marketer-#marketer`,children:[_jsx(Icon,{icon:`bullhorn`,iconType:`solid`}),` Marketer [#marketer]`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.em,{children:`Growth lead, performance marketer, brand \u0026 creative`})}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`You spend your time on`,icon:`briefcase`,children:_jsx(_components.p,{children:`Ad spend allocation, creative briefs, attribution, campaign performance, channel mix, retargeting.`})}),_jsx(Card,{title:`Your typical questions`,icon:`circle-question`,children:_jsx(_components.p,{children:`“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?”`})})]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Your reading order:`})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`What is Ocular`,icon:`compass`,children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/overview/what-is-ocular`,children:`Orientation`}),`.`]})}),_jsx(Step,{title:`Start with the question → Marketing \u0026 Creative`,icon:`circle-question`,children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/overview/start-with-the-question#marketing`,children:`Your most common workflows`}),` mapped to modules.`]})}),_jsx(Step,{title:`Marketing report`,icon:`chart-line`,children:_jsx(_components.p,{children:`Blended ROAS, MER, per-platform performance, demographic and dayparting heatmaps.`})}),_jsx(Step,{title:`Ad \u0026 Campaign Performance`,icon:`bullseye`,children:_jsx(_components.p,{children:`Storefront Net ROAS vs. Ad Platform ROAS, attribution model selection, bubble chart for budget decisions.`})}),_jsx(Step,{title:`Creative Deep Dive`,icon:`wand-magic-sparkles`,children:_jsx(_components.p,{children:`For creative brief prep.`})}),_jsx(Step,{title:`Ad Tracking Setup Guide`,icon:`link`,children:_jsx(_components.p,{children:`UTM, fbclid, gclid configuration. Do this once at the start of every new ad account.`})}),_jsx(Step,{title:`Ad \u0026 Campaign Naming Convention`,icon:`tag`,children:_jsx(_components.p,{children:`Make downstream reporting useful by getting names right at the source.`})}),_jsx(Step,{title:`Attribution philosophy`,icon:`diagram-project`,children:_jsx(_components.p,{children:`When you need to defend the numbers, this is why Ocular says what it says.`})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Skip for now:`}),` the data-model deep dives. The Marketing, Ad \u0026 Campaign Performance, and Creative Deep Dive modules surface everything you need without going to Chart Builder.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(Heading,{level:`2`,id:`data-\u0026-analytics-team-#data-team`,children:[_jsx(Icon,{icon:`database`,iconType:`solid`}),` Data \u0026 analytics team [#data-team]`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.em,{children:`Analyst, data engineer, BI lead`})}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`You spend your time on`,icon:`briefcase`,children:_jsx(_components.p,{children:`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.`})}),_jsx(Card,{title:`Your typical questions`,icon:`circle-question`,children:_jsx(_components.p,{children:`“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?”`})})]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Your reading order:`})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`What is Ocular + Salient features`,icon:`compass`,children:_jsxs(_components.p,{children:[`Context. `,_jsx(_components.a,{href:`/overview/what-is-ocular`,children:`What is Ocular`}),` · `,_jsx(_components.a,{href:`/overview/salient-features`,children:`Salient features`}),`.`]})}),_jsx(Step,{title:`Data modeling philosophy`,icon:`layer-group`,children:_jsx(_components.p,{children:`How raw data becomes the unified semantic layer; facts, dimensions, derived metrics.`})}),_jsx(Step,{title:`How your data flows`,icon:`diagram-project`,children:_jsx(_components.p,{children:`Ingestion → cleaning → enrichment → semantic layer.`})}),_jsx(Step,{title:`Data Dictionary`,icon:`book`,children:_jsx(_components.p,{children:`The metric and dimension reference, A–Z. The single most-linked page in the docs.`})}),_jsx(Step,{title:`Data Model deep dives`,icon:`cubes`,children:_jsx(_components.p,{children:`Sales, Customer Activity, Fulfilment, Meta Ads, Google Ads. One page per model.`})}),_jsx(Step,{title:`Common analyses`,icon:`flask`,children:_jsx(_components.p,{children:`Recipes for ROAS, retention, LTV, contribution margin, return rate — built in Chart Builder.`})}),_jsx(Step,{title:`Chart Builder`,icon:`wand-sparkles`,children:_jsx(_components.p,{children:`For ad-hoc analyses and sharing the result with non-technical stakeholders.`})}),_jsx(Step,{title:`Reconciliation FAQs`,icon:`scale-balanced`,children:_jsx(_components.p,{children:`The patterns you’ll get asked to explain.`})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Skip for now:`}),` nothing. The data team typically needs the deepest read of the docs.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`not-sure-where-to-start`,children:`Not sure where to start?`}),`\n`,_jsxs(CardGroup,{cols:3,children:[_jsx(Card,{title:`Evaluating Ocular`,icon:`magnifying-glass`,href:`/overview/what-is-ocular`,children:_jsxs(_components.p,{children:[`Read `,_jsx(_components.strong,{children:`What is Ocular`}),`, `,_jsx(_components.strong,{children:`Salient features`}),`, then skim `,_jsx(_components.strong,{children:`Start with the question`}),` to see if your real-world questions are covered.`]})}),_jsx(Card,{title:`Implementing for the first time`,icon:`rocket`,href:`/overview/setting-up-your-workspace`,children:_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Setting up your workspace`}),`, then `,_jsx(_components.strong,{children:`Implementation checklist`}),`.`]})}),_jsx(Card,{title:`Stuck on a specific issue`,icon:`circle-question`,href:`/overview/start-with-the-question`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Start with the question`}),` is the fastest path. If a number doesn’t match a source, jump to `,_jsx(_components.strong,{children:`FAQs → Reconciliation`}),`.`]})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Choose your path","description":"A persona-routed reading order for the Ocular docs — pick the role closest to yours (founder, marketer, analyst, ops) and follow the curated path.","icon":"signs-post","href":"/overview/choose-your-path"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":" Operator [#operator]","slug":"operator-#operator","depth":2,"children":[]},{"title":" Marketer [#marketer]","slug":"marketer-#marketer","depth":2,"children":[]},{"title":" Data \u0026 analytics team [#data-team]","slug":"data-\u0026-analytics-team-#data-team","depth":2,"children":[]},{"title":"Not sure where to start?","slug":"not-sure-where-to-start","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"ocular","siteName":"Ocular","title":"Choose your path - Ocular","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-18T19:13:45.221Z","originalFileLocation":"overview/choose-your-path.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"A persona-routed reading order for the Ocular docs — pick the role closest to yours (founder, marketer, analyst, ops) and follow the curated path.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ocular\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ocular/tqVQ9c7zY2A9-Cau/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ocular/tqVQ9c7zY2A9-Cau/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ocular/tqVQ9c7zY2A9-Cau/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ocular/tqVQ9c7zY2A9-Cau/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ocular/tqVQ9c7zY2A9-Cau/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ocular/tqVQ9c7zY2A9-Cau/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ocular/tqVQ9c7zY2A9-Cau/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ocular/tqVQ9c7zY2A9-Cau/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ocular/tqVQ9c7zY2A9-Cau/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Choose your path - Ocular\">\u003cmeta data-mint-head property=\"og:description\" content=\"A persona-routed reading order for the Ocular docs — pick the role closest to yours (founder, marketer, analyst, ops) and follow the curated path.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ocular\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ocular.dev/overview/choose-your-path\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ocular.mintlify.site/_mintlify/api/og/v2?division=Product\u0026amp;title=Choose+your+path\u0026amp;description=A+persona-routed+reading+order+for+the+Ocular+docs+%E2%80%94+pick+the+role+closest+to+yours+%28founder%2C+marketer%2C+analyst%2C+ops%29+and+follow+the+curated+path.\u0026amp;theme=0e90187cfa55a43c122cb5db\u0026amp;signature=077bc06cc1387f1405322b73e56ee0d3e4da0e2a04c5daba570956e2fc98e9ec\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Choose your path - Ocular\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"A persona-routed reading order for the Ocular docs — pick the role closest to yours (founder, marketer, analyst, ops) and follow the curated path.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ocular.mintlify.site/_mintlify/api/og/v2?division=Product\u0026amp;title=Choose+your+path\u0026amp;description=A+persona-routed+reading+order+for+the+Ocular+docs+%E2%80%94+pick+the+role+closest+to+yours+%28founder%2C+marketer%2C+analyst%2C+ops%29+and+follow+the+curated+path.\u0026amp;theme=0e90187cfa55a43c122cb5db\u0026amp;signature=077bc06cc1387f1405322b73e56ee0d3e4da0e2a04c5daba570956e2fc98e9ec\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ocular/tqVQ9c7zY2A9-Cau/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ocular\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E34400\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ocular.dev/overview/choose-your-path\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/overview/choose-your-path.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ocular.dev/#organization\",\"name\":\"Ocular\",\"url\":\"https://docs.ocular.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ocular/5e9OtNFmlhdxQdXZ/images/ocular_logo_primary.png?fit=max\u0026auto=format\u0026n=5e9OtNFmlhdxQdXZ\u0026q=85\u0026s=5d162ce47c03edf182cc50de242007d0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ocular.dev#website\",\"name\":\"Ocular\",\"url\":\"https://docs.ocular.dev\",\"publisher\":{\"@id\":\"https://docs.ocular.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ocular.dev/overview/choose-your-path#webpage\",\"url\":\"https://docs.ocular.dev/overview/choose-your-path\",\"name\":\"Choose your path\",\"description\":\"A persona-routed reading order for the Ocular docs — pick the role closest to yours (founder, marketer, analyst, ops) and follow the curated path.\",\"dateModified\":\"2026-05-18T19:13:45.221Z\",\"isPartOf\":{\"@id\":\"https://docs.ocular.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ocular.dev/overview/choose-your-path#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ocular.dev/overview/choose-your-path#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Product\",\"item\":\"https://docs.ocular.dev/overview/salient-features\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Choose your path\",\"item\":\"https://docs.ocular.dev/overview/choose-your-path\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ocular.dev/overview/choose-your-path#article\",\"headline\":\"Choose your path\",\"name\":\"Choose your path\",\"description\":\"A persona-routed reading order for the Ocular docs — pick the role closest to yours (founder, marketer, analyst, ops) and follow the curated path.\",\"url\":\"https://docs.ocular.dev/overview/choose-your-path\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ocular.dev/overview/choose-your-path#webpage\"},\"dateModified\":\"2026-05-18T19:13:45.221Z\",\"publisher\":{\"@id\":\"https://docs.ocular.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ocular.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ocular\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ocular\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/overview/choose-your-path.md","siteName":"Ocular","nav":{"global":null,"directory":"card","tabs":[{"tab":"Overview","groups":[{"group":"Getting Started","icon":"rocket","pages":[{"title":"Start here to explore Ocular","sidebarTitle":"Home","icon":"house","href":"/overview"},{"title":"What is Ocular","sidebarTitle":"What is Ocular","icon":"compass","href":"/overview/what-is-ocular"},{"title":"Setting up your workspace","icon":"rocket","href":"/overview/setting-up-your-workspace"},{"group":"Implementation checklist","icon":"list-check","pages":[{"title":"D2C","sidebarTitle":"D2C","icon":"store","href":"/overview/implementation-checklist/d2c"},{"title":"Quick commerce","sidebarTitle":"Quick commerce","icon":"bolt","href":"/overview/implementation-checklist/quick-commerce"},{"title":"Horizontal Marketplaces","sidebarTitle":"Horizontal Marketplaces","icon":"shop","href":"/overview/implementation-checklist/vertical-marketplaces"},{"title":"Vertical marketplaces","sidebarTitle":"Vertical marketplaces","icon":"bag-shopping","href":"/overview/implementation-checklist/horizontal-marketplaces"}]}]},{"group":"Product","icon":"sparkles","pages":[{"title":"Salient features","description":"The capabilities that set Ocular apart from generic BI tools — purpose-built data models, prebuilt reports, and operator workflows for multi-channel commerce.","icon":"sparkles","href":"/overview/salient-features"},{"title":"Choose your path","icon":"signs-post","href":"/overview/choose-your-path"},{"group":"Start with the question","icon":"circle-question","pages":[{"title":"Start with the question","description":"A question-led entry point to Ocular — triggers, modules, and decisions that start from what happened in your business and route you to the right report.","icon":"circle-question","sidebarTitle":"Start with the question","href":"/overview/start-with-the-question"},{"title":"Profitability \u0026 margins","icon":"chart-pie","sidebarTitle":"Profitability \u0026 margins","href":"/overview/start-with-the-question/profitability-and-margins"},{"title":"Marketing \u0026 ad spend","icon":"bullhorn","sidebarTitle":"Marketing \u0026 ad spend","href":"/overview/start-with-the-question/marketing-and-ad-spend"},{"title":"Creative performance","icon":"wand-magic-sparkles","sidebarTitle":"Creative performance","href":"/overview/start-with-the-question/creative-performance"},{"title":"Products, returns \u0026 discounts","icon":"box-open","sidebarTitle":"Products, returns \u0026 discounts","href":"/overview/start-with-the-question/products-returns-and-discounts"},{"title":"Customers \u0026 retention","icon":"users","sidebarTitle":"Customers \u0026 retention","href":"/overview/start-with-the-question/customers-and-retention"},{"title":"Fulfilment \u0026 logistics","icon":"truck","sidebarTitle":"Fulfilment \u0026 logistics","href":"/overview/start-with-the-question/fulfilment-and-logistics"},{"title":"Custom analysis","icon":"wand-sparkles","sidebarTitle":"Custom analysis","href":"/overview/start-with-the-question/custom-analysis"}]}]},{"group":"Admin \u0026 support","icon":"user-shield","pages":[{"title":"Settings \u0026 permissions","icon":"user-gear","href":"/overview/settings-and-permissions"},{"title":"Working with the Ocular team","icon":"headset","href":"/overview/working-with-the-ocular-team"}]}]},{"tab":"Connectors","pages":[{"title":"Connectors","href":"/connectors/shopify"}]},{"tab":"Data Models","pages":[{"title":"Data Models","href":"/data-models/overview"}]},{"tab":"Features","pages":[{"title":"Features","href":"/features/cohorts/user-activity"}]}]},"basePath":"","title":"Choose your path - Ocular","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":[],"chunks":[]}