Piwik-JavaScript的跟踪客户端操作方法 (官方文档翻译)

Piwik配备了强大的JavaScript跟踪API。高级用户可以使用Piwik的跟踪代码来自行定制一些用于网站分析的数据，并将数据记录在Piwik中。

要使用自定义参数的功能，你需要使用piwik跟踪代码的最新版本。找到你的网站的跟踪代码，并按照下列步骤操作：

1．登录到Piwik与您的管理员或超级用户帐户

2．点击设置进入管理区

3．点击网站列出您跟踪Piwik网站

4．点击查看跟踪代码，您要跟踪的网站

现在，您可以复制并粘贴JavaScript代码到你要检测的网页，注意，追踪代码需要在</ body>标记之前。

这段代码类似于：

<!-- Piwik -->
<script type="text/javascript">
    var _paq = _paq || [];
    (function(){ var u=(("https:" == document.location.protocol) ? "https://{$PIWIK_URL}/" : "http://{$PIWIK_URL}/");
    _paq.push(['setSiteId', {$IDSITE}]);
    _paq.push(['setTrackerUrl', u+'piwik.php']);
    _paq.push(['trackPageView']);
    _paq.push(['enableLinkTracking']);
    var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; g.type='text/javascript'; g.defer=true; g.async=true; g.src=u+'piwik.js';
    s.parentNode.insertBefore(g,s); })();
</script>
<!-- End Piwik Code -->

在你自己的Piwik跟踪代码中，{$ PIWIK_URL}部分将由你实际的Piwik URL来替换，{$ IDSITE}将由你的跟踪网站的idsite所取代。

由于这段代码是异步运行，因此并不像那些我们常见的JavaScript代码。换句话说，当你浏览网页时，浏览器不会等待piwik.js文件下载。

对于异步跟踪，配置和跟踪由全局变量_paq数组来执行，使用单独的异步方式加载piwik.js。格式为：

_paq.push([ 'API_method_name', parameter_list ]);

你也可以在push函数中添加一些方法来执行，例如：

var visitor_id;
_paq.push([ function() { visitor_id = this.getVisitorId(); }]);

或者抓取使用异步代码抓取一些用户变量，例如：

_paq.push(['setCustomVariable','1','VisitorType','Member']);
_paq.push([function()
{ var customVariable = this.getCustomVariable(1); }]);

即使piwik.js文件已经加载并运行。你依然可以使用push函数调用到_paq数组的值

如果您的Piwik跟踪代码看起来和本文的代码不同，可能您使用的是旧的版本。旧版本依然可以正常运行，并会跟踪您网站的访客，但我们强烈建议您更新您的piwik系统，并使用最新的跟踪代码。