Piwik 追踪API 各种 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("&","&amp;", 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("&","&amp;", 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