> 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

The Attribution page in Humblytics connects supported ad-spend data with matched revenue. It combines data from your connected payment provider (like Stripe) with available traffic and campaign identifiers to show which campaigns, sources, and landing pages are associated with revenue.

**Accessing Attribution**

1. Log in to your Humblytics account and select your site.
2. Click **Attribution** in the sidebar under **Analyze**.

**Overview Cards**

At the top of the Attribution page, three summary cards provide a quick snapshot:

* **Revenue Tracked** — Total revenue captured from your connected payment provider. Connect ad accounts to unlock verified campaign attribution and ROAS.
* **Attribution Status** — Shows whether your ad accounts are connected for verified attribution. When verification is required, revenue is still tracked but source attribution uses traffic analytics signals.
* **ROAS** — Return on Ad Spend. Calculated once both ad spend and revenue data are connected.

**Attribution Section**

The main attribution section shows verified ad spend to revenue attribution:

* **Summary metrics** — Ad Spend, Impressions (IMP), Clicks, CPC, Sessions, Paid sessions, Revenue, Verified %, and ROAS
* **Bar chart** — Sessions vs. Revenue plotted over time, helping you visualize the relationship between traffic and revenue

**Sub-Tabs**

The attribution table has three views:

* **Campaigns** — Shows each ad campaign with its spend, clicks, CTR, sessions, revenue, and ROAS. Connect ad platforms like Meta Ads to populate this data.
* **Sources** — Breaks down revenue by traffic source, showing which referrers and UTM sources drive the most revenue.
* **Landing Pages** — Shows which landing pages generate the most revenue, helping you identify your highest-converting pages.

Each table includes a search bar to filter results.

**Connecting Ad Platforms**

To see full attribution data with ad spend and ROAS, connect your ad platforms via the **Connectors** page:

1. Navigate to **Connectors** in the sidebar under **Automate**.
2. Connect Meta Ads. Google Ads is not yet shipped, so keep it in your current reporting workflow for now.
3. Return to the Attribution page to see verified campaign data.

If no ad platforms are connected, the Attribution page still shows revenue broken down by traffic source using Humblytics' own tracking data.

**Revenue on the Overview Tab**

Revenue attribution data also appears on the **Analytics > Overview** tab as the "Revenue Attribution" section. This shows:

* Total Revenue with a Stripe badge
* Paid vs. Organic revenue split with percentages
* Horizontal bar chart showing revenue by source (e.g., fb\_ad, unknown, affiliate\_ai)

**Using Attribution Data**

Attribution helps you:

* **Evaluate attributed ROAS** — Compare matched campaign spend and revenue using the data available for each conversion
* **Optimize ad spend** — Shift budget toward campaigns and channels that drive real revenue
* **Identify top landing pages** — Discover which pages convert the most paid traffic into customers
* **Connect spend to outcomes** — Go beyond clicks and impressions to see actual revenue impact

**Querying Attribution Programmatically**

The same per-campaign full-funnel data the Attribution page renders is also available via the [Ads Attribution API](/ads-attribution-api.md). Use it from agents, dashboards, or scheduled scripts to pull spend → clicks → sessions → revenue without scraping the dashboard. For raw connector metadata (ad accounts, campaigns, daily insights, ad creative), see the [Ads Connections API](/ads-connections-api.md). Both endpoints accept the same property-scoped API key as the rest of the public API.