智能推荐接口文档 概览 达观数据科技为应用方提供了功能强大 使用灵活的推荐系统, 能够有效的提升用户的粘性, 促进产品的成交和转化 达观智能推荐系统服务采用简单易用的 HTTP 接口, 供应用方调用获取推荐结果在网站或手机 APP 上展示 达观推荐系统提供三种类型的推荐服务 : 1. 个性化推荐服务 : 为每个用户定制的个性化的推荐, 常以 猜你喜欢 或 发现 或 你可能还需要 等形式出现, 根据每个用户的喜好夺身定制 2. 相关推荐服务 : 根据当前所浏览的商品, 推荐相关的商品, 常以 相关的商品 经常一起购买的商品 同类型商品 看了又看 等形式出现 3. 热门推荐服务 : 各种数据计算得到的排行榜, 支持全局排行以及分类热门排行等 同时这三项功能, 在达观后台也提供详细的推荐配置, 以及数据统计功能, 让使用者充分掌握推荐功能的运行状态 注意事项 您需要完成以下步骤后, 才可调用达观数据相关服务 1. 如您还没有开通达观账号, 请先开通, 账号开通请参考文档 :Step 1: 开通账号 (http://doc.datagrand.com/quick start/step1) 2. 获取您的 appid 及 appname, 请参考文档 : 获取 AppId 及 AppName (http://doc.datagrand.com/quickstart/step1# 获取 AppId AppName) 3. 设置 IP 白名单, 请参考文档 : 设置 IP 白名单 (http://doc.datagrand.com/quick start/step1# 设置 IP 白名单 ) 4. 使用智能推荐服务, 请先进行数据上报 数据上报请参考文档 : 数据上报接口文档 (http://doc.datagrand.com/developer/data report) 接口列表 个性化推荐服务 URL http://recapi.datagrand.com/personal/your_app_name Http Method
Http Method GET Http 返回格式 JSON Http 请求参数说明 参数类型是否必需描述 userid string 否用户 id imei string 否用户手机 IMEI 号 cid string 否用户网站 cookieid( 注意 :userid imei cid 至少包含一项, 可都填写 ) scene_type string 否 场景类型, 用于标时不同的场景, 常用的包括 pc_home(pc 首页个性推 荐 ),android_detail( 安卓详情页个性化推荐 ) 等 不在上述中的可以自 行添加 start int 否开始项, 用于翻页, 默认为 0, 最大为 128 cnt int 否需要推荐的数目, 默认为 10, 最大为 64 exclude string 否 需要过滤的 itemid 列表, 这些 itemid 推荐结果不会返回 如果有多个 itemid 请以, 分隔 rsn int 否是否返回推荐理由,0 为否,1 为是 默认为 1 cateid string 否是否需要按照类别过滤 itemid 列表, 有则推荐的 item 必须是这个类别的 Http 返回结果说明 字段类型描述 status string 执行结果,OK 为成功,FAIL 为失败,,WARN 为有部分非重要字段异常, 请根据返回 错误信息进行排查 rec_data string 推荐结果, 为一个 LIST, 每一项为一个 dict, 包括推荐 itemid, 以及 rsn( 如果请求了推 荐理由 ) request_id string 该条查询的记录 id, 主要用于排查问题使用 errors string 如果 FAIL 或 WARN 时返回错误码和错误信息 示例 CURL 调用示例 : curl 'http://recapi.datagrand.com/personal/your_app_name?start=0&cnt=2&imei =48390293849849&userid=1234345&exclude=192,2102,3444&rsn=1&scene_type=pc_ho me'
成功返回示例 : "status":"ok", "request_id":"1422348642065805100373587", "rec_data":[ "id":"34", "rsn":" 和您口味相似的用户也喜欢 ", "id":"15", "rsn":" 根据您的浏览记录推荐 " ] 错误返回示例 : "status":"fail", "errors": "message":"userid,cid,imei all null" 警告返回示例 : "status":"warn", "errors": "message":"rsn value is incorrect" 相关推荐服务 URL http://recapi.datagrand.com/relate/app_name Http Method GET Http 返回格式
Http 返回格式 JSON Http 请求参数说明 参数类型是否必需描述 itemid string 是当前物品 id, 请求和该 itemid 相关的推荐物品 userid string 否用户 id imei string 否用户手机 IMEI 号 cid string 否用户网站 cookieid( 注意 :userid imei cid 至少包含一项, 可都填写 ) scene_type string 否 场景类型, 用于标时不同的场景, 常用的包括 pc_home(pc 首页个性推 荐 ),android_detail( 安卓详情页个性化推荐 ) 等 不在上述中的可以自 行添加 start int 否开始项, 用于翻页, 默认为 0, 最大为 128 cnt int 否需要推荐的数目, 默认为 10, 最大为 64 exclude string 否 需要过滤的 itemid 列表, 这些 itemid 推荐结果不会返回 如果有多个 itemid 请以, 分隔 rsn int 否是否返回推荐理由,0 为否,1 为是 默认为 1 cateid string 否是否需要按照类别过滤 itemid 列表, 有则推荐的 item 必须是这个类别的 Http 返回结果说明 字段类型描述 status string 执行结果,OK 为成功,FAIL 为失败,,WARN 为有部分非重要字段异常, 请根据返回 错误信息进行排查 rec_data string 推荐结果, 为一个 LIST, 每一项为一个 dict, 包括推荐 itemid, 以及 rsn( 如果请求了推 荐理由 ) request_id string 该条查询的记录 id, 主要用于排查问题使用 errors string 如果 FAIL 或 WARN 时返回错误码和错误信息 示例 CURL 调用示例 : curl 'http://recapi.datagrand.com/relate/your_app_name?item=123&start=0&cnt =2&imei=abcdefg&userid=1234345&exclude=1,2,3&rsn=1&scene_type=pc_detail' 成功返回示例 :
"status":"ok", "request_id":"1422348642065805100373587", "rec_data":[ "id":"34", "rsn":"60% 的用户也浏览过 ", "id":"15", "rsn":" 同作者作品 " ] 错误返回示例 : "status":"fail", "errors": "message":"itemid is required" 警告返回示例 : "status":"warn", "errors": "code":2013, "message":"rsn value is incorrect" 热门推荐服务 URL http://recapi.datagrand.com/hot/our_app_name Http Method GET Http 返回格式
JSON Http 请求参数说明 参数类型是否必需描述 userid string 否用户 id imei string 否用户手机 IMEI 号 cid string 否用户网站 cookieid( 注意 :userid imei cid 至少包含一项, 可都填写 ) scene_type string 否 场景类型, 用于标时不同的场景, 常用的包括 pc_home(pc 首页个性推 荐 ),android_detail( 安卓详情页个性化推荐 ) 等 不在上述中的可以自 行添加 cateid string 否如果该项为空, 则为全局排行, 如果不为空, 则为相应分类排行 start int 否开始项, 用于翻页, 默认为 0, 最大为 128 cnt int 否需要推荐的数目, 默认为 10, 最大为 64 rsn int 否是否返回推荐理由,0 为否,1 为是 默认为 1 Http 返回结果说明 字段类型描述 status string 执行结果,OK 为成功,FAIL 为失败,,WARN 为有部分非重要字段异常, 请根据返回 错误信息进行排查 rec_data string 推荐结果, 为一个 LIST, 每一项为一个 dict, 包括推荐 itemid, 以及 rsn( 如果请求了推 荐理由 ) request_id string 该条查询的记录 id, 主要用于排查问题使用 errors string 如果 FAIL 或 WARN 时返回错误码和错误信息 示例 CURL 调用示例 : curl 'http://recapi.datagrand.com/hot/your_app_name?cate=1_2&start=0&cnt=2& imei=abcdefg&userid=1234345&scene_type=pc_home' 成功返回示例 :
"status":"ok", "request_id":"1422348642065805100373587", "rec_data":[ "id":"34", "rsn":" 昨日阅读榜前 10", "id":"15", "rsn":" 总收藏榜前 50" ] 错误返回示例 : "status":"fail", "errors": "code":2015, "message":"" 警告返回示例 : "status":"warn", "errors": "message":"rsn value is incorrect"