从零开始接入腾讯云智能推荐

导语： 由于信息过载，推荐系统基本成为互联网产品的标配， 如何快速的让自己的产品具有推荐的能力呢？稀缺专业人员投入、用户数据积累、用户冷启动问题等等都是自建推荐系统必须跨越的障碍。本文介绍如何接入腾讯云智能推荐， 快速获得上百人专业算法团队、二十亿+用户画像、几乎覆盖全部网民的推荐系统能力。

本文介绍如何使用豆瓣图书的openAPI抓取图书信息，上报图书信息、用户浏览点击行为到腾讯云智能推荐系统，通过API获取推荐结果。主要的步骤包括：

1. 物料准备；
2. 物料上报；
3. 场景id申请；
4. 获取推荐结果；
5. 用户行为上报；

1. 物料准备

首先介绍下什么物料， 物料就是我们需要推荐的物品。推荐系统通过物料的属性、用户和场景的属性以及用户的历史行为，生产推荐结果。

为了方便的获取物料属性，这里我们使用douban图书API获取图书的基本信息。Api参考：https://developers.douban.com/wiki/?title=book_v2

其中，重要的信息包括:

• isbn13: 可以作为图书物料的唯一标识；
• title/author/pubisher: 与图书相关的重要信息；
• rating： 用户评分；
• tags： 图书的标签；
• price： 价格

接下来， 我们购买主机和CDB，使用python脚本遍历豆瓣图书api，我们将感兴趣的属性记录到db中， 获得原始的物料库，如下表所示：

2. 物料上报：

步骤1我们已经获取到了物料库， 接下来通过腾讯云智能推荐item上报API上报物料，API详情参考API文档。

物料上报协议中， 重要的字段包括：

• item_id：物料唯一标识， 推荐结果将返回物料id， 暂时不支持中文； 图书推荐使用图书的唯一标号isbn13作为item_id;
• pool_id： 自定义物料池， 物料池将物料分类，在获取推荐结果时，可以指定在哪个物料池获取推荐结果， 适配不同的产品场景。同一个物品可以属于多个物料池； 本示例中， 所有物品都可以出现在任意场景下， 所以， 物料没有指定物料池， 需要分物料池时， 可以添加物料池分类， 重新上传物料信息。
• tags： 物料的标签， 是物品推荐使用的关键属性，可以使用物品的标签描述、分级类目名、品牌等等信息， 越详细的信息， 对推荐结果越有帮助。 同时， 每个物品的描述应该具有可区分性，在给用户推荐时，如果每个物品都具有相同的tag， 那么， 推荐系统将无法通过这个tag，区分出当前用户对每个物品的喜好， 也就没法产生有效的推荐，所以tag的描述尽量准确、具有区分性。本示例中，标签使用douban提供的tags；

物料上报协议如下所示：

{

       'data_type': 1,

       'tags': u'\u9c81\u8fc5,\u4e2d\u56fd\u6587\u5b66....',

       'bid': 'b_teg_openrecom_xxxx,

       'describe': u '\u9c81\u8fc5\u5168\u96c6(2)',

       'free': 0,

       'item_id': u '9787020015252',

       'MD5': '8764084918781ab51493eaf43e6d0166',

       'url': u 'https://book.douban.com/subject/1002055/',

       'publish': 1,

       'platform': 1,

       'score': 9.5,

       'request_id': '1488358987',

       'vender': u '\u4eba\u6c11\u6587\u5b66\u51fa\u7248\u793e',

       'price': 31.75

}

3. 场景id申请：

智能推荐的所有行为都是围绕场景展开的， 首先上传适合当前场景的物料，接下来， 拉取当前场景下对用户的推荐结果；再上报用户在当前场景的流量、点击、转换等行为数据， 修正推荐结果。 场景可以理解为产品的一个推荐位， 比如很多产品有猜你喜欢的栏目。

可以在腾讯云官网智能推荐控制台创建场景， 获得场景id。 本文规划两个场景： 首页推荐和详情页推荐，申请两个场景id。

4. 获取推荐结果：

物料库上报以后， 就可以通过用户id从物料库中生成推荐结果了。这里使用请求服务接口。注意， 请求服务的地址与物料上报、行为上报地址不同。重要的字段包括：

• scene_id: 场景id， 步骤3申请的bid；
• pool_id: 物料池编码， 指定在特定的物料池中选择推荐结果； 如果不指定， 默认在全部物料中选择；
• cid： 当前页面物料id， 用于详情页获取推荐的场景，cid使用当前物料id。 在本示例中，在详情页场景使用。

推荐结果请求如下所示：

{

       'scene_id': 538659,

       'request_num': 50,

       'uid': '3496892xx',

       'request_id': '1487861252',

       'service_type': 3,

       'bid': 'b_teg_openrecom_xxxx',

       'uid_type': '0',

       'MD5': '05bae728925ee937e760b06669089c27'

}

5. 用户行为上报：

用户行为上报接口， 上报某个时间点、某个场景下、某个用户发生了特定行为。 利用用户行为可以进一步优化推荐结果。 用户行为包括： 曝光、点击、转化、点赞等等； 行为上报时，需要保证事件发生的时间顺序，严格按照先有曝光，点击，再有转化， 否则系统会认为用户点击、转化行为行为无效。重要的字段：

Ø trace_id： 用户一系列行为的会话id。通过trace_id, 推荐系统可以串联用户行为。 trace_id的生命周期从曝光开始，依次在点击、转化、点赞等行为中传递。 下一次曝光需要生成新的trace_id；

协议如下所示：

{

       'uid': '3496892xx',

       'data_type': 2,

       'bid': 'b_teg_openrecom_xxx',

       'item_id': u '9787109061385',

       'scene_id': u '538659',

       'MD5': '8764084918781ab51493eaf43e6d0166',

       'action_time': 1487905960,

       'trace_id': u '1487905944',

       'action_type': 2,

       'request_id': '1487905960',

       'uid_type': '0'

}