获取用户维度下按天统计的域名播放时长

更新时间：2023-03-28

1. v3版本

接口描述
该接口用于获取用户维度下按天统计的来源域名(referer)相关的播放时长数据，该版本接口返回结果中增加了微信小程序终端相关的数据内容。
请求地址
https://spark.bokecc.com/api/stats/playduration/user/daily/domain/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/playduration/user/daily/domain/v3?end_date=2023-03-24&start_date=2023-03-01&userid=xxx&time=1679982086915&hash=E29DF1BE75FBC1CC49A3E43E19E81B62
返回数据
名称 类型 说明
play_durations Object 播放时长。
play_duration说明
名称 类型 说明
play_duration Array 播放时长信息。
play_duration说明
名称 类型 说明
domain String 来源域名(referer)。
flash Long Flash端播放时长，单位：秒。
pc_h5 Long H5-PC端播放时长，单位：秒。
android Long Android端播放时长，单位：秒。
ios Long iOS端播放时长，单位：秒。
mobile_h5 Long H5-移动端播放时长，单位：秒。
wechat Long 微信小程序端播放时长，单位：秒。
返回示例
{
    "play_durations": {
        "play_duration": [{
            "domain": "app.pinsahn.com",
            "flash": 12345,
            "pc_h5": 2826,
            "android": 103121,
            "ios": 31102,
            "mobile_h5": 12335,
            "wechat": 12391
        }]
    }
}

2. v2版本

接口描述
该接口用于获取用户维度下按天统计的来源域名(referer)相关的播放时长数据，该版本接口返回结果中详细区分了各播放器终端类型的数据。
请求地址
https://spark.bokecc.com/api/stats/playduration/user/daily/domain/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/playduration/user/daily/domain/v2?end_date=2016-10-19&time=1671546668494&userid=CC443A6686737xxx&hash=7E5D37221164AE822328AC0345480234&start_date=2016-10-18
返回数据
名称 类型 说明
play_durations Object 播放时长。
play_duration说明
名称 类型 说明
play_duration Array 播放时长信息。
play_duration说明
名称 类型 说明
domain String 来源域名(referer)。
flash Long Flash端播放时长，单位：秒。
pc_h5 Long H5-PC端播放时长，单位：秒。
android Long Android端播放时长，单位：秒。
ios Long iOS端播放时长，单位：秒。
mobile_h5 Long H5-移动端播放时长，单位：秒。
返回示例
{
    "play_counts": {
        "play_count": [{
            "domain": "app.tangdou.com",
            "flash": 10000,
            "pc_h5": 10000,
            "android": 10000,
            "ios": 10000,
            "mobile_h5": 7000
        }]
    }
}

3. v1版本

接口描述
该接口用于获取用户维度下按天统计的来源域名(referer)相关的播放时长数据，该版本接口返回结果中只区分了PC端和移动端的数据。
请求地址
https://spark.bokecc.com/api/stats/playduration/user/daily/domain
请求方式
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/playduration/user/daily/domain?end_date=2016-10-19&time=1671546668494&userid=CC443A6686737xxx&hash=7E5D37221164AE822328AC0345480234&start_date=2016-10-18
返回数据
名称 类型 说明
play_durations Object 播放时长。
play_duration说明
名称 类型 说明
play_duration Array 播放时长信息。
play_duration说明
名称 类型 说明
domain String 来源域名(referer)。
pc Long PC端播放时长，单位：秒。
mobile Long 移动端播放时长，单位：秒。
返回示例
{
    "play_durations": {
        "play_duration": [{
            "domain": "app.tangdou.com",
            "pc": 1000000,
            "mobile": 700000
        }]
    }
}

results matching ""

    No results matching ""