该文档针对横版短视频场景，主要介绍了数据回传的通用事件，参数，上报示例等，同时用于开发者自测数据回传是否正确，自测方式参见验证数据回传，若自测无误，请务必提供APP给火山引擎进行埋点验收，否则影响推荐效果！

事件说明

说明event和接口的一一对应关系

参数说明

场景说明

1）核心场景

a）频道列表页

产品形态	相关截图	事件	上报时机		应上报event	应上报params
			触发方式	预期
频道列表页		曝光	展现第一个像素	上报	client_show	GroupId: 视频id ReqId：请求唯一标识
			下拉刷新展现新内容	上报
			上下来回滑动重复展现	不上报
			锁屏或切换后台回来	不上报
频道列表页		视频播放（手动点击起播）	点击开始播放	上报	video_play	GroupId: 视频id ReqId：请求唯一标识
			暂停后重新播放	不上报
			播放完一遍自动重播	不上报
			锁屏或切换后台回到播放页面	不上报
频道列表页		视频时长（手动点击起播）	点击其他内容离开播放页面	上报	video_over	GroupId: 视频id Duration：播放时长，单位ms Percent：最大播放进度，拖动进度条也算，上限100 ReqId：请求唯一标识
			暂停播放	不上报
			视频播放完一遍	分情况，如果结束播放（播放下一个视频或播放广告），就上报；如果是自动重播（像抖音那样），就不上报，直到退出才上报
			锁屏或切换后台	不上报
频道列表页		视频播放（自动起播）	进入频道列表页视频自动播发	上报	video_play_auto	GroupId: 视频id ReqId：请求唯一标识
			滑动屏幕，然后停留在新视频上，开始自动播放	上报
			滑动回刚才播放过的视频，重新开始播放	上报
			暂停后重新播放	不上报
频道列表页		视频时长（自动起播）	自动播放的视频退出播放	上报	video_over_auto	GroupId: 视频id Duration：阅读时长，单位ms Percent：最大阅读进度，拖动进度条也算，多次拖动取最大值，上限100。 ReqId：请求唯一标识
			锁屏或切换后台	不上报
			暂停播放	不上报

b）视频详情页

产品形态	相关截图	事件	上报时机		应上报event	应上报params
			触发方式	预期
视频详情页		点击进入详情页	点击进入详情页	上报	go_detail	GroupId: 视频id ReqId：请求唯一标识
			从相关阅读返回详情页	不上报
			锁屏或切换后台回到详情页	不上报
视频详情页		退出详情页	退出详情页	上报	stay_page	GroupId: 视频id StayTime：阅读时长，单位ms ReqId：请求唯一标识
			点击其他内容离开详情页	上报
			锁屏或切换后台	不上报
视频详情页		视频播放	点击开始播放	上报	video_play	GroupId: 视频id ReqId：请求唯一标识
			暂停后重新播放	不上报
			播放完一遍自动重播	不上报
			锁屏或切换后台回到播放页面	不上报
视频详情页		视频时长	按返回键离开播放页面	上报	video_over	GroupId: 视频id Duration：播放时长，单位ms Percent：最大播放进度，拖动进度条也算，上限100 ReqId：请求唯一标识
			点击其他内容离开播放页面	上报
			暂停播放	不上报
			视频播放完一遍	分情况，如果结束播放（播放下一个视频或播放广告），就上报；如果是自动重播（像抖音那样），就不上报，直到退出才上报
			锁屏或切换后台	不上报

c）沉浸式内流

产品形态	相关截图	事件	上报时机			应上报event	应上报params
			触发方式	预期	备注
沉浸式视频内流		视频播放（从列表页进入内流时的第一个视频）	点击开始播放	上报		video_play	GroupId: 视频id ReqId：请求唯一标识
			暂停后重新播放	不上报
			播放完一遍自动重播	不上报
			锁屏或切换后台回到播放页面	不上报
