@formspark/formtrack
Advanced tools
Comparing version 0.1.2 to 0.1.3
@@ -5,3 +5,3 @@ { | ||
"private": false, | ||
"version": "0.1.2", | ||
"version": "0.1.3", | ||
"author": "Bjorn Krols (https://formspark.io)", | ||
@@ -8,0 +8,0 @@ "license": "MIT", |
@@ -17,4 +17,13 @@ <p align="center"> | ||
## Installation | ||
## About | ||
Marketers use UTM parameters to track the effectiveness of online campaigns across traffic sources and publishing media. | ||
The parameters identify the campaign that refers traffic to a specific website, and can be parsed by analytics tools and used to populate reports. | ||
Copying these parameters and injecting them into your form submissions manually is tedious and error-prone, that's why we build Formtrack. | ||
## Installation & usage | ||
Add the Formtrack script. | ||
```html | ||
@@ -24,4 +33,2 @@ <script src="https://unpkg.com/@formspark/formtrack"></script> | ||
## Usage | ||
Add a `data-formtrack` attribute to your form element. | ||
@@ -36,13 +43,17 @@ | ||
## Supported parameters | ||
Formtrack will now automatically inject the supported parameters into your HTML form submissions. | ||
- referrer | ||
- utm_campaign | ||
- utm_content | ||
- utm_medium | ||
- utm_source | ||
- utm_term | ||
### Supported parameters | ||
| Parameter | Purpose | Example | | ||
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | | ||
| utm_source | Identifies which site sent the traffic, not an official parameter. | referrer=producthunt | | ||
| utm_source | 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 | | ||
## License | ||
[MIT](https://opensource.org/licenses/MIT) |
40391
57