Piwik 追踪API
JavaScript客户端的跟踪API
这是默认推荐的客户端。 了解更多: developer.piwik.org/api-reference/tracking-javascript
使用JavaScript客户端适用于大多数用户,只需要在页面页脚粘贴Javascript代码,这个应该很简单吧!
跟踪API客户端
有时候你不能使用JavaScript跟踪数据。 无论您开发的iOS应用,Android应用,或者用PHP编写的应用程序,Java和C#或Python都可以跟踪Piwik数据。
了解更多在跟踪客户端API和SDK
跟踪API文档参考
如果你不使用JavaScript,PHP,Java和Python和C#或Objective - C,你仍然可以直接调用通过HTTP跟踪的Web API。
在 跟踪的Web API参考 记录了跟踪API的各种参数和特性。
用例:使用PHP客户端跟踪数据
现在我们将看看使用php客户端来记录Piwik数据。 在下文中,需要替换{$ IDSITE}为您的Piwik网站ID,并用您的Piwik URL替换http://piwik.example.org/。
图像跟踪代码
在不允许JavaScript的时候,可以使用图像跟踪代码。
像MySpace和eBay的一些网站不允许用户添加JavaScript到他们的个人资料,但接受HTML。 在这种情况下,您仍然可以追踪使用Piwik图像跟踪访问。 注 :该代码不使用JavaScript所以Piwik将无法追踪某些用户信息,例如搜索关键词,引荐,屏幕分辨率,浏览器插件和页面标题。
<!-- Piwik Image Tracker --> <img src="http://piwik.example.org/piwik.php?idsite={$IDSITE}amp;rec=1" style="border:0" alt="" /> <!-- End Piwik -->
下面的参数也可以被传递到图片网址:
- REC - (必需)参数与REC = 1要求强制要求被记录
- idsite - (必需)定义网站的ID被跟踪
- ACTION_NAME -定义自定义页面标题查看此页面
- urlref -参照网址:必须设置登陆包含图像跟踪器在页面上之前使用的引荐网址。 例如,在PHP这个值是通过访问
$_SERVER['HTTP_REFERER']
- idgoal - 请求触发给定目标
- revenue -用于idgoal,定义了定制营收为这种转换
- bots -设置&bots=1来跟踪的跟踪图像的所有请求,其中包括机器人和机器人
- 更多参数![请参阅跟踪API文档页面](http://developer.piwik.org/api-reference/tracking-api
Piwik跟踪API(高级用户)
使用自己喜欢的编程语言来调用Piwik跟踪API。
请按照以下说明开始使用PHP的Web跟踪API客户:
- 点击此处下载文件PiwikTracker.php
- 上传PiwikTracker.php文件到相同的路径作为您的项目文件
复制下面的代码,然后将其粘贴到您要跟踪的每一页。
<?php // -- Piwik Tracking API init -- require_once "/path/to/PiwikTracker.php"; PiwikTracker::$URL = 'http://piwik.example.org/'; ?>
- 选择一个跟踪方法,然后将代码粘贴到您要跟踪的每一页。
- 方法1:先进的图像跟踪器
客户端是用来产生该包裹一个HTML代码内的跟踪网址。 在网页上的代码在此之前的代码粘贴。
<?php // Example 1: Tracks a pageview for Website id = {$IDSITE} echo '<img src="'. str_replace("&","&", Piwik_getUrlTrackPageView( $idSite = {$IDSITE}, $customTitle = 'This title will appear in the report Actions > Page titles')) . '" alt="" />'; // Example 2: Triggers a Goal conversion for Website id = {$IDSITE} and Goal id = 2 // $customRevenue is optional and is set to the amount generated by the current transaction (in online shops for example) echo '<img src="'. str_replace("&","&", Piwik_getUrlTrackGoal( $idSite = {$IDSITE}, $idGoal = 2, $customRevenue = 39)) . '" alt="" />'; ?>
高级图像跟踪方法类似于使用标准的JavaScript跟踪代码。 然而某些用户设置(分辨率,当地时间插件和cookie支持)可能检测不到。
- 方法2:HTTP请求
您也可以通过远程HTTP查询Piwik跟踪API。 对于你可以不执行HTML和JavaScript的环境非常有用。
在这里要跟踪用户交互这段代码
<?php $piwikTracker = new PiwikTracker( $idSite = {$IDSITE} ); // You can manually set the visitor details (resolution, time, plugins, etc.) // See all other ->set* functions available in the PiwikTracker.php file $piwikTracker->setResolution(1600, 1400); // Sends Tracker request via http $piwikTracker->doTrackPageView('Document title of current page view'); // You can also track Goal conversions $piwikTracker->doTrackGoal($idGoal = 1, $revenue = 42); ?>
More information
See also these related FAQ entries
- Does Piwik track visitors without Javascript?
- How is a ‘unique visitor’ counted in Piwik?
- How do I track visits on my intranet?
- Can I install Piwik on one server and track visits on websites that are hosted on other servers?
- Doc: Tracking API reference