Documentation
Nohmo is product analytics and error monitoring in one SDK, for web, mobile and your backend. Setup guides are grouped by where you are installing it — Web, Mobile or Backend. Start with the quick start — it takes a few minutes — or jump straight to what you need below.
Getting started
- Quick startAdd analytics and error monitoring to your app in a few minutes. Copy-paste setup for Next.js (App and Pages Router), React, plain HTML and React Native.
- InstallationInstall the Nohmo npm package and initialise the tracker. Covers project ID, API key, and where to mount the provider.
- ConfigurationEvery option the Nohmo SDK accepts — flush interval, autocapture, auto error tracking, release tagging, attribution parameters and debug mode.
Web
- Next.jsAdd product analytics, page views and error monitoring to a Next.js app. Copy-paste setup for both the App Router and the Pages Router, with environment variables and user identification.
- ReactAdd product analytics and error monitoring to a React single-page app. Provider setup, per-route page views with usePageView, and identifying users at login.
- HTML & script tagUse Nohmo without a build step. A single script tag adds page views, clicks, error tracking and UTM attribution to any server-rendered site.
Mobile
- React NativeAdd analytics, screen tracking and native crash reporting to a React Native or Expo app. Includes automatic screen views via the Babel plugin.
- FlutterAdd analytics, screen tracking, tap autocapture and native crash reporting to a Flutter app. Screen views via NohmoNavigatorObserver, taps via NohmoAutocapture — no codegen step.
- Install attributionDeterministic install attribution using the Play Store referrer on Android and the pasteboard on iOS — built into the Nohmo React Native SDK.
- Uninstall detectionNohmo detects uninstalls with silent push probes, so you can see churn on mobile without an extra SDK.
Backend
- Node.js & ExpressCapture backend exceptions in Node with nohmo/server. Express error handler, a raw node:http wrapper, PII scrubbing, and no runtime dependencies.
- Django & PythonCapture backend exceptions with the nohmo Python package. Django middleware, Flask and FastAPI integrations, PII scrubbing, and no runtime dependencies.
Tracking
- Auto-captureNohmo automatically captures page views, clicks, rage clicks, dead clicks, form submits and input changes. Field values are never captured.
- Custom eventsSend your own events with send(). Includes property conventions, naming guidance and how custom events appear in the dashboard.
- User identificationLink anonymous devices to a real user with linkUser(). Covers identity stitching across devices, reinstalls and anonymous-to-login journeys.
- UTM attributionNohmo captures UTM parameters on the first page of every session and attaches them to every subsequent event. Includes custom attribution params.
- Conversion trackingDefine conversion goals, call trackConversion(), and attach a monetary value so Nohmo can report revenue and rank bugs by what they cost you.
- Error trackingCapture uncaught exceptions, unhandled rejections, failed fetch/XHR requests and native iOS/Android crashes, with the session journey that led to each one.
Dashboard
- OverviewVisitors, sessions, events and average session time, with period-over-period deltas across web and app.
- DevicesBrowse every device and identified user, with their full event history and the journey they took through your product.
- Live feedWatch events arrive in real time as users move through your product — useful for verifying a new integration.
- TrafficSee which sources, mediums and campaigns bring traffic that converts, with UTM breakdowns and attribution models.
- JourneysReconstruct the path users take, build funnels from any events, and see where they drop off.
API Reference
- Events APIPOST events to Nohmo directly from a server or a platform the SDK does not cover. Request shape, authentication and batching.
- Identify APICreate or update a device and link it to a user from your backend. Request shape, authentication and response.
- Link User APIAttach a device to one of your users and retroactively attribute every event it already sent.
- Push Token APIRegister an FCM or APNs token so Nohmo can detect app uninstalls. Request shape and errors.
- Install Attribution APIAsk Nohmo which campaign an app install came from, using the Play install referrer, GAID or IDFA.
- Release APIReport a deploy from CI so metric movements can be attributed to the version that caused them.
- Invite Link APIMint a short attribution link for an invite-a-friend share so installs are credited to the campaign.
- Errors & limitsAuthentication, status codes, batching semantics, body size limits and rate limiting for every tracker endpoint.