如果當第三方網站希望集成bShare分享按鈕時,可以按照其網站自身的用戶來進行統計,可以使用本文檔描述的用戶集成數據統計功能。開啟此功能后,站長可以在bShare統計中了解到是那個用戶分享的最多,帶來的回流量最多。甚至可以針對某一此活動或者某一部分版塊進行此類統計。
首先頁面上需要有bShare的按鈕。在引入bShare的JS嵌入代碼后,在頁面中使用bShare.addEntry()設置相關參數:
一旦bShare檢測到vUid參數,即會開始統計用戶集成數據。
如果站長同時也啟用了回流量統計,那除了回流統計的參數,用戶分享的鏈接還會添加一個參數bsh_vuid。當有用戶點擊了這個分享的鏈接回到頁面上后,站長可以根據需要使用此參數。例如,統計此次回流是否有后繼的購買或者注冊行為等等。
如果您是Pro用戶,登錄后在bShare后臺數據統計部分可以看到意見領袖分析的頁面:
在這里您可以查看每個用戶的分享數據、回流數據以及相關平臺排名,您也可以根據vUid、vTag及vEmail進行查詢。
除了在bShare的后臺直接查詢,您也可以通過我們提供的API訪問這些數據。
請求鏈接
通過HTTP BASIC Authentication方式進行認證,使用該UUID所有者在bShare網站的用戶名和密碼即可。
GET請求
所有的路徑參數都是必需的。
publisherUUID | 您想獲取統計數據的站點的UUID。 |
type | 請求的類型,可以使user或者platform,即user_query.json和platform_query.json platform: 返回平臺統計信息。包括排名序號、用戶id、分享總數、回流總數。 user: 返回用戶統計信息。包括排名序號、平臺名稱、分享總數、回流總數。 |
所有的查詢參數都為可選。請注意:如果您未設置該參數,我們將按照下面羅列出的默認值提供查詢結果。
vTag | 按照vTag進行查詢。 如果該值沒有被設置或者設置為無效的值,將依據publisherUUID進行統計。 |
dateStart | 查詢數據的起始日期 (含該日)。該日期值必須為以下格式: yyyy-mm-dd. 如果沒有設置該值或者被設定為無效的值, dateStart將默認為今天。 |
dateEnd | 查詢數據的終止日期 (含該日)。該日期必須為以下格式: yyyy-mm-dd. 如果沒有設置該值或者被設定為無效的值, dateEnd將默認為dateStart之前7天。 |
locale | 返回數據的語言??墒褂玫闹涤?zh| zh_TW| en。 如果沒有設置該值或者設定為無效的值,locale將默認為中文(zh)。 |
order | 按照分享次數排名時,設置值為shares;按照分享回流排名時,設置值為clickback。如果該值沒有被設置或者設置為無效的值,order將默認為shares。 |
number | 獲得排名的前 |
如果出錯,返回對應的HTTP狀態碼及錯誤信息;否則,HTTP狀態碼為200。
返回JSON格式的數據列表。該列表的根元素為"analytics",列表包含屬性 "shares","clickback","seq" 以及屬性 "metric" 或者 "vUid"、"vTag" 二者。
其中seq是排名的順序。metric的值是平臺名稱(如果請求的type為platform)。
user_query.json查詢:
platform_query.json查詢: