Skip to content

Home

Jump to bottom
Tennyleaz edited this page Aug 29, 2018 · 9 revisions

Welcome to the PiwikClientTest wiki!
要從零開始安裝 Matomo(舊稱 Piwik) server，可以參照這篇 wiki 的(1)~(4)步。第(5)步是安裝GeoIP插件用的，不一定每個人都需要用到。
本篇 wiki 寫於 ubuntu server 16.04 版本，桌面版可能可以省略一些安裝包。

環境

這篇文章將會安裝：

  1. apache2和PHP7，用來執行 Matomo(Piwik) 的網頁伺服器，並接收 Client 端傳送過來的紀錄。
  2. MySQL，用來儲存每一筆紀錄的資料庫。
  3. Matomo 主程式。
  4. GeoIP(PECL)是 Matomo(Piwik) 伺服器裡面一個可選的 PHP 插件，用來判斷 Client 端的IP所在的地理位置。(新版的Matomo伺服器網頁已有更快的安裝方式可以取代了)

本篇撰寫時，所使用的版本各為：

  • Ubuntu server 16.04 LTS
  • apache 2.4.18
  • PHP 7.0.22
  • Piwik 3.2.0

原理

Piwik Server 會記錄 Client 傳給他的 URL 資訊。利用 URL 的分層結構，我們可以方便的看出每個分類的子功能被點擊/執行的數量。
例如我們想記錄程式MyApp，版本1.1.0，設定功能底下的一般設定功能被點擊了一次，我們可以產生如下的網址：

http://MyApp/v1.1.0/Setting/GeneralSetting/Click

再加上一些其他資訊後，實際送出的 http request 可能長這樣：

https://10.10.12.39/piwik.php?
idsite=1&
rec=1&
apiv=1&
r=923916&
uid=使用者名稱&
_idvc=0&
res=1920x1080&
_id=48181acd22b3edae&
url=http://MyApp/v1.1.0/Setting/GeneralSetting/Click&
action_name=我的標題

Piwik 伺服器收到一個包含以上 URL 的資訊後，會將之解析為網站MyApp的一筆點擊資料。

額外資訊

除了 URL，Client 能額外告訴 Piwik Server 的資訊有不少種。比方說，瀏覽器的 UserAgent 資料可以揭露 Client 端的作業系統、語言等，Piwik Client API 還有解析度、載入時間...等記錄用函數可以額外呼叫。
在此提出比較關鍵的、對於開發可能有幫助的幾項：

  • User ID - 一個獨立字串，可以分辨不同使用者。沒有指定的話，Piwik 伺服器會將同一個 IP 在短時間內的訪問視為同一位匿名使用者。
  • 瀏覽器語言 - 例如zh-TW，可以用來當作 Client App 語言的辨識。
  • 作業系統 - 例如Windows 10。
  • 解析度 - 例如1920*1080。
  • 裝置類型 - 利用品牌與型號等資料，Piwik 會顯示訪問者的裝置。
  • 自訂變數 - 每個網站，Piwik 允許五個自訂變數。
  • 進/出頁面 - 使用者來自哪個頁面，前往哪個頁面
  • 站內搜尋關鍵字
  • 載入時間

以下圖例顯示了一個使用者，ID 是 bob，正在使用 Windows 10 的桌上型電腦

將滑鼠移動到國旗上，可以看到他的詳細資料如下圖：

Clone this wiki locally