竖版小视频埋点通用说明--内容定制-火山引擎

文档中心

立即注册

导航

竖版小视频埋点通用说明

最近更新时间：2024.05.17 14:56:40首次发布时间：2021.11.12 14:30:21

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

注意

埋点上报用于统计用户的实时行为，进而作用于模型训练，进行个性化推荐，建议尽量不要做延迟上报，避免影响推荐效果。

事件说明

事件	event	接口
曝光	client_show	客户端展现上报
视频播放	video_play	视频播放开始上报
视频播放（下滑自动起播）	video_play_draw	视频播放开始上报
视频时长	video_over	视频播放结束上报
视频时长(下滑自动起播)	video_over_draw	视频播放结束上报

参数说明

参数	定义	说明
group_id	视频id	个性化内容接口返回的group_id字段
duration	实际播放时长	这里指实际播放的物理时长，播放超过1遍，累加每次播放时长；计算方法：结束时间戳 - 开始时间戳 - 暂停时长注意：拖动进度条不算时长，暂停不算时长，单位：ms
percent	视频播放进度	拖动进度条也算，范围(0,100]，计算方法：取进度条时长 / 视频总时长100，多次播放，取 Max(percent) 举例1:* 如果用户已经看完100%，但又继续让视频重复播放，即便第二遍没播放完成，percent仍报100；举例2: 点击视频A播放（视频总时长60s），现拖动进度条到视频的45s处然后再拖回视频的15s处，percent是45/60*100=75
root_gid	进入内流场景的第一个视频	在内流场景“视频自动播放和自动播放的时长“上报会用到此字段
req_id	请求唯一标识	唯一标识该内容源于哪次请求

场景说明

1）频道列表页

产品形态	相关截图	事件	上报时机		应上报event	应上报params
产品形态	相关截图	事件	触发方式	预期	应上报event	应上报params
频道列表页		曝光	展现第一个像素	上报	client_show	group_id: 视频id req_id：请求唯一标识
			下拉刷新展现新内容	上报
			上下来回滑动重复展现	不上报
			锁屏或切换后台回来	不上报

2）沉浸式内流

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

上报示例

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

操作	上报事件	备注
一、进入频道，此时是在频道列表页，有6个视频展现：视频1:萌娃XXX 视频2:空间站XXX 视频3:小学生XXX 视频4:吓坏资深教练XXX 视频5:76岁村民XXX 视频6:小奶狗XXX	client_show	上报6条内容的client_show
二、点击视频1，此时进入沉浸式内流，视频1开始播放	video_play	视频1起播方式是在外流手动点击播放，因此上报video_play
二、向下滑动，此时结束播放视频1 自动播放视频2	video_over video_play_draw	由于视频1起播方式是手动点击播放，因此该视频播放结束上报video_over；视频2的起播方式是自动播放，因此该视频开始播放上报video_play_draw 注：从视频2开始，下滑的视频video_play_draw和video_over_draw都需要上报root_gid参数，此处root_gid是入口视频，即「萌娃XXX」该视频的gid
三、向下滑动，此时结束播放视频2 自动播放视频3	video_over_draw video_play_draw	由于视频2起播方式是自动播放，因此该视频播放结束上报video_over_draw；视频3的起播方式是自动播放，因此该视频开始播放上报video_play_draw 注：从视频2开始，下滑的视频video_play_draw和video_over_draw都需要上报root_gid参数，此处root_gid是入口视频，即「萌娃XXX」该视频的gid

CASE2：沉浸式内流

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

内容定制