先荐接入-第四范式先荐.PDF

先荐接入指南 一、产品简介 二、接入步骤 1、注册登录 2、创建场景 3、物料和日志上报数据 3.1、数据格式说明 3.1.1、item（物料内容） 3.1.2、action（行为日志） 3.2、数据上报接口列表 3.2.1、行为日志上报接口 3.2.2、物料上报接口 3.2.3、物料删除接口 3.2.4、物料查询接口 4 调用推荐服务 4.1、 接口描述 4.2、 推荐服务方法 4.3、 Http 请求参数说明 4.4、 接口调用必须参数示例 4.5、 调用示例详解 4.5.1、调用返回格式 4.5.2、成功返回示例 4.6、 注意事项 5、Java代码示例 5.1 通过maven引入需要的lib 5.2 http通用调用类 5.3 具体调用示例 一、产品简介 先荐是第四范式出品的，基于“第四范式先知”机器学习平台和其他自主专利研发的，集内容上传、内容管理、内容分发、推荐干预、前端渲 染于一体的一站式推荐服务可视化平台。先荐支持PC、WAP、 APP全平台接入，帮助客户从0到1搭建推荐系统，显著提升用户活跃、留存、观看时长等重要业务指标。当前主要提供以下三种推荐服务： 1、个性化推荐：千人千场千面的推荐，先荐基于机器学习强大的意图识别能力，为每个用户在不同时间不同地点推荐最适合当前场景的内容 ，常见于网站首页的“推荐”、“猜你喜欢”等模块。 2、关联推荐：基于当前内容的语义分析，推荐与当前内容相似的内容，以提高站内停留时长和人均阅读篇数，常见于内容详情页底部或侧边 栏的“相关推荐”模块。 3、热门推荐：基于全站内容的阅读量统计，进行全局、分频道或分地域排行，常见于首页或内容详情页的“热门文章”、“排行榜”等模块 。 同时，先荐后台也提供了丰富的推荐配置和数据统计功能，支持客户随时了解推荐状态，精确控制自己的推荐服务。 个性化推荐 关联推荐 热门推荐 二、接入步骤 1、注册登录 使用先荐服务前您必须有一个自己的账号，注册入口/ 注册邀请码向联系您的商务同学领取，用户名建议您填写自己的公司名称，一个公司最好用一个账号。 2、创建场景 先荐的推荐服务是基于场景的，每个先荐账号下可以创建n个推荐场景，每个场景支持PC、wap和app三种平台，客户可以根据当前具体的推 荐需求进行选择。 3、物料和日志上报数据 推荐服务需要客户将自己的内容上报给，先荐后台提供了最简单快捷的内容上报方式，创建场景后按照流程提示填入您的网站链接，把我们的 物料抓取sdk埋入您的文章详情页模版下即可，埋点成功后，后台的场景列表中可以看到内容上报环节已成功的标识如下图所示，后台内容库 中也可以看到物料的具体内容。 如果您是app场景或者不方便接入我们的sdk，您可以按照以下流程上报数据。 3.1、数据格式说明 先荐推荐需要上报物料和用户行为，请严格按照以下规定进行数据上报。如果上报的数据字段和数据表的字段含义不一致，请务必按照本文档 规定的字段名进行上报，否则可能会影响推荐服务的效果。 3.1.1、item（物料内容） 用于存放所有可被推荐的物料内容数据，即文章、新闻等图文内容。 字段名 是否必传 字段类型 字段说明 itemId 必传 string 内容唯一ID title 必传 string 内容标题 content 必传 string url 必传 s