沉浸式视频内流		视频时长（从列表页进入内流时的第一个视频）	按返回键离开播放页面	上报		video_over	GroupId: 视频id Duration：阅读时长，单位ms Percent：最大阅读进度，拖动进度条也算，多次拖动取最大值，上限100。 ReqId：请求唯一标识
			上划视频离开当前内容	上报
			暂停播放	不上报
			视频播放完一遍	分情况	如果结束播放（播放下一个视频或播放广告），就上报；如果是自动重播（像抖音那样），就不上报，直到退出才上报。
			锁屏或切换后台	不上报
沉浸式视频内流		视频自动播放（1、从列表页进去的那个视频不算，滑动到第二个视频以后才算； 2、点击tab直接进入到内流，不是从列表页点击进入内流）	在沉浸式完成上一个视频的播放，自动开始播放新视频	上报	在列表页点击视频，进入沉浸式，这时播放的视频不上报video_play_auto，而是video_play。	video_play_auto	GroupId: 视频id RootGid：进入内流场景的第一个视频 Duration：阅读时长，单位ms Percent：最大阅读进度，拖动进度条也算，多次拖动取最大值，上限100。 ReqId：请求唯一标识
			滑动屏幕，然后停留在新视频上，开始自动播放	上报
			全屏之后，点击“下一个”开始播放新视频	上报	只有部分产品有这个功能
			滑动回刚才播放过的视频，重新开始播放	上报
			暂停后重新播放	不上报
沉浸式视频内流		视频自动播放的时长（1、从列表页进去的那个视频不算，滑动到第二个视频以后才算； 2、点击tab直接进入到内流，不是从列表页点击进入内流）	自动播放的视频退出播放	上报	开始播放时上报video_play_auto的，结束播放时都上报video_over_auto；进入沉浸式时的第一个视频结束或退出时上报video_over。	video_over_auto	GroupId: 视频id RootGid：进入内流场景的第一个视频 Duration：阅读时长，单位ms Percent：最大阅读进度，拖动进度条也算，多次拖动取最大值，上限100。 ReqId：请求唯一标识
			锁屏或切换后台	不上报
			暂停播放	不上报

2）相关推荐场景（非必须）

产品形态	相关截图	事件	上报时机		应上报event	应上报params
			触发方式	预期
相关推荐		曝光	展现第一个像素	上报	client_show	GroupId: 内容（文章/视频）id ReqId：请求唯一标识
			上下来回滑动重复展现	不上报
			锁屏或切换后台回来	不上报
相关推荐		视频播放	点击开始播放	上报	video_play	GroupId: 视频id ReqId：请求唯一标识
			暂停后重新播放	不上报
			播放完一遍自动重播	不上报
			锁屏或切换后台回到播放页面	不上报
相关推荐		视频时长	按返回键离开播放页面	上报	video_over	GroupId: 视频id Duration：播放时长，单位ms Percent：最大播放进度，拖动进度条也算，上限100 ReqId：请求唯一标识
			点击其他内容离开播放页面	上报
			暂停播放	不上报
			视频播放完一遍	分情况，如果结束播放（播放下一个视频或播放广告），就上报；如果是自动重播（像抖音那样），就不上报，直到退出才上报
			锁屏或切换后台	不上报
相关推荐		点击进入详情页	点击进入详情页	上报	go_detail	GroupId: 内容（文章/视频）id ReqId：请求唯一标识
			从相关阅读返回详情页	不上报
			锁屏或切换后台回到详情页	不上报
相关推荐		退出详情页	退出详情页	上报	stay_page	GroupId: 内容（文章/视频）id StayTime：阅读时长，单位ms Percent：最大阅读进度，范围0-100 ReqId：请求唯一标识
			点击其他内容离开详情页	上报
			锁屏或切换后台	不上报

示例说明

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

起播方式：全部都是手动点击起播

