更新说明(What's New)怎么写:用户可读与审核友好
别只写 bug fixes。面向用户的更新说明结构,以及修拒审后版本说明要注意的表述。Telegram @hagee66。
官网传送门(可直接点击跳转)
打开本文 · 指南库 · 苹果上架 · 谷歌上架 · 双端上架
Telegram 询价 @hagee66 · 官网 goee.cc
用户点「更新」前看到的 What's New(更新说明) ,在不少团队手里只剩一个词:bug fixes and performance improvements。对用户,这等于没说;对审核员,在拒审修复版里等于浪费了一次 用语言交代你改了什么 的机会——不是说你要把拒信全文贴上去,而是要用用户能读懂的话,证明这版在体验、合规或稳定性上与上一版不同。
上架通(goee.cc)给产品、运营与上架执行一套可复制的更新说明结构,并说明与 宣传文本、商店 描述、再提审 备注如何分工。字段长度与是否本地化 以官方当前页面为准。写法再规范,也不承诺审核通过。
这篇要解决的问题
更新说明写的烂,会直接体现在:
- 老用户不知道新版值不值得升,留存迭代推不动。
- 重大功能上了,商店描述没改,只有 loyal 用户从 What's New 才知道——新用户仍以为没有该功能。
- 拒审修复版写「优化体验」,审核员对照包体找不到对应变化。
- 多语言有的写三条有的写一段,像拼凑。
- 把内部 codename「Project Nebula」写进用户可见文案。
- 与 分阶段发布 灰度版本不同步,生产用户看到的说明与手里版本不符。
谁应该读
- 产品经理:每个版本至少有一条用户可感知变化写进说明。
- 运营/客服:更新说明是可复制到公告、社群的源文案(经删减)。
- 研发负责人:拒审修复条目需要对应 commit/测试记录,方便再提备注引用。
- 上架执行:录入多语言、与构建绑定、与灰度节奏对齐。
核心做法
三层读者,一套源稿
同一次发版,读者有三类,源稿一份再裁剪:
| 读者 | 关心什么 | 放在哪 |
|---|---|---|
| 终端用户 | 新功能、修了什么难受 | What's New |
| 商店新访客 | 产品是什么 | 描述前三行 |
| 审核员 | 你如何响应拒信 | 审核备注 + 谨慎体现在 What's New |
What's New 不要粘贴拒信编号大段;用户看不懂。但若修复了 用户可见 的登录、支付、隐私入口,应用一句 plain language,与 拒审整改 内部销项表一致。
推荐结构(短版本)
每条更新说明建议 3~7 条 bullet,动词开头:
• 新增:在【入口】可【结果】。
• 改进:【场景】加载更快 / 步骤更少。
• 修复:部分用户无法【问题】的问题。
• 提示:(若有)订阅价格展示方式与条款说明更清晰。
避免:
- 只有一句笼统 bug fixes(除非真是纯内部无感知补丁且团队接受)。
- 五条里有三条是「优化界面」无量化场景。
- emoji 堆叠掩盖没内容。
与商店描述、宣传文本联动
大功能版本:描述前三行与 What's New 第一条应讲同一件事,见 元数据清单。小补丁:可只动 What's New,但若功能已在截图里主打,描述也别落后。
宣传文本 写活动;What's New 不写「双十一仅限今日」 unless 也面向已装用户有意义。
拒审修复版的写法
拒审后再发行,内部先列 审核相关修复 与 普通修复,再写对外 bullet:
- 用户可见:写「现可在设置中删除账号」而非「符合 5.1.1」。
- 仅合规无 UI:可写「隐私政策与数据收集说明已更新,可在设置内查看」。
- 仅后端:若无用户感知,不必编造 UI 变化;审核细节放备注。
拒信类型对照 常见拒审。不要写「已完美符合所有政策」。
多语言
主语言定稿 → 结构复制到其它语言,勿机翻口水话。敏感地区法律要求在更新说明里披露变更时,用法务审定句,见 出海基础。
与版本号、灰度
iOS 版本号规范 要求构建与说明绑定。分阶段发布时,确保 Production 用户看到的 What's New 与已收到的那一段构建一致,见 分阶段发布。
撰写工作坊:30 分钟定稿法
发版前若团队总在深夜才「顺手写两句 What's New」,可以固定一个三十分钟工作坊:5 分钟由 PM 念关闭的需求单;10 分钟每人写三条动词 bullet 草稿;10 分钟合并去重并砍掉内部黑话;5 分钟由客服同学朗读——若听不懂就重写。朗读测试比「觉得还行」更能筛掉空洞句式。
对外发布前,把终稿贴进内部 wiki,并附 构建号 与 对应 Jira/需求 ID。三个月后查问题时,评论里说的「上一版能行」才有锚点。与 宣传文本 同时发版时,先定 What's New 再摘一句更短的促销语进宣传文本,顺序反了容易出现两处说法打架。
若产品面向企业客户,更新说明可适当多一句 管理员操作变化(如 SSO、导出审计日志),但仍避免通篇 IT 缩写。家庭与儿童向产品避免在更新说明里做恐怖营销,与 年龄分级 问卷一致即可。
可复制模板
发版 What's New 起草
版本: x.y.z (build ___)
用户可见新功能:
体验改进:
缺陷修复(用户可感知):
合规/隐私(若有用户入口):
刻意不写(仅内部):
对应截图/描述是否已改: 是/否
再提审备注引用编号:
客服同步摘录
本版用户关心的 3 点:
1.
2.
3.
不对外承诺:
常见误区
| 误区 | 后果 | 改法 |
|---|---|---|
| 永远 bug fixes | 用户无感 | 至少一条具体 |
| 泄露未完成功能 | 信任损失 | 只写已上线 |
| 拒审版写太技术 | 用户慌 | 用户句 + 备注技术 |
| 与截图矛盾 | 差评 | 三角检查 |
| 灰度说明不同步 | 混乱 | 轨道表 |
| 英文套话堆叠 | 像垃圾邮件 | 短动词句 |
长版本、付费墙与用户信任的写法
订阅产品更新时,若本版只改了 试用规则展示 或 价格本地化,What's New 里应有一句让用户一眼看见变化类型,而不是藏在「体验优化」里。这与 内购注意事项 和 恢复购买 的展示义务一致——商店更新说明不是法律条文,但要帮用户建立正确预期。
游戏与内容型 App 若更新关卡或剧集,优先写 可玩内容增量(「新增第 12–15 关」),少写空洞「精彩内容等你来」。工具类写「导出 PDF 现支持 A4 边距设置」比「优化导出体验」可信十倍。
对于频繁 hotfix 的团队,可约定:对外至少合并为双周一条可阅读说明,内部 git log 仍可细颗粒。否则用户端看到的是 spam 式「修复已知问题 ×14」,会削弱大版本真正重要特性的注意力。
与审核备注的分工(再强调)
审核备注可以写技术路径、测试账号、政策条款对照;What's New 永远优先可读性。若修复了审核员指出的 隐藏页面或缺失入口,备注写路径,What's New 写「现可在设置 > 隐私 中导出数据」这类句子即可,不要在用户端复诵 Guideline 编号。
若 申诉 进行中,仍按真实用户视角写更新说明;不要在 What's New 里写「请审核员通过」——那不属于用户产品沟通。
问与答
纯后端优化怎么写?
若用户完全无感,一条诚实的「稳定性改进」即可,不必虚构界面;审核细节在备注。
小版本每周发,都怎么写?
合并同类修复;周更也要有一条可感知点,否则考虑拉长发布节奏。
Google Play 的「最近更新」?
Play 用「发行说明」等字段,以官方当前页面为准;原则同本文。
能否写「感谢审查通过」?
用户向文案不需要;审核备注单独写。
代上架代填?
可据构建日志整理草稿,内容真实性由客户确认。Telegram @hagee66。
下一步
返回 指南库 · 不承诺过审 · 以官方当前页面为准。