该文档针对专题场景,主要介绍了数据回传的通用事件,参数,上报示例等,同时用于开发者自测数据回传是否正确,若自测无误,请务必提供 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 |
topic_id | long | 专题id |
duration | long | 停留时长,单位ms |
percent | long | 最大阅读进度,范围0-100 |
stay_time | long | 阅读时长,单位ms |
from_gid | long | 内容所在的专题id |
事件说明
频道列表页
产品形态 | 相关截图 | 事件 | 上报时机 | 应上报event | 应上报params |
---|
触发方式 | 预期 |
---|
频道列表页 | | 专题曝光 | 展现第一个像素 | 上报 | cms_client_show | req_id:请求id
category_name:场景id
group_id: 内容(文章/视频)id
enter_from:click_category(固定值)
__items:[{\"group_item\":[{\"id\":\"xx\"}]}]
params_for_special:content_manager_system(固定值)
topic_id:专题id |
下拉刷新展现新内容 | 上报 |
上下来回滑动重复展现 | 不上报 |
锁屏或切换后台回来 | 不上报 |
专题列表页
产品形态 | 相关截图 | 事件 | 上报时机 | 应上报event | 应上报params |
---|
触发方式 | 预期 |
---|
专题列表页 | | 点击进入专题列表页 | 点击进入专题列表页 | 上报 | cms_go_detail | req_id:请求id
category_name:场景id
group_id: 内容(文章/视频)id
enter_from:click_category(固定值)
__items:[{\"group_item\":[{\"id\":\"xx\"}]}]
params_for_special:content_manager_system(固定值)
topic_id:专题id |
从图文/视频详情页返回专题列表页 | 不上报 |
锁屏或切换后台回到专题列表页 | 不上报 |
专题列表页 | | 退出专题列表页 | 退出专题列表页 | 上报 | cms_stay_page | req_id:请求id
category_name:场景id
group_id: 内容(文章/视频)id
enter_from:click_category(固定值)
__items:[{\"group_item\":[{\"id\":\"xx\"}]}]
params_for_special:content_manager_system(固定值)
topic_id:专题id
duration:停留时长,单位ms |
点击其他内容离开专题列表页 | 上报 |
锁屏或切换后台 | 不上报 |
专题列表页 | | 内容(文章/视频)曝光 | 展现第一个像素 | 上报 | cms_client_show | from_gid:内容所在的专题id
req_id:请求id
category_name:场景id
group_id: 内容(文章/视频)id
enter_from:click_category(固定值)
__items:[{\"group_item\":[{\"id\":\"xx\"}]}]
params_for_special:content_manager_system(固定值) |
上下来回滑动重复展现 | 不上报 |
锁屏或切换后台回来 | 不上报 |
图文详情页
产品形态 | 相关截图 | 事件 | 上报时机 | 应上报event | 应上报params |
---|
触发方式 | 预期 |
---|
图文详情页 | | 点击进入详情页 | 点击进入详情页 | 上报 | cms_go_detail | from_gid:内容所在的专题id
req_id:请求id
category_name:场景id
group_id: 内容(文章/视频)id
enter_from:click_category(固定值)
__items:[{\"group_item\":[{\"id\":\"xx\"}]}]
params_for_special:content_manager_system(固定值) |
从相关阅读返回详情页 | 不上报 |
锁屏或切换后台回到详情页 | 不上报 |
图文详情页 | | 退出详情页 | 退出详情页 | 上报 | cms_stay_page | req_id:请求id
category_name:场景id
group_id: 内容(文章/视频)id
enter_from:click_category(固定值)
__items:[{\"group_item\":[{\"id\":\"xx\"}]}]
params_for_special:content_manager_system(固定值)
from_gid:内容所在的专题id
stay_time:阅读时长,单位ms
percent:最大阅读进度,范围0-100 |
点击其他内容离开详情页 | 上报 |
锁屏或切换后台 | 不上报 |
视频详情页
产品形态 | 相关截图 | 事件 | 上报时机 | 应上报event | 应上报params |
---|
触发方式 | 预期 |
---|
视频详情页 | | 点击进入详情页 | 点击进入详情页 | 上报 | cms_go_detail | from_gid:内容所在的专题id
req_id:请求id
category_name:场景id
group_id: 内容(文章/视频)id
enter_from:click_category(固定值)
__items:[{\"group_item\":[{\"id\":\"xx\"}]}]
params_for_special:content_manager_system(固定值) |
从相关阅读返回详情页 | 不上报 |
锁屏或切换后台回到详情页 | 不上报 |
视频详情页 | | 退出详情页 | 退出详情页 | 上报 | cms_stay_page | from_gid:内容所在的专题id
stay_time:阅读时长,单位ms
percent:最大阅读进度,范围0-100
req_id:请求id
category_name:场景id
group_id: 内容(文章/视频)id
enter_from:click_category(固定值)
__items:[{\"group_item\":[{\"id\":\"xx\"}]}]
params_for_special:content_manager_system(固定值) |
点击其他内容离开详情页 | 上报 |
锁屏或切换后台 | 不上报 |
视频详情页 | | 视频播放 | 点击开始播放 | 上报 | cms_video_play | from_gid:内容所在的专题id
req_id:请求id
category_name:场景id
group_id: 内容(文章/视频)id
enter_from:click_category(固定值)
__items:[{\"group_item\":[{\"id\":\"xx\"}]}]
params_for_special:content_manager_system(固定值) |
暂停后重新播放 | 不上报 |
播放完一遍自动重播 | 不上报 |
锁屏或切换后台回到播放页面 | 不上报 |
视频详情页 | | 视频时长 | 按返回键离开播放页面 | 上报 | cms_video_over | from_gid:内容所在的专题id
duration:播放时长,单位ms
percent:最大播放进度,拖动进度条也算,上限100
req_id:请求id
category_name:场景id
group_id: 内容(文章/视频)id
enter_from:click_category(固定值)
__items:[{\"group_item\":[{\"id\":\"xx\"}]}]
params_for_special:content_manager_system(固定值) |
点击其他内容离开播放页面 | 上报 |
暂停播放 | 不上报 |
视频播放完一遍 | 分情况,如果结束播放(播放下一个视频或播放广告),就上报;如果是自动重播(像抖音那样),就不上报,直到退出才上报 |
锁屏或切换后台 | 不上报 |
上报示例