Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bnomei/kirby3-utm
UTM Tracking
https://github.com/bnomei/kirby3-utm
kirby3 kirby3-cms kirby3-plugin reports stats tracking utm
Last synced: 7 days ago
JSON representation
UTM Tracking
- Host: GitHub
- URL: https://github.com/bnomei/kirby3-utm
- Owner: bnomei
- License: mit
- Created: 2022-12-01T16:14:47.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-06T11:53:23.000Z (9 months ago)
- Last Synced: 2024-10-04T13:35:20.557Z (about 1 month ago)
- Topics: kirby3, kirby3-cms, kirby3-plugin, reports, stats, tracking, utm
- Language: PHP
- Homepage: https://forum.getkirby.com/t/kirby-3-utm-track-events-from-urls-with-utm-parameters/27339
- Size: 556 KB
- Stars: 18
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Kirby 3 UTM
[](https://travis-ci.com/bnomei/kirby3-utm)
[](https://coveralls.io/github/bnomei/kirby3-utm)
[](https://codeclimate.com/github/bnomei/kirby3-utm)
[](https://twitter.com/bnomei)
## Install
Using composer:
```bash
composer require bnomei/kirby3-utm
```
Using git submodules:
```bash
git submodule add https://github.com/bnomei/kirby3-utm.git site/plugins/kirby3-utm
```
Using download & copy: download [the latest release of this plugin](https://github.com/bnomei/kirby3-utm/releases) then unzip and copy it to `site/plugins`
## Commercial Usage
>
> Support open source!
> This plugin is free but if you use it in a commercial project please consider to sponsor me or make a donation.
> If my work helped you to make some cash it seems fair to me that I might get a little reward as well, right?
> Be kind. Share a little. Thanks.
> ‐ Bruno
>
| M | O | N | E | Y |
|---|----|---|---|---|
| [Github sponsor](https://github.com/sponsors/bnomei) | [Patreon](https://patreon.com/bnomei) | [Buy Me a Coffee](https://buymeacoff.ee/bnomei) | [Paypal dontation](https://www.paypal.me/bnomei/15) | [Hire me](mailto:[email protected]?subject=Kirby) |
## Usage
### UTM Page
Create a new page at root level with the blueprint `utm`.
### Tracking
Events will automatically be tracked to a sqlite database and appear in the UTM page within the panel grouped by campaign and displaying multiple stats.
## UTM
Original UTM explanation from [Bonnie Kittle at cdgi.com](https://www.cdgi.com/2020/04/how-to-use-utm-codes-to-track-campaigns-in-google-analytics/).
### utm_source
The advertiser, site, publication, etc. that is sending traffic to your property
### utm_medium
The advertising or marketing medium, for example, CPC (cost-per-click), banner ad, email newsletter
### utm_campaign
The individual campaign name, slogan, promo code, etc.
### utm_term
Identify paid search keywords. If you’re manually tagging paid keyword campaigns, you should also use utm_term to specify the keyword.
### utm_content
Used to differentiate similar content or links within the same ad. For example, if you have two call-to-action links within the same email message, you can use utm_content and set different values for each so you can tell which version is more effective. (i.e. image, button, headline)
## Settings
| bnomei.utm. | Default | Description |
|--------------------|---------|--------------------------------------------------------------------------------------------|
| enabled | `true` | |
| cache.ipstack | `true` | seperate cache for ip data, expires at `ipstack.expire` |
| cache.ratelimit | `true` | seperate cache for ratelimit, expires at `ratelimit.expire` |
| cache.queries | `true` | seperate cache for most queries used in panel, flushes automatically with each event tracked |
| ipstack.access_key | `null` | string. access key |
| ipstack.https | `false` | boolean. if `true` will use premium https endpoint. |
| ipstack.expire | `60*24` | int. cache in minutes for ipstack IP resolution. |
| sqlite.file | `fn()` | path to sqlite file. like site/logs |
| stats.range | `30` | int. half of range of days for bar and change percentage |
| ratelimit.enabled | `true` | bool. if `true` it will limit on params below |
| ratelimit.expire | `60` | int. in minutes before trials reset |
| ratelimit.trials | `120` | int. number of allowed trials in given duration |
| botDetection.CrawlerDetect | `true` | check for crawlers (~10ms) |
| botDetection.DeviceDetector | `true` | check for bots (~40ms) |
## Dependencies
- (optional) [free ipstack account for IP geolocations](https://ipstack.com/)
## Disclaimer
This plugin is provided "as is" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please [create a new issue](https://github.com/bnomei/kirby3-utm/issues/new).
## License
[MIT](https://opensource.org/licenses/MIT)
It is discouraged to use this plugin in any project that promotes racism, sexism, homophobia, animal abuse, violence or any other form of hate speech.