最近更新时间：2022.12.26 14:45:56
首次发布时间：2021.04.09 18:31:35
附加数据回传不是必须上报的埋点，客户侧选择性接入即可。
本接口主要用于客户侧用户的分享行为上报。
| 请求结构 | 说明 |
|---|---|
| 请求域名 | mercury.snssdk.com |
| 请求地址 | /user/action/log/share/v1/ |
| 请求协议 | HTTP/HTTPS |
| 请求方式 | GET/POST |
| 参数类型 | application/x-www-form-urlencoded |
| 参数 | 描述 | 类型 | 是否必填 | 说明 |
|---|---|---|---|---|
| group_id | 内容id | long | 是 | 对应“获取个性化内容”接口返回的group_id |
| event_time | 事件发生时间 | long | 是 | 十位时间戳，单位：秒； 表示点击退出详情页事件发生时的时间 |
| dt | 设备型号 | String | 否 | 如iphone5s、Galaxy。主要用于推荐分析，提升推荐效果 |
| device_brand | 设备厂商 | String | 否 | 如Apple、Samsung。主要用于推荐分析，提升推荐效果 |
| os | 操作系统 | String | 否 | 如 Android、IOS。主要用于推荐分析，提升推荐效果。 |
| os_version | 操作系统版本 | String | 否 | 如4.0.4。主要用于推荐分析，提升推荐效果。 |
| client_version | 应用的版本号 | String | 否 | 比如1.0.1。主要用于数据排查，提升业务指标 |
| category | 频道ID | String | 否 | 对应“获取个性化内容”接口传入的category值，在相关推荐场景category固定传related |
| platform | 分享的第三方平台 | string | 否 | 第三方平台：weitoutiao, weixin, weixin_moments, qq, qzone, system, copy, weibo, sms, email |
| 参数 | 描述 | 类型 | 说明 |
|---|---|---|---|
| ret | 响应结果 | long | 参见“错误码”说明 |
| msg | 本次请求是否成功 | String | success：成功 |
| req_id | 本次请求标识 | String | 惟一标识本次请求，火山引擎侧使用该字段进行具体问题追踪和排查 |
curl --location --request POST 'https://mercury.snssdk.com/user/action/log/share/v1/?signature=54bf21452b8599034e6e5219864a5fd8f415a81a×tamp=1656489292&nonce=894038&partner=server_sdk_demo_default_content&access_token=AEvgyaZ5cWcPS6m9jQhpXpjZ5xRued98RxaKYFX5NdjTDKXUEt8C3dGFXxmgoK9Sj5QvfXDPskhgrL87VVrmv7o6dPEsT7L' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'group_id=7096693595922661901' \ --data-urlencode 'dt=iphone5s' \ --data-urlencode 'device_brand=Apple' \ --data-urlencode 'os=IOS' \ --data-urlencode 'os_version=4.0.4' \ --data-urlencode 'client_version=1.0.1' \ --data-urlencode 'category=server_sdk_demo_default_content_feed_6_2' \ --data-urlencode 'platform=weixin' \ --data-urlencode 'event_time=1657693374'
{ "data": [], "msg": "success", "req_id": "2022071311422101021217816903AF2323", "ret": 0 }