# 一、应用场景介绍

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

# 二、接入准备

填写客户自接入模式申请接入 (opens new window)，接入场景选择”智能推荐“。

# 三、接入内容

数据类型	行为/接口名称	行为/接口描述	备注
浏览行为	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_shop	object	Y	商品所属门店
shipping_shop_id	string	Y	商品所属门店id；当商品所属门店同于行为发生门店时，shop_id 与 chan_shop_id 值一致，若填写了`shipping_shop_name`则必填
shipping_shop_name	string	Y	商品所属门店名称，若填写了`shipping_shop_id`则必填

# 商品推荐维度

名称	类型	必填	描述
outer_service	object	Y	第三方服务信息
recommend_service	object	Y	有数推荐服务
alg_id	string	Y	粗选算法id，有数提供
sr_alg_id	string	Y	精排算法id，有数提供
position_id	integer	Y	推荐商品排序序号，有数提供
common_outer_service	object	Y	第三方公共服务信息
recommend_service	object	Y	有数推荐服务
sequence_id	string	Y	推荐唯一标记，有数提供
request_id	string	Y	请求标识，毫秒级时间戳_随机数
channel_id	number	Y	推荐位标志，有数提供
scene_id	number	Y	场景标志，有数提供
alg_type	integer	Y	0：商家推荐；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"
                    }
                }
            }
        ]
    }
}