获取用户维度下按小时统计的观众量
更新时间:2023-03-28
1. v3版本
接口描述
该接口用于获取用户维度下按小时统计的观众量数据,该版本接口返回结果中增加了微信小程序终端相关的数据内容。
请求地址
https://spark.bokecc.com/api/stats/uniquevisitor/user/hourly/v3
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
userid |
String |
是 |
用户ID。 |
date |
String |
是 |
查询日期,日期不能大于今日,格式:yyyy-MM-dd。 |
请求示例
https://spark.bokecc.com/api/stats/uniquevisitor/user/hourly/v3?date=2023-03-24&userid=xxx&time=1679991694379&hash=89BD567FCCE8041769848F97BE7137F5
返回数据
名称 |
类型 |
说明 |
unique_visitors |
Object |
观众量。 |
unique_visitors说明
名称 |
类型 |
说明 |
unique_visitor |
Array |
观众量信息。 |
unique_visitor说明
名称 |
类型 |
说明 |
time |
String |
表示小时的时间字符串,格式:yyyy-MM-dd HH:mm:ss。 |
total |
Long |
全终端观众量。 |
flash |
Long |
Flash端观众量。 |
pc_h5 |
Long |
H5-PC端观众量。 |
android |
Long |
Android端观众量。 |
ios |
Long |
iOS端观众量。 |
mobile_h5 |
Long |
H5-移动端观众量。 |
wechat |
Long |
微信小程序端观众量。 |
返回示例
{
"unique_visitors": {
"unique_visitor": [{
"time": "2023-03-24 11:00:00",
"total": 6234,
"flash": 1000,
"pc_h5": 1000,
"android": 1000,
"ios": 1000,
"mobile_h5": 2000,
"wechat": 1234
}]
}
}
2. v2版本
接口描述
该接口用于获取用户维度下按小时统计的观众量数据,该版本接口返回结果中详细区分了各播放器终端类型的数据。
请求地址
https://spark.bokecc.com/api/stats/uniquevisitor/user/hourly/v2
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
userid |
String |
是 |
用户ID。 |
date |
String |
是 |
查询日期,日期不能大于今日,格式:yyyy-MM-dd。 |
请求示例
https://spark.bokecc.com/api/stats/uniquevisitor/user/hourly/v2?date=2016-10-19&time=1671536527042&userid=CC443A6686737xxx&hash=4E5735AFC9AD2CAF76CF18ACC9E13527
返回数据
名称 |
类型 |
说明 |
unique_visitors |
Object |
观众量。 |
unique_visitors说明
名称 |
类型 |
说明 |
unique_visitor |
Array |
观众量信息。 |
unique_visitor说明
名称 |
类型 |
说明 |
time |
String |
表示小时的时间字符串,格式:yyyy-MM-dd HH:mm:ss。 |
total |
Long |
全终端观众量。 |
flash |
Long |
Flash端观众量。 |
pc_h5 |
Long |
H5-PC端观众量。 |
android |
Long |
Android端观众量。 |
ios |
Long |
iOS端观众量。 |
mobile_h5 |
Long |
H5-移动端观众量。 |
返回示例
{
"unique_visitors": {
"unique_visitor": [{
"time": "2016-10-19 00:00:00",
"total": 70000,
"flash": 10000,
"pc_h5": 20000,
"android": 10000,
"ios": 10000,
"mobile_h5": 20000
}]
}
}
3. v1版本
接口描述
该接口用于获取用户维度下按小时统计的观众量数据,该版本接口返回结果中只区分了PC端和移动端的数据。
请求地址
https://spark.bokecc.com/api/stats/uniquevisitor/user/hourly
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
userid |
String |
是 |
用户ID。 |
date |
String |
是 |
查询日期,日期不能大于今日,格式:yyyy-MM-dd。 |
请求示例
https://spark.bokecc.com/api/stats/uniquevisitor/user/hourly?date=2016-10-19&time=1671536127636&userid=CC443A6686737xxx&hash=99642B87E5083CC6B2B34A4A0FC4DB98
返回数据
名称 |
类型 |
说明 |
unique_visitors |
Object |
观众量。 |
unique_visitors说明
名称 |
类型 |
说明 |
unique_visitor |
Array |
观众量信息。 |
unique_visitor说明
名称 |
类型 |
说明 |
time |
String |
表示小时的时间字符串,格式:yyyy-MM-dd HH:mm:ss。。 |
total |
Long |
全终端观众量。 |
pc |
Long |
PC端观众量。 |
mobile |
Long |
移动端观众量。 |
返回示例
{
"unique_visitors": {
"unique_visitor": [{
"time": "2016-10-19 01:00:00",
"total": 29999,
"pc": 10000,
"mobile": 20000
}]
}
}