Skip to content

A Laravel wrapper for the Segment API and events tracking.

License

Notifications You must be signed in to change notification settings

BinarCode/laravel-segment

Repository files navigation

A Laravel wrapper for the Segment API and events tracking.

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

Segment simplifies the process of collecting data and connecting new tools, allowing you to spend more time using your data, and less time trying to collect it. You can use Segment to track events that happen when a user interacts with the interfaces. “Interfaces” is Segment’s generic word for any digital properties you own: your website, mobile apps, and processes that run on a server or OTT device.

Installation

You can install the package via composer:

composer require binarcode/laravel-segment

You can publish and run the migrations with:

php artisan vendor:publish --tag="segment-migrations"
php artisan migrate

You can publish the config file with:

php artisan vendor:publish --tag="segment-config"

This is the contents of the published config file:

return [
    /**
     * The queue name where the segment events will be dispatched.
     */
    'queue' => env('SEGMENT_QUEUE', env('QUEUE_CONNECTION', 'sync')),

    /**
     * Segment API key [see: https://segment.com/docs/connections/sources/catalog/libraries/server/php/#identify].
     */
    'key' => env('SEGMENT_KEY', ''),
];

Usage

Track event

BinarCode\LaravelSegment\Facades\LaravelSegment::track('click')->properties([...])

Alias anonymous id to a real user id

BinarCode\LaravelSegment\Facades\LaravelSegment::alias($previous, $userId);

The Segment Identify

BinarCode\LaravelSegment\Facades\LaravelSegment::identify($userId, $data);

The Segment Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and any optional traits you know about the user, like their email, name, and more.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.

About

A Laravel wrapper for the Segment API and events tracking.

Resources

License

Security policy

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Languages