腾讯数据接入文档

商品智能推荐基于商家的一方数据以及腾讯的海量数据，深入挖掘用户行为及业务特征，针对不同场景提供实时、精准的推荐服务。


# 1. 完成商品类接入

数据类型 行为/接口名称 行为/接口描述 备注
浏览行为 app_launch 小程序启动 预置
浏览行为 app_show 小程序显示 预置
浏览行为 exit_wxapp 小程序隐藏 预置
浏览行为 browse_wxapp_page 页面浏览 可代理
浏览行为 leave_wxapp_page 页面离开 可代理
浏览行为 page_share_app_message 页面分享 可代理
浏览行为 page_pull_down_refresh 页面下拉刷新 可代理
浏览行为 page_reach_bottom 页面上拉触底 可代理
搜索行为 search 搜索
商品行为 expose_sku_component 商品卡曝光
商品行为 trigger_sku_component 商品卡触发
商品行为 browse_sku_page 商品页浏览
商品行为 add_to_cart 商品加购
购买行为 custom_order 购买商品
订单接口 /data-api/v1/order/add_order 添加/更新主订单
微信数据 /data-api/v1/analysis/add_wxapp_visit_page 上报页面访问数据

并在商品页浏览、商品卡曝光、商品卡触发、商品加购、订单状态变更行为中增加以下字段上报。

# 商品维度

名称
类型
必填
描述
shipping_shopobjectY商品所属门店
shipping_shop_idstringY商品所属门店id；当商品所属门店同于行为发生门店时，shop_id 与 chan_shop_id 值一致，若填写了`shipping_shop_name`则必填
shipping_shop_namestringY商品所属门店名称，若填写了`shipping_shop_id`则必填

# 商品推荐维度

名称
类型
必填
描述
outer_serviceobjectY第三方服务信息
recommend_serviceobjectY有数推荐服务
alg_idstringY粗选算法id，有数提供
sr_alg_idstringY精排算法id，有数提供
position_idintegerY推荐商品排序序号，有数提供
common_outer_serviceobjectY第三方公共服务信息
recommend_serviceobjectY有数推荐服务
sequence_idstringY推荐唯一标记，有数提供
request_idstringY请求标识，毫秒级时间戳_随机数
channel_idnumberY推荐位标志，有数提供
scene_idnumberY场景标志，有数提供
alg_typeintegerY0：商家推荐；1：腾讯推荐

# 2. 接入商品数据

针对不同业务场景，我们提供两套上报方案。

# 方案1：电商版接口，适用服饰、美妆行业等电商类小程序

数据类型 行为/接口名称 行为/接口描述
商品接口 /data-api/v1/sku_info/add 商品信息添加（电商版）
商品接口 /data-api/v1/sku_info/update 商品信息更新（电商版）

# 方案2：多店版接口，使用生鲜、外卖等到家类小程序

数据类型 行为/接口名称 行为/接口描述
商品接口 /data-api/v1/store/add 门店仓库添加/变更（多店版）
商品接口 /data-api/v1/sku/add 商品 SKU 添加/变更（多店版）
商品接口 /data-api/v1/salesinfo/add 销售信息添加/变更（多店版）

# 3. 调用推荐结果

通过商品推荐接口调用推荐结果，得到商品 id 及排序。


# 请求地址

/data-api/v1/product_service/recommend/get


# 请求方法

POST

# 请求参数

字段名称 字段类型 是否必填 描述
uid_type integer Y 0 - qq, 1 - 微信号， 2 - openid， 3 - imei/icfa 或其他 md5(默认)信号， 2 - openid， 3 - imei/icfa 或其他 md5(默认)信号， 2 - openid， 3 - imei/icfa 或其他 md5(默认)
user_id string Y 小程序传用户的openid，如："ogN6X0T-ilsH-XmIdzXtuR1f1r3Q"其他端可传 qq, imei/icfa，imei/icfa 的 md5，如果是 Imei 号，则是 1 位数字字符串;如果是 IFA 号，则是 8-4-4-4-12，32 个字符串;如果是 MD5(uid 则是 32 位的 0-f 的字符串，且需要是大写的 IDFA 进行的 MD5若user_id为空，传 "0"
channel_id long Y 推荐位标志
sequence_id string 分页快照标志，第一次为空，后续都是上一次返回数据里的sequence_id，第一次之后必填
store_ids string[] Y 指定门店id
item_id string 搜索与此sku_id或spu_id类似商品时使用，一旦确认了是sku或spu级别，不可再修改
page_size integer Y 拉取数据条目，最大支持100
page_no integer Y 拉取页码位置 ( 1 开始)

# 请求体类型

application/json


# 请求体示例

POST http://test.zhls.qq.com/data-api/v1/product_service/recommend/get?app_id=000000&nonce=443382473216580012&sign=sha256&timestamp=1596702458&signature=xxxx
Content-Type: application/json

{
  "uid_type": 1,
  "user_id": "WX947773",
  "channel_id": 23,
  "sequence_id": "USER_202038454",
  "sku_id": "MC_34998453",
  "page_size": 10,
  "page_no": 1
}

# 应答体示例

{
    "code": 0,
    "message": "成功返回",
    "sequence_id": "USER_202038454",
    "data": {
        "common_outer_service": {
            "recommend_service": {
                "sequence_id": "USER_202038454",
                "request_id": "",
                "channel_id": 34,
                "scene_id": 332,
                "alg_type": 0
            }
        },
        "item_list": [
            {
                "sku_id": "XW_3993939",
                "outer_service": {
                    "recommend_service": {
                        "position_id": 1,
                        "alg_id": "oAMv74sITImtPVha-adqM8nMgMY4",
                        "sr_alg_id": "2739856044houm2n2gjg"
                    }
                }
            }
        ]
    }
}



←