Accept UTM Parameters

[nelsonic]

Story

As a web app/site product developer/manager
I want to keep track of the source of visitors
So that I know how people are discovering the app/site.

The way we will achieve this is using industry standard tracking (UTM) parameters.

Context

Urchin Tracking Module (UTM) parameters https://en.wikipedia.org/wiki/UTM_parameters were introduced by Google Analytics' predecessor Urchin and, consequently, are supported out-of-the-box by Google Analytics. They are the most widely used URL parameters in Analytics and are generally supported by most alternatives to Google Analytics, the 800-pound gorilla in web/app analytics.

Parameter	Purpose	Example
utm_source (required)	Identifies which site sent the traffic, and is a required parameter.	utm_source=Google
utm_medium	Identifies what type of link was used, such as cost per click or email.	utm_medium=cpc
utm_campaign	Identifies a specific product promotion or strategic campaign.	utm_campaign=spring_sale
utm_term	Identifies search terms.	utm_term=running+shoes
utm_content	Identifies what specifically was clicked to bring the user to the site, such as a banner ad or a text link. It is often used for A/B testing and content-targeted ads.	utm_content=logolink or utm_content=textlink

Note: I don't think we need to have all of these UTM parameters working from Day 1.
We just need utm_source=welcome-mail and utm_term=token
However I don't feel it's that much effort to parse all 5 params and write the tests for them,
so we might as well just support them all ... 💭

[nelsonic]

https://smashnotes.com/updates/how-to-use-utm-parameters-to-grow-your-audience
https://news.ycombinator.com/item?id=23252631