PHPackages                             code-tree-dev/laravel-utm-tracker - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. code-tree-dev/laravel-utm-tracker

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

code-tree-dev/laravel-utm-tracker
=================================

A lightweight Laravel package that adds a middleware to automatically capture and store UTM parameters (like utm\_source, utm\_medium, utm\_campaign) from incoming requests. Makes it easy to track traffic sources across sessions for analytics, marketing attribution, or lead tracking.

2.0.2(8mo ago)389MITPHPPHP ^8.0 || ^8.1 || ^8.2 || ^8.3 || ^8.4CI passing

Since Oct 24Pushed 8mo agoCompare

[ Source](https://github.com/code-tree-dev/laravel-utm-tracker)[ Packagist](https://packagist.org/packages/code-tree-dev/laravel-utm-tracker)[ Docs](https://github.com/code-tree-dev/laravel-utm-tracker)[ RSS](/packages/code-tree-dev-laravel-utm-tracker/feed)WikiDiscussions main Synced today

READMEChangelog (4)Dependencies (3)Versions (5)Used By (0)

Laravel UTM Tracker
===================

[](#laravel-utm-tracker)

[![Latest Version on Packagist](https://camo.githubusercontent.com/53dbec06a74432879575161c003f9f36a7f635a761be4ac0bd8ecb3e879aeb8f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636f64652d747265652d6465762f6c61726176656c2d75746d2d747261636b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/code-tree-dev/laravel-utm-tracker)[![Total Downloads](https://camo.githubusercontent.com/55d45111f97a0a170f2481191cc692e8601142f69fd1076b2c0a5c38e1391035/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f64652d747265652d6465762f6c61726176656c2d75746d2d747261636b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/code-tree-dev/laravel-utm-tracker)[![GitHub Actions](https://github.com/code-tree-dev/laravel-utm-tracker/actions/workflows/main.yml/badge.svg)](https://github.com/code-tree-dev/laravel-utm-tracker/actions/workflows/main.yml/badge.svg)

Laravel UTM Tracker is a package for Laravel that automatically or manually tracks UTM parameters from your visitors and stores them in your database. It is ideal for marketing attribution, analytics, and campaign tracking. The package is easy to configure, extend, and integrates seamlessly with Laravel middleware and facades.

Features
--------

[](#features)

- Automatic UTM tracking via middleware
- Manual UTM tracking via Facade
- Stores UTM data in the database, session, or cookie
- Easily extendable for custom UTM parameters
- Ready for analytics and marketing attribution

Installation
------------

[](#installation)

Install the package via Composer:

```
composer require code-tree-dev/laravel-utm-tracker
```

Publish the config and migration files (optional):

```
php artisan vendor:publish --provider="CodeTreeDev\LaravelUtmTracker\LaravelUtmTrackerServiceProvider"
```

Run the migrations if using database storage:

```
php artisan migrate
```

Configuration
-------------

[](#configuration)

You can configure the package in `config/laravel-utm-tracker.php`:

- `storage`: Where to store UTM data (`session`, `cookie`, or `database`)
- `parameters`: Default UTM parameters to track
- `custom_parameters`: Add your own custom UTM parameters
- `cookie_lifetime`: Lifetime for cookies (if using cookie storage)
- `auto_track`: Enable/disable automatic tracking via middleware
- `table`: Table name for database storage

Usage
-----

[](#usage)

### Automatic Tracking (Middleware)

[](#automatic-tracking-middleware)

By default, the package's middleware is registered and will automatically capture UTM parameters from incoming requests:

```
// No action needed if auto_track is enabled in config.
```

### Manual Tracking (Facade)

[](#manual-tracking-facade)

You can manually create a UTM visit record using the Facade:

```
use LaravelUtmTracker;

LaravelUtmTracker::track([
    'utm_source' => 'newsletter',
    'utm_medium' => 'email',
    'utm_campaign' => 'spring_sale',
    // ...other fields...
]);
```

### Testing

[](#testing)

Run the test suite with:

```
composer test
```

Contributing
------------

[](#contributing)

Contributions are welcome! Please read the [CONTRIBUTING](CONTRIBUTING.md) and [CODE\_OF\_CONDUCT](CODE_OF_CONDUCT.md) files for details.

- Open issues for bugs or feature requests
- Submit pull requests for improvements

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Changelog
---------

[](#changelog)

See [CHANGELOG](CHANGELOG.md) for recent changes.

Credits
-------

[](#credits)

- [Code-Tree.dev](https://github.com/code-tree-dev)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). See [License File](LICENSE.md) for details.

Laravel Package Boilerplate
---------------------------

[](#laravel-package-boilerplate)

This package was generated using the [Laravel Package Boilerplate](https://laravelpackageboilerplate.com).

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance60

Regular maintenance activity

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

251d ago

Major Versions

1.0.0 → 2.0.02025-10-24

PHP version history (2 changes)1.0.0PHP ^7.4|^8.0

2.0.0PHP ^8.0 || ^8.1 || ^8.2 || ^8.3 || ^8.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/117585305?v=4)[CodeTreeDev](/maintainers/codetreedev)[@codetreedev](https://github.com/codetreedev)

---

Top Contributors

[![Trukes](https://avatars.githubusercontent.com/u/6023213?v=4)](https://github.com/Trukes "Trukes (10 commits)")

---

Tags

laravellaravel-frameworklaravel-packagephputmutm-parameterscode-tree-devlaravel-utm-tracker

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/code-tree-dev-laravel-utm-tracker/health.svg)

```
[![Health](https://phpackages.com/badges/code-tree-dev-laravel-utm-tracker/health.svg)](https://phpackages.com/packages/code-tree-dev-laravel-utm-tracker)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[renatomarinho/laravel-page-speed

Laravel Page Speed

2.5k1.7M11](/packages/renatomarinho-laravel-page-speed)[illuminate/pagination

The Illuminate Pagination package.

12234.1M1.0k](/packages/illuminate-pagination)[illuminate/pipeline

The Illuminate Pipeline package.

9349.2M281](/packages/illuminate-pipeline)[illuminate/broadcasting

The Illuminate Broadcasting package.

7127.2M208](/packages/illuminate-broadcasting)[illuminate/redis

The Illuminate Redis package.

8314.6M374](/packages/illuminate-redis)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
