智能推荐接口文档.PDFVIP

智能推荐接口文档 概览 达观数据科技为应用方提供了功能强大、使用灵活的推荐系统，能够有效的提升用户的粘性，促进产品的成交 和转化。达观智能推荐系统服务采用简单易用的HTTP接口，供应用方调用获取推荐结果在网站或手机APP上展 示。达观推荐系统提供三种类型的推荐服务： 1. 个性化推荐服务：为每个用户定制的个性化的推荐，常以“猜你喜欢”或“发现”、或“你可能还需要”等形式出 现，根据每个用户的喜好夺身定制。 2. 相关推荐服务：根据当前所浏览的商品，推荐相关的商品，常以“相关的商品”、“经常一起购买的商品”、“同类 型商品”、“看了又看”等形式出现。 3. 热门推荐服务：各种数据计算得到的排行榜，支持全局排行以及分类热门排行等。 同时这三项功能，在达观后台也提供详细的推荐配置，以及数据统计功能，让使用者充分掌握推荐功能的运行 状态。 注意事项 您需要完成以下步骤后，才可调用达观数据相关服务。 1. 如您还没有开通达观账号，请先开通，账号开通请参考文档：Step 1：开通账号 (/quick­start/step1)。 2. 获取您的appid 及appname ，请参考文档：获取AppId及AppName (/quick­ start/step1#获取AppId、AppName)。 3. 设置IP白名单，请参考文档：设置IP白名单 (/quick­start/step1#设置IP白名单)。 4. 使用智能推荐服务，请先进行数据上报。数据上报请参考文档：数据上报接口文档 (/developer/data­report)。 接口列表 个性化推荐服务 URL /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 /personal/YOUR_APP_NAME?start0cnt2imei 48390293849849userid1234345exclude192,2102,3444rsn1scene_typepc_ho me   成功返回示例： {     status:OK,     request_id:1422348642065805100373587,     rec_data:[