binarcode/laravel-segment

Laravel对Segment API和事件跟踪的封装。

1.0.0 2023-02-20 14:19 UTC

README

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

Segment简化了收集数据和新工具连接的过程,让您有更多时间使用数据,而不是收集数据。您可以使用Segment跟踪用户与界面交互时发生的事件。“界面”是Segment对您拥有的任何数字属性的通用术语:您的网站、移动应用以及运行在服务器或OTT设备上的进程。

官方文档

安装

您可以通过composer安装此包

composer require binarcode/laravel-segment

您可以使用以下命令发布并运行迁移

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

您可以使用以下命令发布配置文件

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

这是已发布配置文件的内容

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', ''),
];

使用方法

跟踪事件

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

将匿名ID映射到真实用户ID

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

Segment Identify

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

Segment Identify调用允许您将用户与其操作关联起来,并记录有关他们的特征。它包括一个唯一的用户ID和任何关于用户的可选特征,如电子邮件、姓名等。

测试

composer test

变更日志

请参阅CHANGELOG以获取有关最近更改的更多信息。

贡献

请参阅CONTRIBUTING以获取详细信息。

安全漏洞

请参阅我们的安全策略了解如何报告安全漏洞。

鸣谢

许可证

MIT许可证(MIT)。请参阅许可证文件以获取更多信息。