App Review notes 写得不清楚:重写一遍,让审核员不再反复问

Notes 明明写了,Apple 还是引 Guideline 2.1 或说 demo 账号登不上。把凭证填进 Sign-In Required 字段、把步骤写成编号表单,仅改 notes 重交即可。

最近三次提交你都写了 App Review notes。每次拒回还是引 Guideline 2.1——“please provide additional information about feature X”“the demo account credentials did not work”——你发誓答案都在 notes 里。不同审核员问的是同一个问题的变体,你开始怀疑他们到底读没读。

他们读了。最常见的两个症结:一是你把 demo 登录信息打进了自由文本的 Notes 框,而没填进专门的 Sign-In Required 用户名和密码字段,于是审核员的首轮/自动登录根本看不到;二是 Notes 字段在 Apple 内部审核工具里就是一坨纯文本(截至 2026 年 6 月上限 4000 字节),审核员扫读时间远不到一分钟。如果你把营销话术和审核说明混在一起、把凭证埋到第三段、用散文描述操作流程,答案技术上存在但审核员当场抽不出来。

最快修复: 把可用的 demo 用户名和密码填进 Sign-In Required 字段(App Store Connect 版本页里)。然后把 Notes 字段重写成可扫读的表单——凭证置顶重述一遍,接”本版改了什么”,再接带具体标签/按钮名的编号测试步骤。仅改 notes 重交,不用打新 build。

字段到底在哪(2026 年 6 月)

App Store Connect 把审核信息分成三个独立的框,把对的内容放进对的框,问题就解决一半。

字段(确切标签)该放什么常见错误
Contact Information能快速回应的人的姓名、邮箱、电话留着组织默认值,没人盯
Sign-In Requireddemo 账号 UsernamePassword(需要登录就打开开关)凭证打进了 Notes,或开关没开
Notes最多 4000 字节纯文本:本版改动、分步测试路径、地区设备限制、配置营销文案、散文式流程、过时说明
Attachment可选文件:屏录(.mp4)、授权文档(.pdf)误以为附件”显示不出来”——其实能显示

Sign-In Required 里的 demo 账号不能过期;即使你用单点登录(Sign in with Apple、Google 等),也仍要提供一个可用的 demo 登录。额外账号写进 Notes

常见原因

按命中率排序,前三条占了大多数重复拒回。

1. 凭证在 Notes 一坨里,没填进 Sign-In Required 字段

你把 “Username: … / Password: …” 粘进了自由文本 Notes 框,却没打开 Sign-In Required 开关。审核员期望在那个结构化字段里看到登录;字段空着时,他们可能还没读散文就按 Guideline 2.1 退回。

如何判断:打开 App Store Connect → 你的 App → 该版本 → App Review Information。如果 Sign-In Required 没开(或 Username/Password 留空)而你的 App 有登录界面,就是这条。

2. demo 账号是空的或已过期

审核员没法评测一个没帖子的社交流、没笔记的笔记 App,或者试用已过期的账号。截至 2026 年 6 月 Apple 的官方说法很明确:App 需要内容才能运转的,就把 demo 账号预填示例数据,且账号不能过期。

如何判断:现在就在一台干净设备上登一遍 demo 账号。首页空白、会话过期、付费墙没有测试路径?先补好种子数据再重交。

3. 凭证在但格式坏

你写 “Password: see below” 而真密码在别处;或智能引号粘贴乱码;或写 “any password works”(开发环境是真,staging 就不是)。审核员第一次登录就失败。

如何判断:把凭证复制到纯文本编辑器。出现弯引号、长破折号、不间断空格,或用户名和密码不在同一行?修格式,重新手打,别从带样式的文档里粘。

4. 功能路径写成散文不是编号步骤

你写 “To test the photo editor, go to the home tab and find the new button we added on the top right which opens a modal where you can pick an image and then…”——三个逗号过去审核员已经迷路了。他点错地方,被拒。

如何判断:把 notes 大声念一遍。任何一句描述超过一次点击的,都应改成编号列表。

5. 地区 / 设备 / 角色限制说得含糊或没说

功能要求美区 + iPhone 15 Pro + admin 角色。你写 “please ensure you have a compatible device”。审核员用默认测试机进去看到空屏,拒。

如何判断:搜 notes 里有没有出现 regioniPhoneiPadadminPro。功能需要其中之一但 notes 没写,就是这个 gap。

6. 提交之间没更新 notes

v2.3 的 notes 还在描述 v1.0 的用户旅程。审核员按你写的走,落点和你写的不一样,要么放弃要么问”哪里变了”。Apple 会拒掉对新功能的”笼统描述”——每个改动的功能都必须写具体。

如何判断:把当前 notes 文本和上一版(如果你存在仓库里)或上次提交 diff 一下。文本一模一样但 build 实质性变了,就是漏了更新。

7. Notes 里有道歉、恳求、或无关上下文

“We know it’s been a tough cycle and would really appreciate it if…” 能软化审核员但不传递任何信息。“Our cofounder built this in a weekend” 无关。煽情文案把事实往下推。

如何判断:高亮所有不回答”审核员会问的问题”的句子。占比超过 20% 就砍掉。

需要收集的信息

  • 最近一次审核员拒回的完整原文(记下它引的是哪条 guideline)。
  • 上一版的 notes 文本,方便对比。
  • 被点名功能的冷装用户旅程逐屏复现。
  • 影响该功能可见性的所有 gating 条件(地区、设备、角色)。
  • 一个可用、已预填数据、不会过期的 demo 账号及完整凭证。

