Download the PHP package aldeebhasan/laravel-event-tracker without Composer
On this page you can find all versions of the php package aldeebhasan/laravel-event-tracker. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download aldeebhasan/laravel-event-tracker
More information about aldeebhasan/laravel-event-tracker
Files in aldeebhasan/laravel-event-tracker
Package laravel-event-tracker
Short Description A privacy-first Laravel package for tracking conversions, events, and user journeys—100% locally stored. No third-party APIs, no external tracking.
License MIT
Homepage https://github.com/aldeebhasan/laravel-event-tracker
Informations about the package laravel-event-tracker
A privacy-first Laravel package for tracking conversions, events, and user journeys—100% locally stored. No third-party APIs, no external tracking.
A simple and flexible Laravel package for tracking events in your application. The laravel-event-tracker package provides an intuitive helper function to log events with minimal setup, abstracting the complexity of event storage and retrieval. It supports multiple drivers (e.g., database, log) and includes Artisan commands to retrieve insightful statistics about your events.
Installation
You can install the package via composer:
You need first to publish and run the migrations with:
You can publish the config file with:
Usage
Track events
After the configuration of the target driver you want to use in the config file (log by default), you can start track your users with the following helpers
if you want to use different driver at run time, you can use the tracker helper to configure it.
Alternately, you can use the package facade to call all the event tracker manager functions
View Statistics & Insights
We have four available commands that can tell you the whole story about your events:
- event-tracker:frequency : Show the event frequency bases on specific/all users.
- event-tracker:event-insights : Show the event insights for specific/all events within a specific period of time.
- event-tracker:statistics : Show general statistics about the events and users.
- event-tracker:user-insights : Show the user insights within a specific period of time.
all these commands has 4 input options
Advanced Setup
Custom Tracker
After publishing of the config, you have the ability to change the default trackers implementation, or add your custom tracker. to configure your custom tracker you can define it in the config file as follow:
Then you can use the tracker as follow
[!IMPORTANT] The
CustomTrackershould implement theTrackerUIinterface
Additional Resolvers
In the config file you have a resolver array that contain all the resolver applied on the incoming request to extract data from it. If you want to extract extra info from the current request you can create a new resolver class and add it to the resolver list.
As example: let create a new resolver to extract the host from the request:
[!IMPORTANT] The new resolver should implement the
ResolveUIinterface
The new resolver data will be passed within the $meta param within the track function in all of the tracker implementation.
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Hasan Deeb
- All Contributors
License
The MIT License (MIT). Please see License File for more information.