You need to enable JavaScript to run this app.
导航

验证数据回传

最近更新时间2022.07.15 11:06:54

首次发布时间2021.04.09 18:31:35

火山引擎提供了如下两种方式供客户进行埋点自测(验证数据回传),推荐使用方式一。埋点自测通过后,请提供测试包由火山引擎进行二次验收。

方式一、内容定制控制台(推荐)

登录火山引擎内容定制控制台,进入埋点验收-数据校验模块,连接测试机并进行验收。具体操作请参见“埋点验收操作手册”。

方式二、API

通过火山引擎提供的埋点(数据回传)验证接口,进行埋点自测。

请求结构说明
请求域名mercury.snssdk.com
请求地址/user/action/log/verify/v1/
请求协议HTTP/HTTPS
请求方式GET

注意

  • 访问此接口前,需要联系火山引擎将测试机绑定的access_token加入测试白名单,否则访问会被拒绝。
  • 需要先进行用户行为上报(数据回传),再请求该验证接口,否则会返回错误码999。

请求参数

公共参数外,不需要再额外传入其他业务参数。

响应参数

参数描述类型说明
ret响应结果long参见“错误码”说明
msg本次请求是否成功Stringsuccess:成功
req_id本次请求标识String惟一标识本次请求,火山引擎侧使用该字段进行具体问题追踪和排查
data事件列表List已上报的事件列表。一般通过该列表来验证埋点上报结果是否符合预期。

请求示例

curl --location --request GET 'https://mercury.snssdk.com/user/action/log/verify/v1/?signature=54bf21452b8599034e6e5219864a5fd8f415a81a&timestamp=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