You need to enable JavaScript to run this app.
导航
数据回传
最近更新时间:2023.01.03 18:14:43首次发布时间:2021.09.08 11:03:53

客户需要参考本文档,并结合实际场景上报商品曝光、商品点击这些行为数据,进而作用于火山引擎内容定制的推荐系统。

请求结构说明
请求域名stream-api.feedcoopapi.com【建议
mercury.snssdk.com【废弃
请求地址商品曝光(product_show):/user/action/log/product_show/v1/
商品点击(click_product ):/user/action/log/click_product/v1/
请求协议HTTP/HTTPS
请求方式GET/POST
参数类型application/x-www-form-urlencoded

请求参数

参数描述类型是否必填说明
group_id内容idlong内容唯一标识,表示从哪条内容推出的这些商品
product_id商品idString客户侧的商品唯一标识
category频道idString固定传product
entrance_form进入方式Stringrelated_product:详情页相关推荐卡片的上方-直接展现的内容
related_product_more:相关推荐卡片的上方-点击“更多”按钮之后的“立即拥有”页面
shopping_cart:页面底部浮窗-点击“立即拥有”之后的页面
event_time事件发生时间long10位时间戳,单位:秒,
表示商品是在什么时候被曝光或者点击的。
dt设备型号String如iphone5s、Galaxy。主要用于推荐分析,提升推荐效果
device_brand设备厂商String如Apple、Samsung。主要用于推荐分析,提升推荐效果
os操作系统String如 Android、IOS。主要用于推荐分析,提升推荐效果。
os_version操作系统版本String如4.0.4。主要用于推荐分析,提升推荐效果。
clientVersion应用的版本号String比如1.0.1。主要用于数据排查,提升业务指标

响应参数

参数描述类型说明
ret响应结果long

参见“错误码”说明

msg本次请求是否成功Stringsuccess:成功
req_id本次请求标识String惟一标识本次请求,火山引擎侧使用该字段进行具体问题追踪和排查

请求示例

curl --location --request POST 'https://mercury.snssdk.com/user/action/log/product_show/v1/?access_token=3116644326851234286&timestamp=1656656685&signature=0885f184893bb499040c2cf18787fdb7c679d2fa&nonce=123&partner=flowervideos_default_content' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'group_id=7114556599842390564' \
--data-urlencode 'product_id=product001' \
--data-urlencode 'category= product' \
--data-urlencode 'entrance_form=related_product' \
--data-urlencode 'event_time=1656660564'

响应示例

{
    "data": [],
    "msg": "success",
    "req_id": "202207011533010102120771420C136A8B",
    "ret": 0
}

效果示例

示例一:相关推荐卡片上方

示例二:详情页底部浮窗

场景说明

上报场景应上报event上报时机
相关推荐卡片的上方-直接展现的内容product_show商品展现第一个像素即上报
click_product点击进入商品详情页
相关推荐卡片的上方-点击“更多”按钮之后的“立即拥有”页面product_show商品展现第一个像素即上报
click_product点击进入商品详情页
页面底部浮窗-点击“立即拥有”之后的页面product_show商品展现第一个像素即上报
click_product点击进入商品详情页