jiririedl/google-analytics

Google分析API客户端

1.2.1 2014-12-01 15:33 UTC

This package is auto-updated.

Last update: 2024-09-15 18:14:59 UTC


README

2013年10月5日:php-ga是从Google Code迁移过来的,在那里它有8,000+次下载和160+个星标。

注意:由于Google最终发布了官方的服务端跟踪API:测量协议,因此php-ga不再维护!我还没有找到任何针对PHP的良好实现的客户端库,所以请自由帮助将php-ga 2.0打造成一个测量协议PHP客户端库。

您可能还对配套项目php-gacx感兴趣,该项目用于Google分析内容实验。

关于

php-ga基本上是ga.js在PHP中的实现:一个在PHP中实现的通用服务器端Google分析客户端,它实现了原始GA JavaScript客户端几乎所有的参数和跟踪功能。这意味着您可以直接从您的服务器发送数据到Google分析,绕过用户的浏览器。

我喜欢Google分析,并希望通过这个PHP客户端实现为它的社区做出贡献。它旨在独立使用或与现有的JavaScript库实现一起使用。

它是PHP,但将其移植到其他语言应该很容易(下面是Python的移植)。构建这个库涉及到几周的时间阅读文档、搜索和测试——因此它的源代码被彻底地文档化了。

PHP客户端与数据导出管理API无关,尽管您当然可以组合使用它们。

要求

需要PHP 5.3+,因为使用了命名空间和闭包。没有其他依赖项,并且可以独立于任何框架或任何环境使用。

支持的功能

当前版本基于官方JavaScript客户端库的5.2.5版本,有关详细信息,请参阅CHANGELOG文件。

  • 页面视图跟踪
  • 事件跟踪
  • 自定义变量跟踪
  • 电子商务跟踪
  • 活动跟踪
  • 社交互动跟踪
  • 网站速度跟踪

问题

  • 100%命名空间OOP理所当然。

  • 完全抽象化,不受任何环境限制不依赖于任何全局变量,如$_SERVER、PHP会话等——按照您想要的方式实现。

  • 高性能跟踪可以配置通过register_shutdown_function()队列请求,并使用非阻塞请求。

  • 可能是GA最全面的技术文档超过50%的源代码行是PHPDoc和内联注释!

注意事项

  • Google分析的地域功能将不会工作原生的地域功能,如世界地图视图将不再工作,因为这些功能完全依赖于GA客户端的IP地址——当使用此库时,该IP地址始终是您的服务器。

使用示例

一个非常基本的页面视图跟踪示例

use UnitedPrototype\GoogleAnalytics;

// Initilize GA Tracker
$tracker = new GoogleAnalytics\Tracker('UA-12345678-9', 'example.com');

// Assemble Visitor information
// (could also get unserialized from database)
$visitor = new GoogleAnalytics\Visitor();
$visitor->setIpAddress($_SERVER['REMOTE_ADDR']);
$visitor->setUserAgent($_SERVER['HTTP_USER_AGENT']);
$visitor->setScreenResolution('1024x768');

// Assemble Session information
// (could also get unserialized from PHP session)
$session = new GoogleAnalytics\Session();

// Assemble Page information
$page = new GoogleAnalytics\Page('/page.html');
$page->setTitle('My Page');

// Track page view
$tracker->trackPageview($page, $session, $visitor);

链接

感谢Matt Clarke提供的两篇优秀的文章/教程

免责声明

谷歌分析是谷歌公司的注册商标。