该文档针对竖版小视频场景,主要介绍了数据回传的通用事件,参数,上报示例等,同时用于开发者自测数据回传是否正确,若自测无误,请务必提供APP给火山引擎进行埋点验收,否则影响推荐效果!
备注 :
埋点上报用于统计用户的消费行为,进而作用于模型训练,进行个性化推荐。
其它参数见:数据回传参数说明
| 字段名 | 字段类型 | 说明 |
|---|---|---|
| req_id | string | 请求内容推荐接口返回的RequestId |
| enter_from | string | 固定值:click_category |
| category_name | string | 场景id,在内容管理平台控制台-场景管理-获取场景id |
| group_id | long | 内容id,对应内容推荐接口返回的GroupId |
| __items | string | 该id同group_id,用于内容特征分析,[{\"group_item\":[{\"id\":\"xx\"}]}] |
| params_for_special | string | 固定值:content_manager_system |
| duration | long | 播放时长,单位ms |
| percent | long | 最大播放百分比,拖动进度条也算,范围0-100 |
| root_gid | long | 进入内流场景的第一个视频GroupId |
| 产品形态 | 相关截图 | 事件 | 上报时机 | 应上报event | 应上报params | |
|---|---|---|---|---|---|---|
| 触发方式 | 预期 | |||||
频道列表页 |
| 曝光 | 展现第一个像素 | 上报 | cms_client_show | req_id:请求id |
| 下拉刷新展现新内容 | 上报 | |||||
| 上下来回滑动重复展现 | 不上报 | |||||
| 锁屏或切换后台回来 | 不上报 | |||||
| 产品形态 | 相关截图 | 事件 | 上报时机 | 应上报event | 应上报params | ||
|---|---|---|---|---|---|---|---|
| 触发方式 | 预期 | 备注 | |||||
沉浸式视频内流 |
| 视频播放(从列表页进入内流时的第一个视频) | 点击开始播放 | 上报 | cms_video_play | req_id:请求id | |
| 暂停后重新播放 | 不上报 | ||||||
| 播放完一遍自动重播 | 不上报 | ||||||
| 锁屏或切换后台回到播放页面 | 不上报 | ||||||
沉浸式视频内流 |
| 视频时长(从列表页进入内流时的第一个视频) | 按返回键离开播放页面 | 上报 | cms_video_over | req_id:请求id | |
| 下滑离开当前内容 | 上报 | ||||||
| 暂停播放 | 不上报 | ||||||
| 视频播放完一遍 | 分情况 | 如果结束播放(播放下一个视频或播放广告),就上报;如果是自动重播(像抖音那样),就不上报,直到退出才上报。 | |||||
| 锁屏或切换后台 | 不上报 | ||||||
沉浸式视频内流 |
| 视频自动播放 | 在内流滑动进入新视频 | 上报 | 从列表页点击进入内流,点击的这个视频上报video_play,而不是video_play_draw | cms_video_play_draw | root_gid:进入内流场景的第一个视频 |
| 播放完一遍自动重播 | 不上报 | ||||||
| 滑动回到刚才看过的视频 | 上报 | ||||||
| 暂停后重新播放 | 不上报 | ||||||
沉浸式视频内流 |
| 视频自动播放的时长 | 退出播放 | 上报 | cms_video_over_draw | req_id:请求id | |
| 滑动进入下一个视频 | 上报 | ||||||
| 视频播放完一遍 | 分情况 | 如果结束播放(播放下一个视频或播放广告),就上报;如果是自动重播(像抖音那样),就不上报,直到退出才上报。 | |||||
| 锁屏或切换后台 | 不上报 | ||||||
| 暂停播放 | 不上报 | ||||||
| 操作 | 截图 | 上报事件 | 备注(此处表示相关推荐的埋点加粗) |
|---|---|---|---|
一、进入频道,此时是在频道列表页,有6个视频展现:
|
| cms_client_show |
|
| 二、点击视频1,此时进入沉浸式内流,视频1开始播放 | ![]() | cms_video_play | - 视频1起播方式是在外流手动点击播放,因此上报cms_video_play |
二、向下滑动,此时
|
|
|
注:从视频2开始,下滑的视频cms_video_play_draw和cms_video_over_draw都需要上报root_gid参数,此处root_gid是入口视频,即「萌娃XXX」该视频的gid |
三、向下滑动,此时
|
|
|
注:从视频2开始,下滑的视频cms_video_play_draw和cms_video_over_draw都需要上报root_gid参数,此处root_gid是入口视频,即「萌娃XXX」该视频的gid |
| 操作 | 截图 | 上报事件 | 备注(此处表示相关推荐的埋点加粗) |
|---|---|---|---|
一、进入频道,此时是沉浸式内流样式,自动播放视频1:
|
| cms_video_play_draw |
|
二、向下滑动,此时
|
| cms_video_over_draw |
|