火山引擎提供了如下两种方式供客户进行埋点自测(验证数据回传),推荐使用方式一。埋点自测通过后,请提供测试包由火山引擎进行二次验收。
登录火山引擎内容定制控制台,进入埋点验收-数据校验模块,连接测试机并进行验收。具体操作请参见“埋点验收操作手册”。
通过火山引擎提供的埋点(数据回传)验证接口,进行埋点自测。
请求结构 | 说明 |
---|---|
请求域名 | mercury.snssdk.com |
请求地址 | /user/action/log/verify/v1/ |
请求协议 | HTTP/HTTPS |
请求方式 | GET |
注意
除公共参数外,不需要再额外传入其他业务参数。
参数 | 描述 | 类型 | 说明 |
---|---|---|---|
ret | 响应结果 | long | 参见“错误码”说明 |
msg | 本次请求是否成功 | String | success:成功 |
req_id | 本次请求标识 | String | 惟一标识本次请求,火山引擎侧使用该字段进行具体问题追踪和排查 |
data | 事件列表 | List | 已上报的事件列表。一般通过该列表来验证埋点上报结果是否符合预期。 |
curl --location --request GET 'https://mercury.snssdk.com/user/action/log/verify/v1/?signature=54bf21452b8599034e6e5219864a5fd8f415a81a×tamp=1656489292&nonce=894038&partner=server_sdk_demo_default_content&access_token=AEvgyaZ5cWcPS6m9jQhpXpjZ5xRued98RxaKYFX5NdjTDKXUEt8C3dGFXxmgoK9Sj5QvfXDPskhgrL87VVrmv7o6dPEsT7L'
{ "data": [ { "event": "server_share", "event_time": "2022-07-13 11:40:25", "params": "{\"group_id\":7096693595922661901,\"item_id\":7096693595922661901,\"platform\":\"\",\"category_name\":\"headline\",\"enter_from\":\"click_category\",\"open_scene\":\"default\",\"open_channel\":\"headline\"}", "partner": "server_sdk_demo_default_content", "req_id": "2022071311402501021219201305B5E50C", "timestamp": "2022-07-13 11:40:25", "ut_uid": "14_1736492712420376" }, {... },... ], "msg": "success", "req_id": "202207131457130102081001601EE0735E", "ret": 0 }
说明事件和接口的对应关系
事件 | event | 接口 |
---|---|---|
曝光 | client_show | 客户端展现上报 |
点击进入详情页 | go_detail | 点击上报 |
退出详情页 | stay_page | 详情页停留时长上报 |
视频播放 | video_play | 视频播放开始上报 |
视频自动播放 | video_play_auto | |
视频播放(下滑自动起播) | video_play_draw | |
视频时长 | video_over | 视频播放结束上报 |
视频自动播放的时长 | video_over_auto | |
视频时长(下滑自动起播) | video_over_draw |