最短修复路径

Step 1:先填结构化字段

动 Notes 框之前:在 App Review Information 里打开 Sign-In Required,把 demo 的 UsernamePassword 填进那两个字段。Contact Information 填一个能在一个工作日内真的回邮件或接电话的人。光这一步就能清掉一批 “demo account did not work” 的拒回。

Step 2:用规范化的 review notes 模板

Notes 字段整段替换成下面这套结构。粘进去后逐块填,可选项删掉。这里也把凭证重述一遍——冗余不花钱,从头读到尾的审核员就永远不用去翻找。

DEMO ACCOUNT (also entered in Sign-In Required)
Where to sign in: in-app, tap "Sign In" on launch
Email: apple-review-2026@yourdomain.com
Password: ReviewPass-Spring2026!
No 2FA. Pre-seeded with sample data. Account does not expire.

WHAT CHANGED IN THIS VERSION
- New "AI Photo Editor" tab (bottom navigation, second from left).
- Subscription paywall moved from launch to feature gate.
- Removed location permission prompt.

HOW TO TEST AI PHOTO EDITOR
1. Sign in with the demo account above.
2. Tap "Editor" in bottom navigation.
3. Tap "+" to import a sample image (pre-loaded in Photos).
4. Tap "Enhance" and wait about 5 seconds for processing.
5. Expected: enhanced image preview with a before/after slider.

HOW TO TEST PAYWALL
1. After signing out, sign up with any new email.
2. Try to open "AI Photo Editor" — the paywall appears.
3. Use sandbox account apple-iap-sandbox@yourdomain.com to test purchase.
4. Subscriptions auto-renew; cancel via Settings to retest.

REGION & DEVICE
- App is region-locked to US/CA/UK. Demo account is pre-set to US.
- AI Photo Editor requires iPhone 12 or newer (Neural Engine).
- iPad version uses the same flow; landscape only.

CONTACT
Email: dev@yourdomain.com (PT timezone, 9am-6pm)

Step 3:审核每一屏

在干净模拟器上跑你 notes 里描述的完整路径。每一个”点击”、“滚动”、“等待”都必须对应一个可见动作。写了 “tap Settings” 但 Settings 藏在菜单里,要么修 notes 要么修 UI。

Step 4:清营销词

搜 notes 里这些词,把整句删掉:welcome, excited, please, kindly, appreciate, hope, exciting, innovative, revolutionary。审核员不需要被欢迎,他需要找到按钮。

Step 5:把 notes 进版本控制

仓库里建或更新 REVIEW.md。下次发版从这个文件抄。每次提交都把它和上一版 diff,揪出过时说明。

# 仓库里
cp REVIEW.md REVIEW.previous.md
# 编辑 REVIEW.md 为新版
diff REVIEW.previous.md REVIEW.md

REVIEW.md 粘进 Notes 字段;审核员看到的就是你审过的同一份。

Step 6:让非开发同事冷测

找一个没参与开发的同事,只给他重写后的 notes 和一台刚装好的设备。如果他 5 分钟内能走到被点名的功能,审核员大概率也能。走不到就继续改,改到他能为止。

Step 7:重交(仅改 notes,不动 build)

App Review 信息随时可改,对用户不可见。在 App Store Connect 打开该版本,更新字段,然后用 Add for Review / Submit for Review。只改 notes 和凭证不用重新打包。

怎么确认已经修好

  • Sign-In Required 已打开,你能在干净设备上用那组凭证登进一个有示例数据的账号。
  • Notes 通过”扫读”测试:陌生人扫前半屏就能找到 demo 凭证和功能走查。
  • 下次提交要么通过、要么换了个不同的拒回——两次拒回理由一样就说明这次重写没打到点。
  • Resolution Center 里审核员回复确认收到新信息,而不是重复问之前的问题。

如果还是没修好

  1. Resolution Center 回复时引用 notes 里回答审核员问题的具体几行。
  2. Attachment 字段上传一段 30 秒屏录(.mp4)演示被点名路径——Apple 审核工具能显示,支持类型包括 .mp4.png.jpg.pdf.zip
  3. 在 Resolution Center 的回复里写明你更想电话沟通;Apple 会安排通话,而不是公布号码。现场带审核员走一遍。
  4. 同一个 gap 因看起来像误解被拒第二次时,升级到 App Review Board(申诉渠道),而不是只反复重交。

预防建议

  • App 一旦有登录,就把 Sign-In Required 当成必填;绝不只靠埋在 Notes 里的凭证。
  • demo 账号常年保持有示例数据,并设为永不过期。
  • 仓库里维护 REVIEW.md 作为唯一真源;每次提交都从它复制。
  • 发布清单加一条:“diff REVIEW.md 和上次;让非开发同事走一遍 notes;确认今天 demo 能登上”
  • 每次提交的 notes 存成带 tag 的文件(REVIEW-v2.3.md),方便回滚或审计。
  • Notes 字段上限 4000 字节;如果连同一段附带视频都讲不清测试路径,说明流程八成乱到一遍审不完,先简化它。

相关阅读

外部参考:Apple App Review GuidelinesReply to App Review messages

标签: #排查 #App Store #App 审核 #App 审核