该文档针对图文场景，主要介绍了数据回传的通用事件，参数，上报示例等，同时用于开发者自测数据回传是否正确，若自测无误，请务必提供 APP 给火山引擎进行埋点验收，否则影响推荐效果！
备注：
埋点上报用于统计用户的消费行为，进而作用于模型训练，进行个性化推荐。
其它参数见：数据回传参数说明

参数说明

字段名	字段类型	说明
req_id	string	请求内容推荐接口返回的RequestId
enter_from	string	固定值：click_category或click_related
category_name	string	场景id，在内容管理平台控制台-场景管理-获取场景id
group_id	long	对应内容推荐接口返回的GroupId
__items	string	该id同上，用于内容特征分析；[{\"group_item\":[{\"id\":\"xx\"}]}]
params_for_special	string	固定值：content_manager_system
stay_time	long	阅读时长，单位 ms
percent	long	最大阅读进度，上限100。注意：==1.需记录详情页最大阅读进度；2.文章完整比例不包含评论区内容。==

事件说明

核心场景

频道列表页

产品形态	相关截图	事件	上报时机		应上报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（固定值）
			下拉刷新展现新内容	上报
			上下来回滑动重复展现	不上报
			锁屏或切换后台回来	不上报

图文详情页

产品形态	相关截图	事件	上报时机		应上报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（固定值）
			从相关阅读返回详情页	不上报
			锁屏或切换后台回到详情页	不上报
图文详情页		退出详情页	退出详情页	上报	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（固定值） stay_time：阅读时长，单位ms percent：最大阅读进度，范围0-100
			点击其他内容离开详情页	上报
			锁屏或切换后台	不上报

相关推荐场景（非必须）

产品形态	相关截图	事件	上报时机		应上报event	应上报params
			触发方式	预期
相关推荐		曝光	展现第一个像素	上报	cms_client_show	group_id: 内容（文章/视频）id from_gid：相关阅读来源文章id req_id：请求id category_name：场景id root_category_name：入口频道名称 enter_from：click_related（固定值） __items：[{\"group_item\":[{\"id\":\"xx\"}]}] params_for_special：content_manager_system（固定值）
			上下来回滑动重复展现	不上报
			锁屏或切换后台回来	不上报
相关推荐		点击进入详情页	点击进入详情页	上报	cms_go_detail	group_id: 内容（文章/视频）id from_gid：相关阅读来源文章id req_id：请求id category_name：场景id root_category_name：入口频道名称 enter_from：click_related（固定值） __items：[{\"group_item\":[{\"id\":\"xx\"}]}] params_for_special：content_manager_system（固定值）
			从相关阅读返回详情页	不上报
			锁屏或切换后台回到详情页	不上报
相关推荐		退出详情页	退出详情页	上报	cms_stay_page	group_id: 内容（文章/视频）id from_gid：相关阅读来源文章id req_id：请求id category_name：场景id root_category_name：入口频道名称 enter_from：click_related（固定值） __items：[{\"group_item\":[{\"id\":\"xx\"}]}] params_for_special：content_manager_system（固定值） stay_time：阅读时长，单位ms percent：最大阅读进度，范围0-100
			点击其他内容离开详情页	上报
			锁屏或切换后台	不上报

上报示例

CASE1：频道列表页 ➡️ 图文详情页 ➡️ 相关推荐

操作	截图	上报事件	备注（ 此处表示相关推荐的埋点加粗 ）
一、进入频道列表页，此时有3个图文展现： 内容1:不穿宇航服XXX 内容2:翻开父母XXX 内容3:鲁迅孙子XXX		cms_client_show	上报3条内容的cms_client_show
二、点击内容2，此时进入内容2的图文详情页；		cms_go_detail	进入内容2图文详情页时上报cms_go_detail；
三、不断向下滑动阅读内容，此时文章底部露出相关推荐内容： 相关推荐1:凶险！XXX 相关推荐2:看完震撼XXX 相关推荐3:调查｜XXX		cms_client_show	相关推荐上报3条内容的cms_client_show 注：相关推荐需要上报from_gid参数，此处cms_client_show的from_gid是「翻开父母XXX」该文章的gid
四、点击相关推荐1，此时 离开内容2的图文详情页。 进入相关推荐1的图文详情页；		cms_stay_page cms_go_detail	离开内容2的图文详情页时上报cms_stay_page； 进入相关推荐1的图文详情页时上报cms_go_detail； 注：相关推荐需要上报from_gid参数，此处cms_go_detail的from_gid是「翻开父母XXX」该文章的gid
五、点击返回按钮，此时退出相关推荐1的图文详情页		cms_stay_page	离开相关推荐1的图文详情页时上报cms_stay_page； 注：相关推荐需要上报from_gid参数，此处cms_stay_page的from_gid是「翻开父母XXX」该文章的gid