krizon / php-ga-measurement-protocol
在 PHP 中轻松使用 Google Analytics 测量协议
v1.0.0
2015-10-09 20:22 UTC
Requires
- guzzle/guzzle: ~3.7
Requires (Dev)
- phpunit/phpunit: >=3.7.28
Suggests
- ramsey/uuid: Generate RFC 4122 UUID with PHP.
This package is not auto-updated.
Last update: 2024-09-24 00:26:20 UTC
README
一个功能齐全的 PHP 客户端,用于 Google Analytics 测量协议 API。建立在伟大的 Guzzle 之上。
查看 https://developers.google.com/analytics/devguides/collection/protocol/v1/devguide
安装
使用 Composer 将此库添加到依赖项
$ composer require krizon/php-ga-measurement-protocol
功能
- 页面跟踪
- 事件跟踪
- 电子商务跟踪
- 社交互动跟踪
- 异常跟踪
- 用户时间跟踪
- 应用跟踪
- 非阻塞请求(待办事项)
使用方法
$config = array( 'ssl' => true // Enable/Disable SSL, default false ); $client = Krizon\Google\Analytics\MeasurementProtocol\MeasurementProtocolClient::factory($config); $client->pageview(array( 'tid' => 'UA-XXXX-XXXX', // Tracking Id 'cid' => 'XXXX-XXXXX-XXXXX', // Customer Id 'dh' => 'domain.do', 'dp' => '/php-ga-measurement-protocol/phpunit-test', 'dt' => 'PHP GA Measurement Protocol' ));
测试
在运行测试之前,请确保您已使用 composer 安装了依赖项
$ composer install
PHPUnit 本身已包含在依赖项中,因此现在您可以调用
$ vendor/bin/phpunit
我们有两种类型的测试
- 带有模拟 200 OK 响应的测试,@group
__nogroup__
。这类测试用于测试所需字段、断言类类型等; - 对 Google API 进行实际调用的测试,@group
internet
。Google API 本身总是返回 200 OK,因此为了确保请求已正确传输和处理,您可以通过运行 'internet' 组的测试来验证。在运行此组之前,请确保您已通过设置环境变量tracking_id
在 phpunit.xml 配置中配置了正确的跟踪 ID。此组默认排除,但您可以通过调用:$ vendor/bin/phpunit --group internet
来运行这些测试。