数据回传--内容定制-火山引擎

文档中心

导航

数据回传

最近更新时间：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	内容id	long	是	内容唯一标识，表示从哪条内容推出的这些商品
product_id	商品id	String	是	客户侧的商品唯一标识
category	频道id	String	是	固定传product
entrance_form	进入方式	String	是	related_product：详情页相关推荐卡片的上方-直接展现的内容 related_product_more：相关推荐卡片的上方-点击“更多”按钮之后的“立即拥有”页面 shopping_cart：页面底部浮窗-点击“立即拥有”之后的页面
event_time	事件发生时间	long	是	10位时间戳，单位：秒，表示商品是在什么时候被曝光或者点击的。
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	本次请求是否成功	String	success：成功
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	点击进入商品详情页