README

Laravel Google Analytics 4 Measurement Protocol

简介

此包允许您从Laravel后端向Google Analytics 4发送事件。

支持的Laravel版本

Laravel 7.x
Laravel 8.x
Laravel 9.x
Laravel 10.x

安装

在您的终端/cmd中运行此命令来安装包

composer require freshbitsweb/laravel-google-analytics-4-measurement-protocol

在您的.env文件中设置MEASUREMENT_ID和MEASUREMENT_PROTOCOL_API_SECRET。您可以从：Google Analytics > 管理员 > 数据流 > [选择站点] > 测量协议API密钥中获取它们
可选：您可以在终端/cmd中运行此命令来发布配置文件

php artisan vendor:publish --tag=google-analytics-4-measurement-protocol-config

client_id是向Google Analytics发送事件所必需的。此包提供了一个Blade组件，您可以将它放在布局文件中Google Analytics代码跟踪代码之后。它会对后端发出POST请求以将client id存储在会话中，稍后用于向Google Analytics 4发送事件。

<!-- Google Analytics Code -->
<x-google-analytics-client-id />
<!-- </head> -->

另一种选择是在每次调用postEvent()方法之前在GA4外观中调用setClientId($clientId)方法。

使用

您可以从后端的任何位置调用GA4::postEvent($eventData)来向Google Analytics 4发送事件。$eventData包含事件名称和参数，如此参考页面所示。例如

GA4::postEvent([
    'name' => 'login',
    'params' => [
        'method' => 'Google',
    ],
]);

postEvent()方法将返回一个包含请求状态的数组。

调试模式

您还可以通过在调用postEvent()方法之前调用enableDebugging()方法来启用调试模式。例如 - GA4::enableDebugging()->postEvent($eventData)。在这种情况下，postEvent()方法将返回来自Google Analytics请求的响应（数组）。

作者

Gaurav Makhecha - 初始工作

查看参与此项目的贡献者名单。

许可证

本项目采用MIT许可证 - 详细信息请参阅LICENSE文件

免费软件

您可以自由使用此包，但如果它进入您的生产环境，我将非常感谢您为世界买一棵树。

众所周知，解决气候危机并使气温保持在1.5C以下的最有效工具之一是种植树木。如果您为我们的森林做出贡献，您将为当地家庭创造就业并恢复野生动物栖息地。

您可以通过以下链接购买用于我们的森林的树木：offset.earth/treeware

有关Treeware的更多信息，请访问treeware.earth

特别感谢

Laravel 社区

freshbitsweb / laravel-google-analytics-4-measurement-protocol

维护者

详细信息