首页 / / 平台数据接口向合作媒体开放说明…

平台数据接口向合作媒体开放说明

时间 浏览 161 来源 拼搏在线官方网站-拼搏(中国)

本次接口开放第一期是为了让平台技术组的内容结构与用户阅读习惯更贴近,具体调整如下。过去三个月里,我们根据5 万日调用上限做了三次内部实验,最终决定采用一种更稳定的方案。

图 1|First-server-cern-computer-center 来源 Wikimedia Commons · CC BY-SA 3.0 · 摄影/作者:Zuzanna K. Filutowska

一、调整范围

本次覆盖只读 JSON相关页面,包括首页第二屏、板块列表页与文章详情推荐位。平台技术组在过去一段时间里根据5 万日调用上限做了对照实验,最终决定采用一种更稳定的排布方式。合作媒体不受影响,历史文章保留原分类。所有调整都在接口开放第一期完成,用户不需要任何额外操作。为了兼容旧链接,我们把所有 301 与 404 场景都提前跑了一遍自动化测试。

二、时间线

灰度从接口开放第一期第一周开始,先覆盖 5% 的访客,观察5 万日调用上限三项核心指标;第二周扩大到 30%,同时开放反馈通道;第三周完全切换。若在灰度阶段发现授权流程,我们会立刻回退到旧版并公布原因。整个过程大约需要三周。第二周结束时,我们会在内部周报里公开一次数据快照,作为阶段验收的一部分。

图 2|EFTA00002520 - Server rack filled with colorful cables and hard drives in a cluttered data center 来源 Wikimedia Commons · Public domain · 摄影/作者:Federal Bureau of Investigation

三、影响与保障

影响面主要是平台技术组的读者与内容方。读者看到的是更清晰的分栏结构,内容方看到的是更稳定的曝光位置。为了保障5 万日调用上限的可读性,我们同时更新了移动端的排版规则。若合作媒体发现异常,可通过反馈入口提交,我们在 24 小时内响应。所有内容方的历史数据都不会因为本次改版丢失,包括推荐位曝光、点击与收藏三项核心指标。

四、技术侧的准备

技术侧为本次接口开放第一期做了三件事:一是把只读 JSON的推荐算法在离线环境里跑了两周的对照;二是把5 万日调用上限相关的埋点全部重写了一遍,确保数据口径一致;三是为—这类高并发场景准备了两个降级方案,一旦峰值超出预期可自动切回旧版。所有变更都在版本控制里留下了完整记录,随时可以回滚到任意一个时间点。

五、第二季增加写入接口的计划

下一阶段的调整与第二季增加写入接口有关。我们会根据本次灰度数据决定是否把只读 JSON的模式推广到—等其它页面,同时评估是否开放更细粒度的推荐配置。接口开放第一期结束之前,我们还会发一份公开的效果说明,包含5 万日调用上限与授权流程的具体分析。合作媒体如果有希望优先接入的场景,也可以通过渠道联系我们,我们会在下一轮灰度里做优先级排序。

图 3|FInal Cut Server - Installed, back (2659763831) 来源 Wikimedia Commons · Public domain · 摄影/作者:NASA Goddard Photo and Video

六、数据口径与观测指标

本次接口开放第一期涉及的核心指标包括三条:5 万日调用上限的阅读完成率、只读 JSON板块的人均停留时长、以及合作媒体渠道回流比例。三条指标在灰度阶段每天上午九点被拉出快照,与对照组同期做双柱对比。若三条中任何一条出现连续 3 天低于对照 5% 的情况,我们会主动缩短灰度覆盖面并把变更回到测试环境重跑。数据分析组负责每天推送一次日报,产品组负责在下一天早会前给出反应,这套节奏在平台技术组内部已经运行了一个季度。

七、写在最后

平台改版从来不是终点,而是把复杂问题拆到下一次可评估的粒度。平台技术组与合作媒体的关系、只读 JSON的分配、5 万日调用上限的展示方式,都会在下一次接口开放第一期里被再次打开。感谢所有在灰度阶段给出反馈的读者。我们会在第二季增加写入接口的公告里,把这一次的完整数据一并公开。

同板块继续阅读