获取用户维度下按天统计的播放比例
更新时间:2023-03-28
1. v3版本
接口描述
该接口用于获取用户维度下按天统计的播放比例数据,该版本接口返回结果中增加了微信小程序终端相关的数据内容。
请求地址
https://spark.bokecc.com/api/stats/attention/user/daily/v3
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
userid |
String |
是 |
用户ID。 |
start_date |
String |
是 |
查询开始日期(含),日期不能超过查询结束日期,格式:yyyy-MM-dd。 |
end_date |
String |
是 |
查询结束日期(含),日期不能超过今日,格式:yyyy-MM-dd。 注:end_date与start_date之间的差值最多为30天。 |
请求示例
https://spark.bokecc.com/api/stats/attention/user/daily/v3?end_date=2023-03-24&start_date=2023-03-01&userid=xxx&time=1679988103772&hash=A161BDF58C1C1431183B457C2B16273E
返回数据
名称 |
类型 |
说明 |
attentions |
Object |
播放比例。 |
attentions说明
名称 |
类型 |
说明 |
attention |
Array |
播放比例信息。 |
attention说明
名称 |
类型 |
说明 |
section |
String |
播放比例分布区间,表示播放完成百分比。 注:section表示的区间包括[0-10),[10-20),...,[80-90),[90-100]。 |
flash |
Long |
该区间的Flash端播放量。 |
pc_h5 |
Long |
该区间的H5-PC端播放量。 |
android |
Long |
该区间的Android端播放量。 |
ios |
Long |
该区间的iOS端播放量。 |
mobile_h5 |
Long |
该区间的H5-移动端播放量。 |
wechat |
Long |
该区间的微信小程序端播放量。 |
返回示例
{
"attentions": {
"attention": [{
"section": "[80-90)",
"flash": 10000,
"pc_h5": 10000,
"android": 10000,
"ios": 10000,
"mobile_h5": 9000,
"wechat": 9000
}]
}
}
2. v2版本
接口描述
该接口用于获取用户维度下按天统计的播放比例数据,该版本接口返回结果中详细区分了各播放器终端类型的数据。
请求地址
https://spark.bokecc.com/api/stats/attention/user/daily/v2
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
userid |
String |
是 |
用户ID。 |
start_date |
String |
是 |
查询开始日期(含),日期不能超过查询结束日期,格式:yyyy-MM-dd。 |
end_date |
String |
是 |
查询结束日期(含),日期不能超过今日,格式:yyyy-MM-dd。 注:end_date与start_date之间的差值最多为30天。 |
请求示例
https://spark.bokecc.com/api/stats/attention/user/daily/v2?end_date=2016-10-19&time=1671542467068&userid=CC443A6686737xxx&hash=293C73B29033A1CC5ABE0DDE0965C6F4&start_date=2016-10-18
返回数据
名称 |
类型 |
说明 |
attentions |
Object |
播放比例。 |
attentions说明
名称 |
类型 |
说明 |
attention |
Array |
播放比例信息。 |
attention说明
名称 |
类型 |
说明 |
section |
String |
播放比例分布区间,表示播放完成百分比。 注:section表示的区间包括[0-10),[10-20),...,[80-90),[90-100]。 |
flash |
Long |
该区间的Flash端播放量。 |
pc_h5 |
Long |
该区间的H5-PC端播放量。 |
android |
Long |
该区间的Android端播放量。 |
ios |
Long |
该区间的iOS端播放量。 |
mobile_h5 |
Long |
该区间的H5-移动端播放量。 |
返回示例
{
"attentions": {
"attention": [{
"section": "[10-20)",
"flash": 20000,
"pc_h5": 30000,
"android": 40000,
"ios": 50000,
"mobile_h5": 4000
}]
}
}
3. v1版本
接口描述
该接口用于获取用户维度下按天统计的播放比例数据,该版本接口返回结果中只区分了PC端和移动端的数据。
请求地址
https://spark.bokecc.com/api/stats/attention/user/daily
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
userid |
String |
是 |
用户ID。 |
start_date |
String |
是 |
查询开始日期(含),日期不能超过查询结束日期,格式:yyyy-MM-dd。 |
end_date |
String |
是 |
查询结束日期(含),日期不能超过今日,格式:yyyy-MM-dd。 注:end_date与start_date之间的差值最多为30天。 |
请求示例
https://spark.bokecc.com/api/stats/attention/user/daily?end_date=2016-10-19&time=1671542467068&userid=CC443A6686737xxx&hash=293C73B29033A1CC5ABE0DDE0965C6F4&start_date=2016-10-18
返回数据
名称 |
类型 |
说明 |
attentions |
Object |
播放比例。 |
attentions说明
名称 |
类型 |
说明 |
attention |
Array |
播放比例信息。 |
attention说明
名称 |
类型 |
说明 |
section |
String |
播放比例分布区间,表示播放完成百分比。 注:section表示的区间包括[0-10),[10-20),...,[80-90),[90-100]。 |
pc |
Long |
该区间的PC端播放量。 |
mobile |
Long |
该区间的移动端播放量。 |
返回示例
{
"attentions": {
"attention": [{
"section": "[0-10)",
"pc": 10000,
"mobile": 8000
}]
}
}