> 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/understanding-your-data/understanding-attribution.md).

# Understanding Attribution

See which campaigns, sources, and landing pages bring in revenue, and what you earn back for every dollar of ad spend.

Attribution means giving credit for a sale to the campaign or source that brought the buyer. Humblytics matches payments from your revenue provider (such as Stripe) to the visit that led to them, then adds ad spend from Meta Ads and Google Ads.

Go to **Observe → Attribution**.

## Before you start

The first time you open Attribution, a short **Set up attribution** wizard walks you through the connections it needs. You can come back to it from the page at any time.

| Connect                               | What it unlocks                           | Where                                                                           |
| ------------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------- |
| **Stripe, Foxy, or another provider** | Revenue, trials, and matched transactions | [Revenue tracking](https://docs.humblytics.com/how-to-track-purchase-events.md) |
| **Meta Ads and Google Ads**           | Ad spend, impressions, clicks, and ROAS   | **Agent & data → Connectors**, or the setup wizard on this page                 |
| **UTM tags on your ad links**         | Matching ad clicks to visits              | [UTM links](https://docs.humblytics.com/campaign-tracking-with-utm-links.md)    |

If no ad platform is connected, the page still shows revenue by traffic source and landing page from Humblytics' own tracking. If a Google Ads connection needs attention (for example an expired login or a campaign with no UTM tags), a **Google Ads** health banner at the top of the page says what to fix.

## Summary metrics

| Metric                            | What it means                                                                         |
| --------------------------------- | ------------------------------------------------------------------------------------- |
| **Ad spend**                      | What you spent on connected ad accounts.                                              |
| **Revenue**                       | Sales from your connected revenue provider.                                           |
| **ROAS**                          | Return on ad spend: revenue ÷ ad spend. A ROAS of 3 means $3 back for every $1 spent. |
| **CPA**                           | Cost per acquisition: ad spend ÷ conversions.                                         |
| **Attributed**                    | The share of revenue Humblytics could match to a visit.                               |
| **Unique visitors**               | Different people in the selected dates.                                               |
| **Clicks, CTR, CPC, Impressions** | Ad metrics from your ad platforms. CPC is cost per click.                             |

The trend chart plots visitors, revenue, and ad spend over time. Click **Hide values** to blur dollar amounts before you share your screen.

## Attribution funnel

The funnel strip follows money through your site: ad clicks → visitors → trials → payments, with the drop at each step. Pick a campaign or platform to see the funnel for that traffic alone.

## Campaigns

When an ad account is connected, the **Campaigns** table lists each ad campaign with spend, impressions, clicks and CTR, visitors, revenue, trials, cost per trial, average days to convert, and ROAS. Campaign spend and revenue always cover all traffic, because ad platforms don't report spend by country or page.

## Landing pages and Sources

Below the campaigns:

* **Landing pages:** revenue by the page where the buyer's visit started.
* **Sources:** revenue by referrer and UTM source.

Filters at the top of the page apply to visitors, the funnel, and these two tables.

## Free trial attribution

If you offer free trials through Stripe, trials are credited to the campaign behind the visit that started them, with **Total trials**, **Trial value**, and **Avg / trial**. Trials and payments settle up to 14 days after the visit, so recent days fill in over time.

## Attribution model

Where available on your account, the **Attribution model** panel shows how revenue splits across sources under different crediting rules, so you can compare, for example, first-touch and last-touch credit.

## Fix gaps in your tracking

Two sections flag data that can't be matched yet:

* **Missing session tracking:** ad spend with no matching visits. The ad's link is usually missing UTM tags, or it points to a page without the tracking script.
* **Visitors without ad data:** visits with UTM tags from an ad account you haven't connected. Connect the account to see spend and ROAS.

**Recent attributed transactions** lists your latest matched payments, so you can spot-check that attribution works.

## Use it in your own tools

The same campaign data is available through the [Ads Attribution API](https://docs.humblytics.com/ads-attribution-api.md), for dashboards, scripts, and AI agents.
