You need to enable JavaScript to run this app.
导航
图文埋点说明
最近更新时间:2023.08.29 15:19:16首次发布时间:2021.07.05 21:23:10

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

参数说明
字段名字段类型说明
req_idstring请求内容推荐接口返回的RequestId
enter_fromstring固定值:click_category或click_related
category_namestring场景id,在内容管理平台控制台-场景管理-获取场景id
group_idlong对应内容推荐接口返回的GroupId
__itemsstring该id同上,用于内容特征分析;[{\"group_item\":[{\"id\":\"xx\"}]}]
params_for_specialstring固定值:content_manager_system
stay_timelong阅读时长,单位 ms
percentlong最大阅读进度,上限100。注意:1.需记录详情页最大阅读进度;2.文章完整比例不包含评论区内容。
事件说明

核心场景

频道列表页

产品形态相关截图事件上报时机应上报event应上报params
触发方式预期
频道列表页image.png曝光展现第一个像素上报cms_client_showreq_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
触发方式预期
图文详情页image.png点击进入详情页点击进入详情页上报cms_go_detailreq_id:请求id
category_name:场景id
group_id: 内容(文章/视频)id
enter_from:click_category(固定值)
__items:[{\"group_item\":[{\"id\":\"xx\"}]}]
params_for_special:content_manager_system(固定值)
从相关阅读返回详情页不上报
锁屏或切换后台回到详情页不上报
图文详情页image.png退出详情页退出详情页上报cms_stay_pagereq_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
触发方式预期
相关推荐image.png曝光展现第一个像素上报cms_client_showgroup_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(固定值)
上下来回滑动重复展现不上报
锁屏或切换后台回来不上报
相关推荐image.png点击进入详情页点击进入详情页上报cms_go_detailgroup_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(固定值)
从相关阅读返回详情页不上报
锁屏或切换后台回到详情页不上报
相关推荐image.png退出详情页退出详情页上报cms_stay_pagegroup_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
image.pngcms_client_show上报3条内容的cms_client_show
二、点击内容2,此时进入内容2的图文详情页;image.pngcms_go_detail进入内容2图文详情页时上报cms_go_detail;
三、不断向下滑动阅读内容,此时文章底部露出相关推荐内容:
  • 相关推荐1:凶险!XXX
  • 相关推荐2:看完震撼XXX
  • 相关推荐3:调查|XXX
image.pngcms_client_show相关推荐上报3条内容的cms_client_show
注:相关推荐需要上报from_gid参数,此处cms_client_show的from_gid是「翻开父母XXX」该文章的gid
四、点击相关推荐1,此时
  1. 离开内容2的图文详情页。
  2. 进入相关推荐1的图文详情页;
image.png
  • cms_stay_page
  • cms_go_detail
  • 离开内容2的图文详情页时上报cms_stay_page;
  • 进入相关推荐1的图文详情页时上报cms_go_detail;
  • 注:相关推荐需要上报from_gid参数,此处cms_go_detail的from_gid是「翻开父母XXX」该文章的gid
五、点击返回按钮,此时退出相关推荐1的图文详情页image.pngcms_stay_page离开相关推荐1的图文详情页时上报cms_stay_page;
注:相关推荐需要上报from_gid参数,此处cms_stay_page的from_gid是「翻开父母XXX」该文章的gid