查看会议统计数据

1. 接口描述

接口名称:

/eventopenapi/event/report/stats

发送方式:

POST

参数格式:

accept: application/json;content-type: application/json

2. 输入参数

参数 类型 必须 说明
token String 统一鉴权token
eventId Long 直播会议ID
startTime Long 开始时间 (时间戳,单位秒)
endTime Long 截止时间 (时间戳,单位秒)
  • 接口支持按开始时间、结束时间进行查询
  • 按时间范围查询,当入会记录的online_time在所查询的时间范围内,即认为记录符合查询要求
  • 按时间范围查询,统计结果中的观看时长(viewTime),为查询结果的观看时长的总和并按照分钟取整(未满1分钟的按1分钟统计)
  • 按时间范围查询,统计结果中的活动时长(eventTime),为查询结果的会议实际使用时长

3. 输出参数

参数 类型 说明
timeStamp Long 返回时间(时间戳,单位毫秒)
requestId String 请求ID(在接口异常时, 需提供请求ID)
code Int 返回的状态码
msg String 当返回结果的状态码不为200时,包含的错误信息
data Json 返回数据

data 参数说明

参数 类型 说明
eventId Long 直播会议ID
stats Json 统计数据

stats 参数说明

参数 类型 说明
hostId Long 主持人ID
hostName String 主持人名称
eventTime Long 活动时长(单位秒)
eventFormal String 活动形式(目前暂时忽略)
viewCnt Int 每日观看人次(观看云活动总人次,相同用户多次进入不去重)
viewLiveCnt Int 每日观看直播人次(实时直播中,观看云活动总人次,相同用户多次进入不去重)
viewReplayCnt Int 每日观看回放人次(回放中,观看云活动总人次,相同用户多次进入不去重)
viewerCnt Int 每日累计观看人数(观看云活动总人数,相同用户多次进入去重。去重逻辑:按观众手机号/邮箱去重,如无手机号/邮箱,则按照观众使用的浏览器cookie去重。包括直播观看人数 + 回放观看人数)
viewerLiveCnt Int 每日累计直播观看人数(实时直播中,观看云活动总人数,相同用户多次进入去重。去重逻辑:按观众手机号/邮箱去重,如无手机号/邮箱,则按照观众使用的浏览器cookie去重。包括客户端观看人数 + 直播端观看人数)
viewerReplayCnt Int 每日累计回放观看人数(回放中,观看云活动总人数,相同用户多次进入去重。去重逻辑:按观众手机号/邮箱去重,如无手机号/邮箱,则按照观众使用的浏览器cookie去重。)
meetingViewerCnt Int 每日累计客户端观看人数(使用客户端观看直播的总人数,属于viewerLiveCnt的一部分)
newViewerCnt Int 新用户(本场云活动活动开始以前,从未进入过本场直播主持人直播活动的用户)
newViewerLiveCnt Int 直播新用户(本场云活动活动开始以前,从未进入过本场直播主持人直播活动的用户,且用户首次进入该直播时机为实时直播)
newViewerReplayCnt Int 回放新用户(本场云活动活动开始以前,从未进入过本场直播主持人直播活动的用户,且用户首次进入该直播时机为回放)
viewTime Long 观看总时长(单位秒,包括直播观看时长 + 回放观看时长)
viewLiveTime Long 直播观看时长(单位秒,包括客户端观看时长 + 直播端观看时长)
viewReplayTime Long 回放观看时长(单位秒)
meetingViewTime Long 客户端观看时长(单位秒, 属于viewLiveTime的一部分)
meetingPhoneTime Long 电话时长(单位秒,属于meetingViewTime的一部分)
averageViewTime Long 用户平均观看时长(单位秒, 用户观看总时长/观看人数)
averageViewLiveTime Long 用户直播平均观看时长(单位秒,实时直播观看总时长/实时直播观看人数)
averageViewReplayTime Long 用户回放平均观看时长(单位秒,回放观看总时长/回放观看人数)
beginTime String 会议开始时间(格式YYYY-MM-dd hh:mm:ss)
endTime String 会议结束时间(格式YYYY-MM-dd hh:mm:ss)
visitorCnt Int 访问总人数(访问此直播活动的总人数。访问直播活动不代表观看直播,仅代表访问过此直播页面。同一用户不同时间多次访问会去重记为1个用户。如如用户A15日访问2次,用户A16日访问1次,则访问活动总人数为1.)
pv Int 访问人次(访问此直播活动的单日总人次的累加。访问直播活动不代表观看直播,仅代表访问过此直播页面。同一用户单日多次进入不去重,不同日期进入不去重。如用户A15日访问2次,用户A16日访问1次,则访问人次为3.)
uv Int 访问人数(访问此直播活动的单日去重总人数的累加。访问直播活动不代表观看直播,仅代表访问过此直播页面。同一用户单日多次进入去重,不同日期进入不去重。如用户A15日访问2次,用户A16日访问1次,则访问人数为2.)

4. 示例

输入示例

{
    "token":"5d41c4ac806c6440eb6aa8e071115f2b",
    "eventId": 542781
}

输出示例

{
    "timeStamp": 1639476671432,
    "code": 200,
    "msg": "Successfully to get the event stats data!",
    "data": {
        "eventId": 542781,
        "stats": {
            "hostName": "15029232544",
            "newViewerCnt": 0,
            "eventFormal": null,
            "viewReplayTime": 0,
            "viewerCnt": 1,
            "hostId": 88406965,
            "newViewerReplayCnt": 0,
            "viewReplayCnt": 0,
            "viewLiveTime": 5160,
            "averageViewLiveTime": 5160,
            "averageViewTime": 5160,
            "viewLiveCnt": 1,
            "viewerLiveCnt": 1,
            "viewerReplayCnt": 0,
            "viewTime": 5160,
            "viewCnt": 1,
            "averageViewReplayTime": 0,
            "eventTime": 5200,
            "newViewerLiveCnt": 0
        }
    },
    "requestId": "10.255.0.106_20211214_181110_1639476670917"
}