文档中心

专题埋点说明

最近更新时间：2023.01.12 11:52:13

首次发布时间：2023.01.12 11:52:13

该文档针对专题场景，主要介绍了数据回传的通用事件，参数，上报示例等，同时用于开发者自测数据回传是否正确，若自测无误，请务必提供 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
产品形态	相关截图	事件	触发方式	预期	应上报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
产品形态	相关截图	事件	触发方式	预期	应上报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
产品形态	相关截图	事件	触发方式	预期	应上报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
产品形态	相关截图	事件	触发方式	预期	应上报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（固定值）
			点击其他内容离开播放页面	上报
			暂停播放	不上报
			视频播放完一遍	分情况，如果结束播放（播放下一个视频或播放广告），就上报；如果是自动重播（像抖音那样），就不上报，直到退出才上报
			锁屏或切换后台	不上报

上报示例

参数说明

事件说明

频道列表页

专题列表页

图文详情页

视频详情页

上报示例