Skip to main content

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.

The Ocular team is hands-on with every customer. This page tells you how to reach us, what kind of response to expect, and how to write the kind of request that we can act on immediately.

How to reach us

In-app chat

Bottom-right Help button. Quick questions, where do I find X, small bugs.Response: same business day.

Shared Slack channel

Enterprise customers — ongoing operational questions, data anomalies, implementation help.Response: within 1 business hour.

Email

support@ocular.dev — anything you cannot put in chat (attachments, longer context, multiple stakeholders).Response: same business day.

Office hours

Every Thursday — implementation reviews, data team sync, roadmap input.Book via the in-app calendar.
Business hours: IST 9 AM to 7 PM, Monday through Friday. For urgent issues outside hours, mark a Slack message with :rotating_light: or email with [URGENT] subject prefix — on-call responds within an hour.

What to include in a request

The single biggest determinant of how fast we can resolve a request is how completely you describe it.
  1. The number — what specifically looks wrong. Be precise: Yesterday’s Storefront Net ROAS on the Meta campaign Prospecting_v3 shows 1.2, but Meta Ads Manager shows 3.4.
  2. Where you are seeing it — which report, which filter set, which date range. Screenshot helps.
  3. What you compared it to — the source-system value and a screenshot of that too if possible.
  4. When it started — was this always off, or did it change recently?
  5. The scope — one campaign? All campaigns? All of Meta? Narrower scope = faster diagnosis.
Before filing a reconciliation ticket, check FAQs → Reconciliation . Roughly 70% of these have a standard explanation (attribution windows, view-through conversions, refund timing, gift-card treatment).
  1. Which source — be specific about the platform version (e.g. Shopify Plus, Blinkit PartnersBiz, Meta Ads Manager — single account).
  2. What happened during the OAuth flow — failed at auth, succeeded but no data, or synced and then stopped?
  3. Any error message — copy-paste the exact text, plus a screenshot.
  4. What permissions you have on the source — Admin, View-only, etc. Many connector issues are permission gaps invisible in the OAuth UI.
  5. The historical start date you configured.
  1. The business question you are trying to answer, not just the feature you think will answer it. Which acquisition channel produces customers who pay back their CAC fastest is easier to help with than How do I use the Purchase Retention Cohort?
  2. What you have tried so far — even if it did not work. Tells us where the docs are unclear.
  3. The output format you need — one-time number, exportable CSV, or recurring dashboard?
  1. The use case — what you are trying to accomplish that Ocular does not currently support.
  2. The workaround you are using — Excel? A different tool? Internal SQL? Tells us how painful the gap actually is.
  3. The frequency — daily / weekly / monthly / one-time. Helps us prioritize.
Feature requests go into our roadmap intake. We discuss in monthly office hours, and any item with three or more customer requests gets a yes / no / when answer within 30 days.

What to expect from response times

Critical incidents

Platform down, all dashboards broken, data loss — investigation within 15 minutes, updates every 30 minutes until resolved.

Connector failures

Investigation same business day. Most restored within 24 hours; some require source-platform cooperation.

Data anomalies

Root-cause investigation within 2 business days, written explanation always.

Implementation requests

Same-day reply with a time estimate or scoping questions.

Feature requests

Same-day acknowledgement, roadmap discussion within 30 days.

Escalation path

If a ticket is not moving the way you expect:

Reply in-thread and tag your CSM

Most stuck tickets are stuck because they are waiting on a question we asked that you have not seen yet.

Email support with [ESCALATION]

If your CSM is unavailable, email support@ocular.dev with [ESCALATION] in the subject line.

Email your account executive

For commercial/strategic issues (pricing, contract changes, executive escalation).

Things we can help with that aren’t in the docs

Custom connector requests

Onboarding a data source we do not have a self-serve integration for — we have an internal team that builds custom connectors.

Historical backfills

Backfilling historical data past your original start date. If you set the wrong start date six months ago, we can usually re-ingest further back.

Custom modeling work

Custom metrics, dimensions, or reports that do not exist out of the box. Some lands in product; some is workspace-scoped.

Migration from a competitor

We have moved customers off Glew, Polar Analytics, Lifetimely, Northbeam, Triple Whale, and home-grown stacks.

Pre-sales technical deep-dives

For stakeholders inside your company evaluating Ocular. On-demand and free.

Things we can’t (or won’t) do

Build every dashboard for you

We help once or twice during onboarding, but Chart Builder + Dashboards is designed to be self-serve.

Re-architect your storefront

If Shopify/marketplace config makes attribution unreliable, we will guide the fix but not do it.

Override the underlying data

If a source reports a number and Ocular ingests it correctly, we will not manually edit the semantic layer.

Where to go next

Settings & permissions

Self-serve administrative changes.