如果当第三方网站希望集成bShare分享按钮时,可以按照其网站自身的用户来进行统计,可以使用本文档描述的用户集成数据统计功能。开启此功能后,站长可以在bShare统计中了解到是那个用户分享的最多,带来的回流量最多。甚至可以针对某一此活动或者某一部分版块进行此类统计。

页面集成

首先页面上需要有bShare的按钮。在引入bShare的JS嵌入代码后,在页面中使用bShare.addEntry()设置相关参数:

bShare.addEntry({
    // 此处可以设置title, summary等参数,如果需要的话
    vUid: "用户在第三方网站的唯一的ID,只有包含这个参数,bShare才会统计用户相关数据",
    vEmail: "用户的Email",
    vTag: "标志,可以对不同的活动或者不同的版块设置不同的标志,以便分开查询数据。"
});

一旦bShare检测到vUid参数,即会开始统计用户集成数据。

如果站长同时也启用了回流量统计,那除了回流统计的参数,用户分享的链接还会添加一个参数bsh_vuid。当有用户点击了这个分享的链接回到页面上后,站长可以根据需要使用此参数。例如,统计此次回流是否有后继的购买或者注册行为等等。

数据查看

如果您是Pro用户,登录后在bShare后台数据统计部分可以看到意见领袖分析的页面:

在这里您可以查看每个用户的分享数据、回流数据以及相关平台排名,您也可以根据vUid、vTag及vEmail进行查询。

数据API

除了在bShare的后台直接查询,您也可以通过我们提供的API访问这些数据。

请求

请求链接

http://api.bshare.cn/analytics/<publisherUUID>/<type>_query.json
[?vTag=<vTag>][&dateStart=<dateStart>][&dateEnd=<dateEnd>]
[&locale=<locale>][&order=<order>][&number=<number>]

认证方式

通过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获得排名的前位,如果该值没有被设置或者设置为无效的值,number默认为10。

响应

响应头

如果出错,返回对应的HTTP状态码及错误信息;否则,HTTP状态码为200。

返回数据格式

返回JSON格式的数据列表。该列表的根元素为"analytics",列表包含属性 "shares","clickback","seq" 以及属性 "metric" 或者 "vUid"、"vTag" 二者。

其中seq是排名的顺序。metric的值是平台名称(如果请求的type为platform)。

返回数据范例

user_query.json查询:

{"analytics":[
    {"shares":80,"vUid":111,"seq":1,"clickbacks":80},
    {"shares":70,"vUid":222,"seq":2,"clickbacks":70}
]}

platform_query.json查询:

{"analytics":[
    {"shares":100,"metric":"新浪微博","seq":1,"clickbacks":100},
    {"shares":90,"metric":"QQ空间","seq":2,"clickbacks":90}
]}
注册
安装bShare
分享按钮自定义
站长设置
bShare API
分享平台代码参考
分享优化功能设置
常见问题
京ICP备13006473号-8
© 2009-2017 爱点击互动(北京)广告有限公司。版权所有。
a buzzinate company