操作	截图	上报事件	备注
一、进入频道列表页，此时有3个视频展现： 内容1:农村90后姑娘XXX 内容2:极星2XXX 内容3:又跌了2万XXX		client_show	上报3条内容的client_show
二、点击内容1，此时 1.进入内容1的视频详情页； 2.内容1视频开始播放 3.展现了3个相关推荐的内容： 相关视频1:安徽人在佛山XXX 相关视频2:为了生个儿子XXX 相关视频3:广西玉林XXX		go_detail video_play client_show	进入内容1视频详情页时上报go_detail； 内容1该视频起播方式是手动点击播放，因此上报video_play； 相关推荐上报3条内容的client_show
三、点击相关视频1，此时 1.内容1播放结束； 2.离开了内容1的详情页； 3.同时进入相关视频1的详情页； 4.相关视频1开始播放； 5.展现了3个相关推荐的内容： 相关视频1-1:女嫁农村XXX 相关视频1-2:广西猪肉XXX 相关视频1-3:广西30岁XXX		stay_page video_over go_detail video_play client_show	离开内容1视频详情页时上报 stay_page； 由于内容1起播方式是手动点击播放，因此该视频播放结束上报video_over； 进入相关视频1的视频详情页时上报go_detail； 相关视频1的起播方式是手动点击播放，因此上报video_play； 相关推荐上报3条内容的client_show

CASE2：频道列表页 ➡️ 沉浸式内流

起播方式：外流手动点击播放，内流自动播放

操作	截图	上报事件	备注
一、进入频道列表页，此时有2个视频展现： 内容1:56岁高龄产妇XXX 内容2:第一次同居XXX		client_show	上报2条内容的client_show
二、点击内容1，此时 1.进入沉浸式内流； 2.内容1视频开始播放		video_play	内容1该视频起播方式是手动点击播放，因此上报video_play；
三、滑动列表，停留后，视频2自动播放，此时 1.内容1播放结束； 2.视频2开始播放；		video_over video_play_auto	由于内容1起播方式是手动点击播放，因此该视频播放结束上报video_over； 视频2的起播方式是自动播放，因此该视频开始播放上报video_play_auto 注：从视频2开始，下滑的视频video_play_auto和video_over_auto都需要上报RootGid参数，此处RootGid是入口视频，即「56岁高龄产妇XXX」该视频的gid
四、视频2播放结束后，视频3自动播放，此时 1.视频2播放结束； 2.视频3开始播放；		video_over_auto video_play_auto	视频2起播方式是自动播放，因此该视频播放结束上报video_over_auto； 视频3的起播方式是自动播放，因此该视频开始播放上报video_play_auto 注：从视频2开始，下滑的视频video_play_auto和video_over_auto都需要上报RootGid参数，此处RootGid是入口视频，即「56岁高龄产妇XXX」该视频的gid

CASE3：频道列表页

起播方式：外流自动播放，无法点击进入内流和详情页

操作	截图	上报事件	备注
一、进入频道列表页，此时有2个视频展现，且内容1自动播放： 内容1:枕头芯XXX 内容2:炒瘦肉XXX		client_show video_play_auto	上报2条内容的client_show 内容1该视频起播方式是自动播放，因此上报video_play_auto；
二、滑动列表，停留后，此时 1.视频1播放结束； 2.视频2自动播放；		video_over_auto video_play_auto	内容1该视频起播方式是自动播放，因此播放结束时上报video_over_auto； 内容2该视频起播方式是自动播放，因此上报video_play_auto；

CASE4：沉浸式内流

操作	截图	上报事件	备注
一、进入频道，此时是沉浸式内流样式，自动播放视频1： 视频1:羚羊刚从XXX		video_play_auto	视频1起播方式是自动播放，因此上报video_play_auto；
二、向下滑动，此时 结束播放视频1 自动播放视频2		video_over_auto video_play_auto	视频1起播方式是自动播放，因此播放结束时上报video_over_auto； 视频2起播方式是自动播放，因此上报video_play_auto；