获取用户维度下按小时统计的观众量

更新时间: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
        }]
    }
}

results matching ""

    No results matching ""