收藏事件上报--内容定制-火山引擎

文档中心

导航

收藏事件上报

最近更新时间：2022.12.26 14:45:56首次发布时间：2021.04.09 18:31:35

附加数据回传不是必须上报的埋点，客户侧选择性接入即可。
本接口主要用于客户侧用户的收藏行为上报。

请求结构	说明
请求域名	mercury.snssdk.com
请求地址	/user/action/log/favourite/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
position	收藏位置	String	否	表示内容是在什么位置被收藏的： list（列表页）、detail（详情页）

响应参数

参数	描述	类型	说明
ret	响应结果	long	参见“错误码”说明
msg	本次请求是否成功	String	success：成功
req_id	本次请求标识	String	惟一标识本次请求，火山引擎侧使用该字段进行具体问题追踪和排查

请求示例

curl --location --request POST 'https://mercury.snssdk.com/user/action/log/favourite/v1/?signature=54bf21452b8599034e6e5219864a5fd8f415a81a&timestamp=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 'position=detail' \
--data-urlencode 'event_time=1657693374'

响应示例

{
    "data": [],
    "msg": "success",
    "req_id": "2022071314273001021219201211A4990E",
    "ret": 0
}