> For the complete documentation index, see [llms.txt](https://docs.humblytics.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.humblytics.com/readme.md).

# Overview

Welcome to Humblytics, revenue analytics and A/B testing for growth teams and CRO agencies that own paid spend and revenue.

## What is Humblytics?

Humblytics connects paid spend, site behavior, experiments, and matched payment revenue so growth teams and CRO agencies can see which campaigns and pages make money, then test what does not. It combines revenue analytics, visual A/B testing, click and scroll heatmaps, and conversion funnels in one platform.

Launch page experiments with the visual editor, diagnose friction with funnels and heatmaps, and evaluate supported conversion or revenue goals. Claude, Codex, and other compatible agents can access supported data through MCP and the API, with human approval for changes. Cookie-free tracking and the lightweight script are supporting implementation benefits, not the primary product category.

***

## Key Features

### 1. Automatic & Custom Click Tracking

* **Click events and form events** are tracked automatically—view them under **Analytics** (Site Traffic, Pages, Clicks, Forms).
* **Add custom attributes** (e.g., `humblytics="signup-button"`) when you want to label specific click events for better visibility in the **Clicks** section.
* **No‑code & low‑code friendly** for platforms like Webflow, Framer, and Typedream.

### 2. Funnel Analysis

* **Multi‑step funnels**: map page views, clicks, form submissions—or any custom event—in a visual flow.
* **Conversion metrics at a glance**: see starting volume, drop‑off percentages, overall conversion rate, and per‑step value attribution.
* **Cross‑domain support**: switch between "primary domain only" or multiple domains to follow users across subdomains or checkout flows.
* **Segment & save funnels** for one‑click access during campaigns or A/B tests.

### 3. Click & Scroll Heatmaps

* **Dynamic heatmaps** overlay click density on live pages for desktop, tablet, and mobile views.
* **Scroll-depth insights** show where users lose interest on long pages.
* **Page‑level filtering** lets you compare different layouts or devices side‑by‑side.
* **No extra installation**—heatmaps activate automatically once the base script is on your site.
* **Heatmap history & versioning** - Track how your pages evolve over time with automatic version saving.

### 4. Experiments (A/B Testing)

* **One script, every test**: run split tests without adding extra libraries (5 live tests on Business; unlimited on Scale and Enterprise). Existing Plus accounts retain their legacy limits.
* **SEO‑safe redirects** with canonical tags to avoid duplicate content penalties.
* **Cookie‑free audience assignment** using short‑lived query parameters.
* **External destination tracking** - Track successful transfers to partner sites and multi-domain checkouts.

### 5. Revenue Attribution & Payment Integrations

* **End-to-end attribution** - Connect sales to traffic sources, campaigns, and A/B test variants.
* **See which channels drive money** - Track revenue from marketing campaigns to understand true ROI.
* **Payment provider integrations**:
  * **Stripe** - Complete revenue tracking with automatic attribution
  * **Foxy** - Track Foxycart purchase events
  * **Other providers** - Custom purchase events where you control the confirmation page (hosted checkouts like Shop Pay are not supported)
* **Revenue as conversion goal** - Use completed purchases as A/B test goals.
* **Privacy-compliant tracking** - Cookie-free revenue attribution.
* **Real-time revenue data** - Sales appear in your dashboard within \~30 seconds.

### 6. MCP & API Access

* Connect Claude, Codex, or another compatible agent to supported traffic, funnel, heatmap, experiment, and revenue data.
* Agents can investigate data and prepare supported experiment changes. Review and approval remain part of the workflow.
* MCP and the API are supporting execution layers for the revenue analytics and experimentation job, not a separate product category.

### 7. Data Connectors

* **Revenue connectors**: Stripe and Foxy integrate directly to attribute purchases to traffic sources.
* **Form connectors**: JotForm and Tally connect to track form submissions automatically.
* **Ad attribution**: Meta Ads is live. Google Ads is not yet shipped.
* **Coming soon**: Google Analytics 4, Google Search Console, Shopify, and more.
* Access connectors from the **Automate** section in the sidebar.

### 8. Export & Marketing Tools

* **CSV export** for all analytics data -- download traffic summaries, page breakdowns, device data, location data, channel data, referrals, UTM data, LLM referrals, click and form events, and A/B test results.
* **Marketing tools** available under Utilities in the sidebar:
  * **UTM Generator** -- create trackable campaign URLs
  * **A/B Test Planner** -- calculate sample sizes and test duration
  * **Significance Calculator** -- check if test results are statistically significant
  * **Conversion Rate Calculator** -- calculate and compare against benchmarks

### 9. Privacy & Performance

* **Cookie‑free by design**—no consent banners required under GDPR.
* **Lightweight** (\~36 KB) async‑loaded script served from regional CDNs.
* **Full GDPR compliance** - We've worked with Simpliant Legal to finalize privacy policies, data processing agreements, and EU residency requirements.
* **LLM referral tracking** - Automatically tracks traffic from ChatGPT, Perplexity, and other AI tools.

***

## Platform Integrations

Humblytics works seamlessly with all major website builders and frameworks:

* **Webflow**: add the script in *Site Settings → Custom Code → Head*
* **Framer**: paste the tag in *Site Settings → General → Custom Code*
* **Wix**: in the site editor go to *Settings → Custom Code*
* **Squarespace**: navigate to *Settings → Advanced → Code Injection*
* **WordPress**: use a header/footer plugin or edit `header.php`
* **Shopify**: open *Online Store → Themes → Edit Code*
* **And 15+ more platforms** - See our [Installation Guides](/how-to-get-started.md)

***

## Common Use Cases

| Goal                             | Humblytics Workflow                                                 |
| -------------------------------- | ------------------------------------------------------------------- |
| Improve landing page sign‑ups    | Heatmap → identify low‑click CTAs → A/B test hero copy              |
| Diagnose checkout drop‑off       | Funnel (Cart → Checkout → Thank You) → view step‑level conversion   |
| Attribute campaign ROI           | Custom click events on ads/UTM pages → Funnel value attribution     |
| Track AI referrals               | Dashboard → See ChatGPT and Perplexity traffic automatically        |
| See which channels drive revenue | Revenue tracking → Attribute sales to traffic sources and campaigns |
| Optimize for revenue, not clicks | A/B tests with revenue goals → Find variants that increase sales    |
| Investigate with an agent        | MCP/API → review supported analytics and prepare an approved test   |
| Export data for analysis         | Export Data → select categories → download CSV files                |

***

## Privacy & Compliance

* **GDPR Compliance**: Full GDPR compliance is complete with privacy policies, data processing agreements, and EU residency requirements.
* **Personal Data Collection**: Collects name, email, and billing details during account creation.
* **Automatic Tracking**: Tracks IP, location, OS, and other metadata to improve user experience.
* **Data Security**: Employs industry-standard security measures.
* **Third-Party Services**: Integrates services like Webflow, Stripe, OpenAI, and GitHub.
* **Data Residency**: Complete privacy controls and data location options are available for EU compliance.

***

## Quick Links

### Resources

* 🏠 [Homepage](https://humblytics.com/)
* 📺 [YouTube Tutorials](https://www.youtube.com/@humblytics)
* 📖 [Guides](https://humblytics.com/guides)
* 🔧 [Tools and Calculators](https://humblytics.com/tools/free-humblytics-split-testing-and-analytics-tools)

### Getting Started

1. **Install Humblytics** - Choose your platform from our [Getting Started Guide](/how-to-get-started.md)
2. **Track Custom Events** - Learn about [Click Events](/how-to-track-custom-click-events.md), [Form Submissions](/how-to-track-custom-form-submissions.md), and [Purchase Events](/how-to-track-purchase-events.md)
3. **Connect Payment Providers** - Set up [Revenue Attribution](/how-to-track-purchase-events.md) to see which channels drive sales (Stripe and Foxy natively, other providers via custom purchase events)
4. **Optimize with Split Testing** - Set up [A/B tests](/split-testing-overview.md) to improve conversions and revenue
5. **Understand Your Data** - Explore your [Analytics Dashboard](/understanding-your-data.md)
6. **Connect an Agent** - Use [MCP & API Access](/api-access-and-agents.md) to investigate supported data from Claude, Codex, or another compatible agent
7. **Connect External Tools** - Integrate revenue and form providers via [Connectors](/connectors.md)
8. **Export Your Data** - Download analytics as CSV from [Export Data](/export-data.md)
9. **Use Agent Skills** - Install optional marketing skills from the [MCP & API Access](/api-access-and-agents.md) guide

***

**Ready to dive in?** Install the single script, verify your site, and start exploring funnels, heatmaps, and real‑time events within minutes.

Need help? Check our [FAQ](/frequently-asked-questions.md) or contact support.