如果当第三方网站希望集成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查询: