piwik 訪客跟蹤(一)
一、找到PIWIK跟蹤代碼
a>使用超級管理員登陸piwik後臺
b>點擊 ->設置(setting)按鈕進入管理界面
c>點擊 ->websites 按鈕 得到你用piwik跟蹤的網站
d>點擊->View Tracking Code 獲取到您要跟蹤的網站的跟蹤代碼
e> 將獲取的跟蹤js代碼復制到您想要跟蹤的網站的頁面，js代碼放在</body>標簽前面
piwik代碼如下方式：
<!-- 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_URL}替換成您piwik安裝的域名，http://localhost/
{$IDSITE} 替換成您跟蹤的網站，在piwik中生成的id
這段代碼和我們熟悉的js代碼比起來有點繁瑣，原因是他是異步的，也就是說，我們打開頁面的時候，不用等piwikjs代碼全部加載完成，才繼續執行我們的其他代碼，而延誤了展示我們自己頁面。為了實現異步方式跟蹤我們的頁面，將一些信息配置信息和跟蹤代碼被放入一個名叫_paq的全局數組中，來異步加載piwik.js代碼，格式如下：
_paq.push([ ‘API_method_name‘, parameter_list ]);
我們同樣可以將一個函數放入到_paq這個全局數組中，來執行這個函數，例如
var visitor_id;
_paq.push([ function() { visitor_id = this.getVisitorId(); }]);
或者，我們也可以獲取自定義的變量(name,value)，使用異步的代碼
_paq.push([‘setCustomVariable‘,‘1‘,‘VisitorType‘,‘Member‘]);
_paq.push([ function() { var customVariable = this.getCustomVariable(1); }]);
甚至可以在加載完piwik.js之後，像_paq中加入我們想要加入的參數
如果，生成的js代碼，和上邊的代碼有些出入，那麽強烈建議更新piwik的版本
以hxyxt的跟蹤代碼嵌入為例：
二、使用js跟蹤代碼的特性
1、在piwik中定制頁面的名字
默認情況下，piwik接口會使用頁面的url作為當前頁面的名字，如果我們的url很復雜，如果我們想要自己定制頁面的名稱，那麽我們可以在js代碼中指定我們自己想要的名字。
最常用的做法是設置HTML Title，我們可以簡單的利用js設定，像下面展示的代碼
[...] _paq.push([‘setDocumentTitle‘, document.domain + "/" + document.title]); _paq.push([‘trackPageView‘]);
[...]
如果您跟蹤的網站有多個子域名，我們也可以用如下js代碼，來制定多個字域名的名稱。
[...] _paq.push([‘setDocumentTitle‘, document.domain + "/" + document.title]); _paq.push([‘trackPageView‘]);
[...]
我們，同樣可以動態的生成頁面的名稱
[...] _paq.push([‘setDocumentTitle‘, "<?php echo $myPageTitle ?>"]); _paq.push([‘trackPageView‘]);
[...]
2、手動的觸發piwik的跟蹤頁面，通過頁面的點擊或者js的其他點擊事件
默認情況下，當加載並執行完頁面代碼後，piwik就會跟蹤我們要跟蹤的頁面，但是，我們比較新的網站或者一些web應用程序，用戶在網站的交互並不需要牽扯到加載一個新的頁面，例如，用戶點擊一個js的鏈接，或者點擊一個標簽（觸發js事件的標簽），或者使用一個元素來觸發用戶的接口，我們仍然可以跟蹤到這些交互，
為了跟蹤到每個動作，我們可以使用js的函數trackPageView()，比如想要跟蹤被點擊的按鈕
[...]
<a href="#" onclick="javascript:_paq.push([‘trackPageView‘, ‘Menu/Freedom‘]);">
Freedom page
</a>
3、手動觸發一個目標轉化
默認情況下，在piwik中目標被定義成“matching（匹配）”url的一部分（開始，包含的內容，或者正則），我們也可以跟蹤一個目標，比如，給定的頁面，下載，或者一個外鏈
某些情況下，我們可能會觸發一個轉化通過其他動作類型，比如
1，當一個用戶點擊submit（提交）表單的時候
2，當一個用戶停留在一個頁面（超過我們給定的時間）
3，當以用戶和flash應用程序交互過指定次數的時候
4，當一個用戶添加了購物車，並完成付款的時候。
我們可以利用下面相似的代碼
[...] _paq.push([‘trackGoal‘, 1]); // logs a conversion for goal 1 [...]
我們甚至可以為某個收入定制一個目標轉化，例如：我們可以調用trackGoal，動態設置交易的收入
[...] // logs a conversion for goal 1 with the custom revenue set _paq.push([‘trackGoal‘, 1, <?php echo $cart->getCartValue(); ?>]); [...]
可以在http://piwik.org/docs/tracking-goals-web-analytics/中獲取更多的關於目標跟蹤的信息。
跟蹤電子商務訂單，購物車的更新和商品/分類頁piwik提供了高級，並有效的電子商務跟蹤，查看http://piwik.org/docs/ecommerce-analytics/頁面獲取更多關於電子商務報告和如何設置電子商務跟蹤。
4、跟蹤內部搜索的關鍵詞，類別和沒有搜索到結果的關鍵詞
piwik提供了高級特性Site Search Analytics來跟蹤我們網站上用戶的搜索習慣，默認情況下，piwik讀取url中的參數來獲取搜索的關鍵字，但是我們也可以通過函數trackSiteSearch(…)來手動記錄搜索的關鍵字
我們可以通過函數piwikTracker.trackPageView().在搜索結果頁面Tracker.trackSiteSearch(keyword, category, searchCount)函數來記錄內部搜索的請求，‘keyword‘參數是必須的，category和searchCount是可選的。
_paq.push([‘trackSiteSearch‘,
"Banana", // Search keyword searched for
"Organic Food", // Search category selected in your search engine. If you do not need this, set to false
0 // Number of results on the Search results page. Zero indicates a ‘No Result Search Keyword‘. Set to false if you don‘t know
]); // We recommend not to call trackPageView() on the Site Search Result page
// _paq.push([‘trackPageView‘]);
[...]
以hxyxt搜索嵌入代碼為例：
5、自定義變量
自定義變量是piwik非常有用的特性，它可以使你跟蹤頁面上任何一個自定義變量，我們可以通過Tracking custom variables 來獲取更多的信息
我們可以設定5個自定義變量，(name and value)為訪問我們網站的每個用戶。如果我們為某個用戶設定了自定義變量，那麽當他一個小時或一天在回來我們網站的時候，那麽這個用戶將被當成一個新的用戶，他原來相關的數據都會清空。
有兩個"scopes"可以讓我們設定我們自定義的變量，這個“scope“是setCustomVariable的第四個參數。
1，scope = “visit”的時候，自定義變量的名字和值會存儲在數據庫中，
2，scope = “page”得時候，自定義變量將會存儲在頁面中而被跟蹤，
我們可以在Visitors > custom variables下面看到關於自定義變量的相關數據。在這個報告中，將”visit“ 和”page“整合在一起顯示。
為訪客設置自定義的變量
setCustomVariable (index, name, value, scope = "visit")
這個函數的功能用來創建，或者更新自定義變量名字或值的函數，假設，我們想將每個用戶的性別存儲起來，我們將會用name="gender"，value="male" 或者value="female" 來存儲用戶的名字，性別等信息
提示：
自定義變量的名字必須存儲為相同的索引，比如，如果我們想要選擇存儲這個自定義變量name = “Gender”用的索引值 index=1,如果我們想要存儲另外一個變量在index=1，那麽gender這個變量將會別刪除並且會被新的自定義變量替換。
[...] _paq.push([‘setCustomVariable‘, 1, // Index, the number from 1 to 5 where this custom variable name is stored "Gender", // Name, the name of the variable, for example: Gender, VisitorType "Male", // Value, for example: "Male", "Female" or "new", "engaged", "customer" "visit" // Scope of the custom variable, "visit" means the custom variable applies to the current visit ]); _paq.push([‘trackPageView‘]);
[...]
我們僅僅使用scope "visit"設置自定義變量一次，然後這個變量將會應用戶所有的用戶。
為Page view 設置一個自定義變量
setCustomVariable (index, name, value, scope = "page")
就像我們為“vistors”設置的自定變量一樣，對每個分開的頁面設置自定義變量是非常有用的。例如：一個新的新聞網站或者博客，一篇文章可能被劃分到多個分類中去，在這種情況下，我們可以設置一個或者多個自定義變量，例如：一篇文章如果被分在Sports，Europe 這個分類中，那麽我們可以做如下的操作： name=”category”，value=”Sports”，value=”Europe”。這個自定變量將會告訴我們當訪客進入我們網站的時候，訪客的訪問次數以及訪問了那些分類。這些信息使用標準的piwik報告來顯示是很苦難的，因為 “Best Page URLs”， “Best Page Titles”可能不會包含有這些分類信息。
[...] // Track 2 custom variables with the same name, but in different slots. // You will then access the statistics about your articles‘ categories in the ‘Visitors > custom variables‘ report _paq.push([‘setCustomVariable‘, 1, ‘Category‘, ‘Sports‘, ‘page‘]); _paq.push([‘setCustomVariable‘, 2, ‘Category‘, ‘Europe‘, ‘page‘]); // Track the same name but in a different Index // Here you could track other custom variables with scope "page" in Index 3, 4 or 5 // The order is important: first setCustomVariable is called and then trackPageView records the request _paq.push([‘trackPageView‘]);
[...]
提示：
我們使用自定義變量片段設定“visit”使用“index”1是合理的，並且存儲不同的自定義變量存儲page 使用索引值為1是合理的。
[...] _paq.push([‘setCustomVariable‘, 1, // Index, the number from 1 to 5 where this custom variable name is stored for the current page view "category", // Name, the name of the variable, for example: Category, Sub-category, UserType "Sports", // Value, for example: "Sports", "News", "World", "Business", etc. "page" // Scope of the custom variable, "page" means the custom variable applies to the current page view ]); _paq.push([‘trackPageView‘]);
[...]
刪除一個自定義變量：
deleteCustomVariable (index, scope )
如果我們創建了一個自定義變量，然後我們想要將它從用戶，或者頁面刪除，我們們可以使用函數：deleteCustomVariable來刪除它
在刪除某個自定變量的時候，為了使服務器也能生效，我們必須在調用 trackPageView()之前，做如下操作：
[...] _paq.push([‘deleteCustomVariable‘, 1, "visit"]); // Delete the variable in index 1 stored for the current visit
_paq.push([‘trackPageView‘]);
[...]
獲取自定義變得名字和值：
getCustomVariable (index, scope )
這個函數經常使用的時"scope" = "visits"的時候
在這種情況下，自定義變量將會被記錄在cookie的第一部分（保存30分鐘內最後一個訪問的用戶），我們也可以通過piwikTracker.getCustomVariable函數來獲取到自定義變量。如果在index頁面中沒有自定義變量，那麽它的返回值為false
[...] _paq.push([ function() {
var customVariable = this.getCustomVariable( 1, "visit" ); // Returns the custom variable: [ "gender", "male" ]
// do something with customVariable...
}]);
_paq.push([‘trackPageView‘]);
[...]
為域名和子域名設置cookie
piwik使用first-party來保存一些信息（訪客數量，原始的鏈接，和唯一的訪客id）。
piwik為每個域名和子域名創建了一組cookie。如果我們想跟蹤子域名並且分享相同的cookie來使我們的數據更加準確，我們就需要定制piwik的代碼。
如果我們用一個網站來跟蹤一個域名或者子域名
這個是piwik標準的用法， piwik跟蹤訪客使用一個域名而沒有子域名
[...] // Default Tracking code
_paq.push([‘setSiteId‘, 1]);
_paq.push([‘setTrackerUrl‘, u+‘piwik.php‘]);
_paq.push([‘trackPageView‘]);
[...]
如果我們使用一個網站來更總一個域名和多個子域名
如果我們想把子域名的用戶向主域名一樣記錄訪客，我們同時也想將cookie在多個域名之間共享，我們可以在所有的子域名使用函數
setCookieDomain()
[...]
_paq.push([‘setSiteId‘, 1]);
_paq.push([‘setTrackerUrl‘, u+‘piwik.php‘]);
// Same cookie as: example.com, www.example.com, subdomain.example.com, ...
_paq.push([‘setCookieDomain‘, ‘*.example.com‘]);
_paq.push([‘setDomains‘, ‘*.example.com‘]); // Download & Click tracking alias domains
_paq.push([‘trackPageView‘]);
[...]
如果我們想要在不同的piwik網站跟蹤域名下的子文件或者頁面
默認情況下，piwik通常使用一個cookie為一個域名，以及域名下的所有目錄和頁面
當時有種情況是，如果一個訪客訪問了一個域名下的多個子目錄，那麽我們可以將網站下的某個子目錄和網站分開來統計
[...]
// idSite = X for the Homepage
_paq.push([‘setSiteId‘, X]);
_paq.push([‘setTrackerUrl‘, u+‘piwik.php‘]);
_paq.push([‘trackPageView‘]);
[...]
在/user/myusername 頁面我們將加上如下代碼：
[...]
// The idSite Y will be different from other user pages
_paq.push([‘setSiteId‘, Y]);
_paq.push([‘setTrackerUrl‘, u+‘piwik.php‘]);
_paq.push([‘setCookiePath‘, ‘/user/MyUsername‘]);
_paq.push([‘trackPageView‘]);
[...]
piwik 訪客跟蹤(一)