# Betterumami

- [Introduction to the Betterumami Analytics Platform](https://docs.betterumami.com/docs/introduction.md): Betterumami is a privacy-first analytics platform built on Umami — real-time dashboards, events, funnels, revenue, and AI integration without cookies.
- [Quickstart: Set Up Betterumami Analytics in Minutes](https://docs.betterumami.com/docs/quickstart.md): Create a Betterumami account, add your website, and install the tracking script to start collecting privacy-first analytics in under five minutes.
- [Add a Website to Your Betterumami Analytics Dashboard](https://docs.betterumami.com/docs/add-a-website.md): Learn how to register a new website in Betterumami so you can install the tracking script and start collecting analytics data right away.
- [Install the Betterumami Tracking Script on Your Site](https://docs.betterumami.com/docs/install-tracking-script.md): Copy the Betterumami tracking script from your dashboard and paste it into your site's head tag to start collecting analytics data instantly.
- [How to Track Custom Events in Betterumami Analytics](https://docs.betterumami.com/docs/track-events.md): Record button clicks, form submissions, and any user interaction as named events — with optional custom data — using HTML attributes or JavaScript.
- [Betterumami Tracker Functions: Complete API Reference](https://docs.betterumami.com/docs/tracker-functions.md): Full reference for every umami.track() and umami.identify() function signature, with examples for pageviews, events, session data, and custom payloads.
- [Configure the Betterumami Tracker Script Attributes](https://docs.betterumami.com/docs/tracker-configuration.md): Customise tracking behavior using data attributes on the script tag — restrict domains, disable auto-tracking, collect Core Web Vitals, and more.
- [Identify Visitors Across Sessions with Distinct IDs](https://docs.betterumami.com/docs/distinct-ids.md): Assign a stable unique identifier to each visitor to connect their events and pageviews across multiple sessions, devices, and browsers in Betterumami.
- [Overview Dashboard: Your Real-Time Analytics at a Glance](https://docs.betterumami.com/docs/overview-dashboard.md): Understand your website's key metrics — pageviews, visitors, bounce rate, and visit duration — all in one real-time privacy-first dashboard.
- [Filters: Slice and Segment Your Analytics Data Any Way](https://docs.betterumami.com/docs/filters.md): Apply conditions across all Betterumami reports — by URL, location, device, UTM, and more — using flexible operators and universal filter propagation.
- [Compare: Measure Your Website's Progress Over Time](https://docs.betterumami.com/docs/compare.md): Overlay two time periods on your Betterumami dashboard to spot trends, confirm improvements, and catch regressions before they become problems.
- [Breakdown: Segment Your Analytics by Any Dimension](https://docs.betterumami.com/docs/breakdown.md): Aggregate your Betterumami data by any combination of fields — path, browser, country, device, and more — to uncover patterns in your audience.
- [Goals: Track and Measure Your Key Conversion Actions](https://docs.betterumami.com/docs/goals.md): Define the pages and events that matter most, then measure what percentage of your visitors complete each one during any date range you choose.
- [Funnels: Visualize Conversion and Step Drop-Off Rates](https://docs.betterumami.com/docs/funnels.md): Build step-by-step conversion funnels from any sequence of pages and events, then see exactly where visitors drop off and how many make it through.
- [Attribution: Credit the Right Channels and Campaigns](https://docs.betterumami.com/docs/attribution.md): Connect referrers, UTM campaigns, and paid ads to conversions via first-click or last-click attribution models to see which channels drive real results.
- [Retention: Measure How Often Your Visitors Come Back](https://docs.betterumami.com/docs/retention.md): Measure how many visitors return after their first visit using cohort analysis, and learn whether your site keeps people coming back over time.
- [Betterumami Account Setup, Billing, and Notifications](https://docs.betterumami.com/docs/account-setup.md): Create your Betterumami account, verify your email, manage your subscription, and configure notification preferences — all in one place.
- [Teams: Share Analytics and Collaborate with Your Team](https://docs.betterumami.com/docs/teams.md): Create teams on the Pro plan to share website analytics with colleagues, assign roles, invite members, and manage website access in one place.
- [Email Reports: Scheduled Website Performance Summaries](https://docs.betterumami.com/docs/email-reports.md): Send automatic weekly website summary emails to any address — top stats, top pages, and top referrers — delivered every morning on the Pro plan.
- [API Keys: Programmatic Access to Betterumami Analytics](https://docs.betterumami.com/docs/api-keys.md): Generate API keys to query your Betterumami analytics data programmatically via the Cloud REST API, with region-specific endpoints and rate limits.
- [Install Betterumami Tracking via Google Tag Manager](https://docs.betterumami.com/docs/google-tag-manager.md): Add the Betterumami tracking script to any website through Google Tag Manager using a Custom HTML tag — no direct HTML editing required.
- [MCP Server: Connect AI Assistants to Your Analytics](https://docs.betterumami.com/docs/mcp.md): Use the Model Context Protocol to let Claude, ChatGPT, Cursor, and other AI tools query your Betterumami analytics in natural language.
- [Bypass Ad Blockers for Accurate Betterumami Tracking](https://docs.betterumami.com/docs/bypass-ad-blockers.md): Keep your Betterumami tracking accurate by proxying the script through your own domain or hosting it yourself — even when ad blockers are active.
- [Betterumami REST API Reference Overview](https://docs.betterumami.com/api-reference/introduction.md): Explore the Betterumami REST API — query website stats, send tracking events, and manage your analytics data programmatically with a single Bearer token.
- [Authenticating Betterumami API Requests](https://docs.betterumami.com/api-reference/authentication.md): Learn how to authenticate every API call — generate an API key on Cloud or exchange username and password for a session token on self-hosted instances.
- [Sending Tracking Events via the Betterumami API](https://docs.betterumami.com/api-reference/sending-stats.md): Use POST /api/send or POST /api/batch to record pageviews, custom events, and user traits directly — no tracker script required.
- [List All Websites — Betterumami GET /api/websites](https://docs.betterumami.com/api-reference/list-websites.md): Retrieve a paginated list of websites you own or can access through team membership, with optional search, sorting, and result-limit controls.
- [Get Website by ID — GET /api/websites/{websiteId}](https://docs.betterumami.com/api-reference/get-website.md): Fetch the full configuration and metadata for one website using its unique ID, including domain, sharing settings, team, and recording config.
- [Create a New Website — Betterumami POST /api/websites](https://docs.betterumami.com/api-reference/create-website.md): Register a new website for tracking by providing a name and domain. Optionally assign it to a team and enable public sharing with a shareId.
- [Update a Website — POST /api/websites/{websiteId}](https://docs.betterumami.com/api-reference/update-website.md): Modify a website's name, domain, public share token, or session replay and heatmap recording configuration. Only fields you include are updated.
- [Delete a Website — DELETE /api/websites/{websiteId}](https://docs.betterumami.com/api-reference/delete-website.md): Permanently remove a website and all associated analytics data from Betterumami. This action is irreversible and cannot be undone. Use with care.
- [Get Website Stats — GET /api/websites/{websiteId}/stats](https://docs.betterumami.com/api-reference/get-website-stats.md): Retrieve pageviews, unique visitors, visits, bounces, and total time on site for any date range, with an optional comparison period for trend analysis.
- [Get Pageviews Over Time — GET /api/websites/{id}/pageviews](https://docs.betterumami.com/api-reference/get-website-pageviews.md): Fetch pageview and session counts grouped by a time interval for charting trends. Supports comparison periods, timezone-aware bucketing, and all filters.
- [Get Website Metrics — GET /api/websites/{id}/metrics](https://docs.betterumami.com/api-reference/get-website-metrics.md): Retrieve a ranked list of values for a single dimension — top pages, referrers, countries, browsers, events, and UTM sources — sorted by count.
- [List Website Events — GET /api/websites/{websiteId}/events](https://docs.betterumami.com/api-reference/get-website-events.md): Retrieve a paginated log of individual pageviews and custom events for a website, with full session context, newest first. Supports filtering and search.
- [Get Active Visitors — GET /api/websites/{websiteId}/active](https://docs.betterumami.com/api-reference/get-website-active.md): Return the number of unique visitors active on your website in the last 5 minutes. Ideal for real-time dashboards and live visitor counters.
- [Betterumami API Client Reference (@umami/api-client)](https://docs.betterumami.com/api-reference/api-client.md): Install and use the @umami/api-client TypeScript package to call every Betterumami REST endpoint from Node.js with complete type safety.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.