该文档针对图文场景,主要介绍了数据回传的通用事件,参数,上报示例等,同时用于开发者自测数据回传是否正确,若自测无误,请务必提供 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 | |
点击其他内容离开详情页 | 上报 | |||||
锁屏或切换后台 | 不上报 |
操作 | 截图 | 上报事件 | 备注( 此处表示相关推荐的埋点加粗 ) |
---|---|---|---|
一、进入频道列表页,此时有3个图文展现:
| cms_client_show | 上报3条内容的cms_client_show | |
二、点击内容2,此时进入内容2的图文详情页; | cms_go_detail | 进入内容2图文详情页时上报cms_go_detail; | |
三、不断向下滑动阅读内容,此时文章底部露出相关推荐内容:
| cms_client_show | 相关推荐上报3条内容的cms_client_show 注:相关推荐需要上报from_gid参数,此处cms_client_show的from_gid是「翻开父母XXX」该文章的gid | |
四、点击相关推荐1,此时
|
|
| |
五、点击返回按钮,此时退出相关推荐1的图文详情页 | cms_stay_page | 离开相关推荐1的图文详情页时上报cms_stay_page; 注:相关推荐需要上报from_gid参数,此处cms_stay_page的from_gid是「翻开父母XXX」该文章的gid |