README

Laravel 12 package that provides middleware and a facade for server-side tracking with Swetrix.

Installation

composer require falcon/swetrix-laravel-server-side-tracking

The service provider is auto-discovered.

Publish the config:

php artisan vendor:publish --tag=swetrix-config

Configuration

Set the following environment variables:

SWETRIX_ENDPOINT=https://api.swetrix.com/log
SWETRIX_PROJECT_ID=your-project-id
SWETRIX_API_TOKEN=your-api-token

Usage

Middleware (deferred)

Attach the middleware to the routes you want to track. The Swetrix call is deferred until after the response is sent.

use Falcon\SwetrixLaravelTracking\Middleware\SwetrixTracking;

Route::middleware([SwetrixTracking::class])->get('/pricing', function () {
    return view('pricing');
});

Facade (manual)

Manually send a tracking event.

use Falcon\SwetrixLaravelTracking\Facades\Swetrix;

Swetrix::track(
    payload: [
        'pg' => 'https://example.com/pricing',
        'ref' => 'https://google.com',
    ]
    userAgent: request()->userAgent(), 
    clientIp: request()->ip()
);

Track a request

use Falcon\SwetrixLaravelTracking\Facades\Swetrix;

Swetrix::trackRequest(request());

Testing

composer install
vendor/bin/phpunit