Skip to content

How to Get UTM Parameters Into Chargebee

Chargebee already reports on churn, ARR and MRR. Adding campaign and channel data to each customer record lets you split those numbers by where the customer came from, so you can compare paid search, paid social, organic and referral performance on the same footing. This guide walks through the four setup steps and explains how to choose between hidden fields and cookie-based capture.

Why attach UTM data to Chargebee records

Chargebee is a billing and customer management system, and its built-in reports cover customer counts, churn, ARR and MRR. Those totals answer how the business is doing, but not which marketing channel or campaign produced each customer. Once channel and campaign fields sit on the customer record, the same subscription metrics can be sliced by source. That makes it possible to compare channels on trial volume, conversion and revenue rather than on clicks alone.

The four-step setup

The workflow has four stages: tag campaigns, persist the data in the browser, deliver it to Chargebee at signup, and report on it. Each stage has a failure mode worth checking before you move on.

Step 1: Tag every campaign with UTM parameters

Capture only works if the traffic carries UTM parameters. Apply them to social ads on networks such as Facebook, Instagram, LinkedIn and Twitter, to paid search ads, and to any placements you run with media outlets or publications. A campaign that launches without tags will arrive in Chargebee as unattributed or as a generic channel, so make tagging part of the campaign launch checklist rather than a later cleanup task.

Step 3: Deliver the data to Chargebee at signup

When a visitor submits a signup form, the campaign data travels into Chargebee alongside the details they entered, such as first name, last name and email address. There are two delivery methods, and the right one depends on how the signup form is built.

Choosing a delivery method

Use this checklist to pick the method that fits your signup flow.

Step 4: Report on channel and campaign in Chargebee

With both customer details and marketing data in Chargebee, reports can break subscription metrics down by the channel or campaign that brought the customer in. The useful metrics fall into four groups: acquisition volume (new trials and new customers per month), conversion efficiency (trial-to-customer rate), revenue (new MRR, new ARR, ARPU and lifetime value) and retention (customer churn rate and MRR churn rate). Reading the groups together avoids the common mistake of judging a channel on trial volume alone; a high-volume channel with weak conversion and high churn can look strong at the top of the funnel and weak at the bottom.

What raw UTM capture misses

Capturing raw UTM strings is the minimum. Several gaps tend to appear once a site has real traffic and more than one person managing campaigns.

Traffic without UTM parameters

Visitors who arrive from organic search, organic social, referrals or direct entry often carry no UTM parameters at all. A capture method that only reads UTM strings will leave those customers blank, which skews channel reporting toward paid sources. A method that also classifies non-tagged traffic keeps organic and referral customers in the dataset.

Signups that happen on a different page

A common failure: a visitor clicks a Google Ads link, lands on the campaign landing page, then clicks a free-trial button that redirects to a separate signup page. If the capture only reads the URL on the signup page, the campaign values are gone by then. Cookie-based storage avoids this because the values were recorded at landing and are read back at signup regardless of which page hosts the form.

Inconsistent UTM values

Raw UTM data gets messy when campaigns are managed by different people or agencies over time. The same source can appear as three different strings, for example a capitalized Facebook value, a lowercase facebook value and an abbreviated fb value. Raw capture turns those into three separate sources in Chargebee, which fragments reports. Normalization logic maps them to a single channel such as Paid Social so the report shows one row instead of three.

Landing page and content attribution

Content marketing is hard to justify without signup data attached to it. Capturing the landing page URL and a landing page category (for example, blog) shows how many signups and customers each content area produced, which is a more direct measure than pageviews or time on page.

Putting it together

The four steps are straightforward, but the differences show up in edge cases: untagged organic traffic, signup pages separate from landing pages, and inconsistent UTM spellings. Choosing a capture method that handles those cases keeps the Chargebee reports usable as campaign volume grows.

Delivery method comparison
MethodHow it worksBest for
Hidden fields in formsAdd hidden fields to the form; the script writes campaign data into them; the values are submitted with the rest of the form.Standard signup forms where you control the form markup.
Retrieved from the cookieA short JavaScript snippet reads the campaign values from the cookie at submit time and passes them into Chargebee.Signups without a form you can edit, such as 'Sign up with Google' or 'Sign up with Facebook' flows.

Both methods depend on the capture script being installed and on the visitor having a cookie set from an earlier tagged or classifiable visit.

Chargebee reporting metrics by channel or campaign
Metric groupMetrics
AcquisitionNew trials added each month; new customers added each month
ConversionTrial-to-customer conversion rate
RevenueNew MRR added each month; new ARR added each month; ARPU; lifetime value
RetentionCustomer churn rate; MRR churn rate

Each metric is reported broken down by the marketing channel and/or campaign recorded on the customer.

Frequently asked questions

Should I use hidden fields or the cookie method?

Use hidden fields when your signup form is one you can edit and the campaign values can be written into it before submission. Use the cookie method when there is no editable form, for example when visitors sign up with Google or Facebook. Both methods read the same stored campaign data, so the choice is about the signup flow, not about which data is captured.

Can I attribute customers who arrive without UTM parameters?

Yes, if the capture method classifies non-tagged traffic. Visitors from organic search, organic social, referrals and direct entry can be assigned a channel even when no UTM parameters are present, so they appear in Chargebee reports instead of being left blank.

What happens if the signup page is different from the ad landing page?

If the capture only reads the URL at signup, the campaign values are lost when the visitor moves to a separate signup page. Cookie-based storage records the values at landing and reads them back at signup, so the original campaign survives the page change.

Why do my Chargebee reports show several rows for the same source?

Raw UTM values are case-sensitive and spelling-dependent. The same source can appear as capitalized, lowercase or abbreviated strings, and raw capture treats each as a separate source. Normalization logic maps variants to one channel so the report shows a single row.