README

关于

sanskritick/matomo-tracker Laravel包是matomo/matomo-php-tracker的封装。Matomo php tracker允许服务器端跟踪。

特性

• MatomoTracker Facade
• 在Laravel队列中排队跟踪请求

欢迎提出新特性建议。

安装

通过Composer

在您的composer.json中要求sanskritick/matomo-tracker包，并更新您的依赖项

composer require sanskritick/matomo-tracker

发布配置文件（可选）

运行php artisan vendor:publish以发布配置文件（如果需要）。

php artisan vendor:publish

更新您的.env

将这些变量添加到您的.env文件中，并配置以适应您的环境。

[...]
MATOMO_URL="https://your.matomo-install.com"
MATOMO_SITE_ID=1
MATOMO_AUTH_TOKEN="00112233445566778899aabbccddeeff"
MATOMO_QUEUE="matomotracker"
[...]

这就完成了！

使用

您可以使用facade进行跟踪。

MatomoTracker::doTrackPageView('Page Title')

跟踪

基本功能

请参阅[Matomo Tracker页面以获取基本方法文档。

此外，还有一些简化使用的函数

// instead of using 
MatomoTracker::doTrackAction($actionUrl, 'download') // or
MatomoTracker::doTrackAction($actionUrl, 'link')

// you can use this
MatomoTracker::doTrackDownload($actionUrl);
MatomoTracker::doTrackOutlink($actionUrl);

队列

对于队列，您可以使用以下函数。

MatomoTracker::queuePageView(string $documentTitle)
MatomoTracker::queueEvent(string $category, string $action, $name = false, $value = false)
MatomoTracker::queueContentImpression(string $contentName, string $contentPiece = 'Unknown', $contentTarget = false)
MatomoTracker::queueContentInteraction(string $interaction, string $contentName, string $contentPiece = 'Unknown', $contentTarget = false)
MatomoTracker::queueSiteSearch(string $keyword, string $category = '',  $countResults = false)
MatomoTracker::queueGoal($idGoal, $revencue = 0.0)
MatomoTracker::queueDownload(string $actionUrl)
MatomoTracker::queueOutlink(string $actionUrl)
MatomoTracker::queueEcommerceCartUpdate(float $grandTotal)
MatomoTracker::queueEcommerceOrder(float $orderId, float $grandTotal, float $subTotal = 0.0, float $tax = 0.0, float $shipping = 0.0,  float $discount = 0.0)
MatomoTracker::queueBulkTrack()

有关设置队列的文档，请参阅Laravel Queues。

设置

请参阅[Matomo Tracker页面以获取基本设置文档。

此外，以下设置可用

MatomoTracker::setCustomDimension(int $id, string $value) // only applicable if the custom dimensions plugin is installed on the Matomo installation
MatomoTracker::setCustomDimensions([]) // array of custom dimension objects {id: <int>, value: <string>} // bulk insert of custom dimensions and basic type checking
MatomoTracker::setCustomVariables([]) // array of custom variable objects {id: <int>, name: <string>, value: <string>, scope: <string>} // bulk insert of custom variables and basic type checking

变更日志

请参阅changelog以获取最近更改的更多信息。

贡献

请参阅contributing.md以获取详细信息及待办事项清单。

安全

请参阅security.md以获取详细信息及待办事项清单。

许可证

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