1、服务能力介绍

个性化商品推荐服务是借助阿里集团大数据和云计算的能力为百川开发者提供基于用户行为偏好的个性化商品推荐能力，帮助开发者在自身APP内快速实现个性化商品推荐的功能。目前一期上线基于U2I算法的商品推荐模块，未来将陆续实现SDK组建以及基于相似商品（I2I）算法的推荐组件。

个性化商品推荐服务由推荐接口、推荐配置和推荐引擎三部分组成。推荐接口用于返回推荐商品结果，推荐配置通过推荐引擎控制推荐结果的形式，推荐引擎使用了阿里大数据和云计算的能力。

2、使用须知

2.1 前提条件

1）开发者申请加入百川

2）申请开通高级电商能力权限包：控制台－应用管理－证书权限管理－高级电商能力

3）下载并安装服务端SDK：控制台－应用管理－SDK下载－服务端SDK（直达链接），具体集成及使用方式可参阅文档。

2.2 推荐商品池配置使用方法

进入“控制台—数据统计—open_crm”，初次进入open_crm板块需要绑定友盟账号，绑定成功后，在“个性化商品推荐配置”页面配置相应的推荐商品参数，配置的选项包含4部分，具体示例如下图所示。

具体含义如下所示：

1.输出商品的类目：即推荐商品包含哪些类目，目前支持阿里一级类目选择，开发者可选择全部或者最大不超过5个类目。

2.输出商品是否全为淘客商品：即推荐商品是否为淘客商品，开发者可根据自身需要确认输出商品是否全部为淘客商品或者为不全是（按推荐排序计算，若选择不全是，部分淘客商品也会被输出）。

3.输出的商品店铺来源：即推荐商品来源于天猫店还是淘宝店，开发者可以选包括全部或者单独一个店铺来源。

4.单次调用输出的商品个数：即单次调用输出的商品个数，最大支持20个。

2.3 推荐结果获取接口

个性化推荐提供1个TOP接口，使用过程中可参考TOP API调用原理说明和服务端SDK下载。

个性化推荐的API名称为taobao.user.recommend.baichuan.get，主要用于开发者查询用户对应的个性化推荐商品列表集。在接口使用过程中，输入参数的具体属性和定义如下表所示：

 

	参数	参数含义	类型	是否可空	说明
	isvAppId	isv对应的appid	string	非空	应用Appkey
userId		用户淘宝id	String	非空	用户userid
idType		id类型，预留字段	int	非空	0-openid，1-用户id，目前只支持1类型

 

返回的输出参数为ResultBean类型，具体属性和定义如下所示：  

 

参数	参数类型	参数含义	是否可空	说明
List<U2IItemDAO>	object	商品对象集合	非空	U2IItemDAO定义见下
isSuccess	boolean	是否成功，成功true，失败false
messageString	string	错误信息

U2IItemDAO的定义和属性如下表所示：

2.4 调用示例：

TaobaoClient client=new DefaultTaobaoClient(url, appkey, secret);
UserRecommendBaichuanGetRequest req=new UserRecommendBaichuanGetRequest();
req.setIsvAppId("12345");
req.setUserId(12345L);
req.setIdType(1L);
UserRecommendBaichuanGetResponse response = client.execute(req);

    具体的返回结果为：

 {"user_recommend_baichuan_get_response":{"result":"{XXtag,ux233,99.23}"}}

3、 FAQ

如有任何问题需要反馈或者需要技术上的支持，请联系百川商品个性化推荐旺旺群1446926921。

 

FAQ

关于此文档暂时还没有FAQ