查看会议统计数据
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"
}