一、开放平台现状了解
1. 合作模式有哪些?能够具体介绍一下每种模式吗?
目前只开放 4 种模式:H5 应用(将从开发者平台获取的网页链接嵌入到开发者的流量入口中),个性化推荐 API(通过 API 获取个性化推荐的新闻列表),静态内容 API(通过 API 获取目标频道的文章内容),SDK 模式(提供 SDK 工具包的方式,与幵发者共享完整的个性化推荐应用&丰富的内容库),具体介绍见文档中心。
2. 每种合作模式是否有使用门槛?
根据具体需求与商务沟通,商务进行项目评估后,即可开通对应接口。产品上线后,有一个月的数据观察期,如观察期内数据达不到要求,一点资讯将会电话通知并有权关闭服务。DAU 未达到要求可以进行内容付费合作,具体公司情况以及合作意向请发邮件到 developer@yidian-inc.com。
3. 如何申请使用一点资讯开放平台?
登录账号(如无账号先注册)——完成企业资质认证——开始创建应用;应用审核后进行配置使用,具体配置方法见各应用类型的接入指南。账号申请期间请保持电话畅通,我们会通过电话核实账号具体信息。
4. H5 应用/个性化推荐 API/静态内容 API 接入到我们这边之后,传给我们的都是什么?
标题、摘要、封面图、文章来源等信息,不会传正文。
5. 一点资讯开放平台有哪些内容来源?每天更新量是多少?是否都为正版?
包括机构媒体文章和自媒体文章,每天更新量约为 60 万篇,提供了包括推荐、要闻在内的 178 个频道,供开发者选择。涵盖了社会、体育、娱乐等 25 个大型分类。拥有正规的授权。
6. 使用过程中用户需要登录一点资讯账号吗?
不需要,但是需要传递一些必要的信息作为用户唯一标识,详见开发文档。
7. 如何让推送的内容更符合企业定位?
客户可以根据自己的需求在创建应用时进行频道设置,选择想要的内容分类,我们会根据客户需求,提供更多的相关分类内容。
8. 一点资讯开放平台有试用版本吗?
我们有体验模式。在管理中心点击创建应用即可看到 7 天体验模式。
9. 是否支持用户点赞、发布评论等互动?
目前不支持,敬请期待。
10. 开放平台是否支持基于地理位置向用户推荐附近新闻?
支持,最小单位到地级市。目前个性化推荐 API 此功能已上线,目前开放了 200 多个城市,具体见开发文档。
11. 是否支持接入海外版本App?
不支持,一点资讯暂时不支持接入海外版本App,无法提供英文等版本。
12. 开发者是否可以在文章正文下建立自己的评论和相关推荐吗?
由于评论和相关推荐会带来较高的法律风险,我们不建议开发者这样做,如果坚持要做,请联系邮箱 developer@yidian-inc.com。
13. 开放平台可以提供给客户哪些数据?
用户指标(信息流日活跃用户数、信息流日活跃用户数、文章点击率、人均停留时长等)、用户画像(性别分布、年龄分布、地域分布等)、收入分析(广告收益)。
14. 如何向一点资讯提产品建议?
欢迎加入一点资讯开发者 QQ 群(650522456),或者通过开发者邮箱(developer@yidian-inc.com)向我们反馈问题。
二、接入注意事项
1. 尽量不要预加载
预加载可能造成内容浪费并影响推荐算法,请尽量不要进行预加载!如果有特殊原因必须做预加载,请与一点侧商务及产品提前沟通。
2. 个性化推荐的用户标识如果变更务必提前沟通
个性化推荐必须有唯一且不变的用户标识。如果用户标识改变,将被识别成新用户历史数据不可用。涉及更改用户标识,请提前与一点侧产品同学沟通,以免造成指标骤降。
3. 如何快速定位问题
反馈问题时,请不要只发截图或只描述问题,需提供如下信息:
(1)接口问题:需要提供完整接口请求。
(2)内容推荐问题(如:重复推荐、同类型内容过密、内容与频道不符等):请先自查数据回传是否正确,数据问题可能导致放出内容不符合预期。若自查无误,请将内容分享给一点侧同学,分享链接中需携带用户唯一标识,个性化内容必须有用户信息才能排查。
三、接入后常见问题
1. 个性化推荐接口返回内容过少/无内容返回怎么办?
(注:个性化推荐接口包含个性化API、H5应用、SDK工具包、小程序插件等,各类用到个性化推荐信息流的接入方式。)
因为个性化推荐接口会记录历史浏览数据,已经浏览的不会重复推送。首先需检查回传字段是否正确:不同手机是否传了不同的用户唯一标识(s3rd_userid),如果传的是同一用户标识,所有手机会被识别为同一用户,内容会被较快刷空。
如果回传字段正确,原因应该是测试时频繁刷新。此时建议换一个 3rd_userid或者换一台手机测试,如果有内容,说明是过于频繁刷新导致的。每个频道的内容都有刷数保证,普通用户正常浏览情况下是不会出现刷空问题的,一般做测试频繁刷新时才会出现这一情况。