# Ocular

> Step-by-step guides for every product—platform setup, analytics, and integrations in one place.

## Docs

- [Agency & Miscellaneous Costs](https://docs.ocular.dev/brand-data/agency-and-miscellaneous-costs.md): Log agency retainers, tooling, and other miscellaneous costs so they roll into the P&L alongside media spend.
- [Branding & Offline Media Spends](https://docs.ocular.dev/brand-data/branding-and-offline-media-spends.md): Capture offline and non-tracked marketing investments — TV, OOH, print, sponsorships — so they show up in your spend and P&L views.
- [Channel Listing](https://docs.ocular.dev/brand-data/channel-listing.md): Tell Ocular which SKUs are live on which sales channels so availability and channel-mix views reflect what's actually for sale.
- [Discount Code Mapping](https://docs.ocular.dev/brand-data/discount-code-mapping.md): Map promo codes to the campaigns and creators they belong to so discounts attribute cleanly across marketing reports.
- [Events Mapping](https://docs.ocular.dev/brand-data/events-mapping.md): Upload your calendar of business events and promotional campaigns so Ocular can attribute spikes and dips to the right driver.
- [Influencer Mapping](https://docs.ocular.dev/brand-data/influencer-mapping.md): Register your creator partnerships — deal terms, codes, and fees — so Ocular can compute influencer ROI end to end.
- [Marketing Budget](https://docs.ocular.dev/brand-data/marketing-budget.md): Upload your marketing spend targets so Ocular can track plan-vs-actual performance across channels.
- [Marketplace Fees](https://docs.ocular.dev/brand-data/marketplace-fees.md): Provide each marketplace's commission, payment, and platform-fee structure so net revenue and contribution margin land accurately.
- [Revenue Plan](https://docs.ocular.dev/brand-data/revenue-plan.md): Share your business targets and projections so Ocular can track actuals against plan on every revenue view.
- [Shipping & Fulfilment Costs](https://docs.ocular.dev/brand-data/shipping-and-fulfilment-costs.md): Provide your courier and warehousing cost rules so logistics expense rolls into per-order and per-channel profitability.
- [SKU Costs](https://docs.ocular.dev/brand-data/sku-costs.md): Share per-SKU landed cost so Ocular can compute gross margin, contribution margin, and true profitability by product.
- [SKU Hierarchy](https://docs.ocular.dev/brand-data/sku-hierarchy.md): Define how SKUs roll up into categories, brands, and product attributes so reporting can slice by the dimensions you actually plan against.
- [Blinkit](https://docs.ocular.dev/connectors/blinkit.md): Pull Blinkit seller and ads reporting into Ocular. Onboarding is handled by your Ocular CSM.
- [Facebook Ads](https://docs.ocular.dev/connectors/facebook-ads.md): Connect Facebook Ads via OAuth — fully automated with token refresh handled by Ocular.
- [GoKwik](https://docs.ocular.dev/connectors/gokwik.md): Connect GoKwik using Base URL, App ID, and App Secret from your merchant dashboard.
- [Google Ads](https://docs.ocular.dev/connectors/google-ads.md): Connect Google Ads via OAuth — sign in once with an Admin user; tokens managed for you.
- [Google Analytics 4](https://docs.ocular.dev/connectors/google-analytics-4.md): Connect GA4 via the BigQuery export with a service account.
- [Instamart](https://docs.ocular.dev/connectors/instamart.md): Pull Swiggy Instamart seller and ads reporting into Ocular. Onboarding is handled by your Ocular CSM.
- [Return Prime](https://docs.ocular.dev/connectors/return-prime.md): Connect Return Prime using an App Access Token from a Return Prime custom app.
- [Shiprocket](https://docs.ocular.dev/connectors/shiprocket.md): Connect Shiprocket using a dedicated API user email and the API key emailed to that user.
- [Shopify](https://docs.ocular.dev/connectors/shopify.md): Connect Shopify using Shop ID and an Admin API access token.
- [Unicommerce](https://docs.ocular.dev/connectors/unicommerce.md): Connect Uniware with username, password, account code, and selected facility codes.
- [Zepto](https://docs.ocular.dev/connectors/zepto.md): Pull Zepto seller and ads reporting into Ocular. Onboarding is handled by your Ocular CSM.
- [Customer Activity](https://docs.ocular.dev/data-models/customer-activity.md): Website and app analytics — sessions, page views, traffic sources, conversion funnel, and user engagement across digital touchpoints.
- [Fulfilment](https://docs.ocular.dev/data-models/fulfilment.md): Shipment and logistics analytics — delivery performance, RTOs, courier efficiency, TAT breaches, weight & cost discrepancies, and the full pickup-to-delivery lifecycle.
- [Age](https://docs.ocular.dev/data-models/google-ads/age.md): Google Ads performance by inferred age range — for budget allocation, bid modifiers, and generation-targeted creative.
- [Conversion Action](https://docs.ocular.dev/data-models/google-ads/conversion-action.md): Full funnel stages — View Page through Conversion — at ad-level granularity. The only Google Ads data model with funnel metrics and per-stage drop-off rates.
- [Device](https://docs.ocular.dev/data-models/google-ads/device.md): Google Ads performance by device and ad network — the richest breakdown, and the only one with cross-device conversion value and ad-level granularity.
- [Gender](https://docs.ocular.dev/data-models/google-ads/gender.md): Google Ads performance by inferred gender — for cohort-level budget allocation and creative.
- [Geo](https://docs.ocular.dev/data-models/google-ads/geo.md): Google Ads performance by geography — for market prioritization, geographic expansion, and location-based bidding.
- [Overview](https://docs.ocular.dev/data-models/google-ads/overview.md): Seven Google Ads data models, common dimensions, and a master metric availability matrix.
- [Placement](https://docs.ocular.dev/data-models/google-ads/placement.md): Google Ads performance by where the ad appeared — websites, mobile apps, YouTube channels, and YouTube videos. Use it to build exclusion lists and managed placements.
- [Search Term](https://docs.ocular.dev/data-models/google-ads/search-term.md): What users actually typed when your ad showed — for negative-keyword discovery, match-type optimization, and budget-waste elimination.
- [Age & Gender](https://docs.ocular.dev/data-models/meta-ads/age-and-gender.md): Meta Ads performance by demographic cohort — slice by age segment and gender.
- [Asset Breakdowns](https://docs.ocular.dev/data-models/meta-ads/asset-breakdowns.md): Six data models for creative testing — body copy, headline, description, image, video, or full creative.
- [Hourly Audience](https://docs.ocular.dev/data-models/meta-ads/hourly-audience.md): Meta Ads performance by hour of day and day of week — for dayparting analysis.
- [Overview](https://docs.ocular.dev/data-models/meta-ads/overview.md): Six Meta Ads data models, common dimensions, and a master metric availability matrix.
- [Platform & Device](https://docs.ocular.dev/data-models/meta-ads/platform-and-device.md): Meta Ads performance across platforms, placements, and devices — the richest breakdown for cross-channel analysis.
- [Product](https://docs.ocular.dev/data-models/meta-ads/product.md): Meta Ads performance by product SKU — for catalog and dynamic product ad optimization.
- [Region](https://docs.ocular.dev/data-models/meta-ads/region.md): Meta Ads performance by geography — for budget allocation, market expansion, and creative localization.
- [Overview](https://docs.ocular.dev/data-models/overview.md): How Ocular's data models are organized, and the building blocks you'll work with when querying.
- [Quick Commerce](https://docs.ocular.dev/data-models/quick-commerce.md): Order and performance data for Blinkit, Zepto, Instamart, and other quick-commerce platforms
- [Sales](https://docs.ocular.dev/data-models/sales.md): Order-level e-commerce performance — gross & net revenue, AOV, returns, discounts, customer mix, and per-channel sales.
- [Purchase Retention Cohort](https://docs.ocular.dev/features/cohorts/purchase-retention.md): Track how customers come back and keep buying — repeat purchase rate, LTV per cohort, CAC payback, and split-by acquisition channel, discount code, or geography.
- [User Activity Cohort](https://docs.ocular.dev/features/cohorts/user-activity.md): Group users by a Start Event and track whether they return — retention curves, churn intervals, and engagement by acquisition channel, device, or geography.
- [Home](https://docs.ocular.dev/overview.md)
- [Choose your path](https://docs.ocular.dev/overview/choose-your-path.md): A persona-routed reading order. Pick the role closest to yours and follow the curated path through the docs.
- [D2C](https://docs.ocular.dev/overview/implementation-checklist/d2c.md): D2C implementation: Level 1 (revenue and marketing foundation), Level 2 (operations and profitability), Level 3 (custom inputs).
- [Vertical marketplaces](https://docs.ocular.dev/overview/implementation-checklist/horizontal-marketplaces.md): Vertical marketplaces — Myntra, Ajio, Nykaa connectors are coming soon.
- [Quick commerce](https://docs.ocular.dev/overview/implementation-checklist/quick-commerce.md): Quick commerce implementation: Level 1 (connect Blinkit, Zepto, Instamart) and Level 2 (competitor intelligence and availability).
- [Horizontal Marketplaces](https://docs.ocular.dev/overview/implementation-checklist/vertical-marketplaces.md): Horizontal Marketplaces — Amazon and Flipkart connectors are coming soon.
- [Salient features](https://docs.ocular.dev/overview/salient-features.md): The capabilities that set Ocular apart from generic BI tools — purpose-built for multi-channel commerce.
- [Setting up your workspace](https://docs.ocular.dev/overview/setting-up-your-workspace.md): A three-step setup that takes you from creating a brand to seeing your first dashboards populate. Total time — about 20 minutes of configuration, plus 24–48 hours for the initial historical data load.
- [Settings & permissions](https://docs.ocular.dev/overview/settings-and-permissions.md): Users, groups, and roles. Everything you need to administer Ocular for a team.
- [Start with the question](https://docs.ocular.dev/overview/start-with-the-question.md): Triggers, modules, and decisions — start from what happened and route to the answer.
- [Creative performance](https://docs.ocular.dev/overview/start-with-the-question/creative-performance.md): Triggers for creative briefs grounded in performance — title, body, asset, format, placement, and search terms.
- [Custom analysis](https://docs.ocular.dev/overview/start-with-the-question/custom-analysis.md): When the question doesn't fit a pre-built report — Chart Builder and Dashboards.
- [Customers & retention](https://docs.ocular.dev/overview/start-with-the-question/customers-and-retention.md): Triggers for cohort analysis, CAC payback, LTV, and repeat purchase behaviour.
- [Fulfilment & logistics](https://docs.ocular.dev/overview/start-with-the-question/fulfilment-and-logistics.md): Triggers for courier performance, RTO rates, billing discrepancies, and return reasons.
- [Marketing & ad spend](https://docs.ocular.dev/overview/start-with-the-question/marketing-and-ad-spend.md): Triggers for platform-vs-storefront ROAS, demographics, dayparting, and geo performance.
- [Products, returns & discounts](https://docs.ocular.dev/overview/start-with-the-question/products-returns-and-discounts.md): Triggers for return rates, discount depth, product trends, and AOV.
- [Profitability & margins](https://docs.ocular.dev/overview/start-with-the-question/profitability-and-margins.md): Triggers for true profit, channel margin, and marketing efficiency.
- [What is Ocular](https://docs.ocular.dev/overview/what-is-ocular.md)
- [Working with the Ocular team](https://docs.ocular.dev/overview/working-with-the-ocular-team.md): How to reach support, what to expect from response times, and how to file a ticket that gets resolved fast.