dwyl / atm

🏧 free cash™
GNU General Public License v2.0
9 stars 0 forks source link

Accept UTM Parameters #26

Open nelsonic opened 4 years ago

nelsonic commented 4 years ago

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 commented 4 years ago

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