App Review notes 写得不够清楚:6 个常见问题 + 重写模板

Notes 明明写了、审核员还是反复问同一件事——因为他们扫读不到 60 秒。本文讲为什么 notes 要按表单不要按散文写,并给一套凭证置顶、操作分步的重写模板。

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

他们读了。问题是 App Review Information 字段在 Apple 内部审核工具里就是一坨纯文本,审核员扫读时间不到 60 秒。如果你的 notes 把营销话术和审核说明混在一起、把凭证埋到第三段、用散文描述操作流程,答案技术上存在但审核员当场抽不出来。Notes 要按表单写,不要按信写。

常见原因

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

1. Notes 开头是营销文案而不是凭证

你以 “Welcome to Acme! Our app helps you do X with AI” 开头——和描述里一模一样的段落。审核员还没读到第四段的 demo 账号就走神了。

如何判断:打开 App Store Connect → App Information → App Review Information。如果前 200 个字符里没有用户名、密码或字面上的 “DEMO ACCOUNT:“,就是这条。

2. 凭证在但格式坏

你写 “Username: test@acme.com / Password: see below” 而密码在另一段;或者智能引号粘贴时乱码;或者写 “any password works”(开发环境是真,staging 就不是)。审核员第一次登录就失败。

如何判断:把凭证块从 notes 复制到纯文本编辑器。出现弯引号、长破折号、不间断空格,或者密码不和用户名在同一行,就修格式。

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

你写 “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 大声念一遍。任何一句描述超过一次点击的,都应改成编号列表。

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

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

如何判断:搜 notes 里有没有出现 “region”、“iPhone”、“iPad”、“admin”、“Pro”。如果功能需要其中之一但 notes 没写,就是这个 gap。

5. 提交之间没更新 notes

v2.3 的 notes 还在描述 v1.0 的用户旅程。审核员按你写的走,落点和你写的不一样,要么放弃要么问你”哪里变了”。

如何判断:把当前 notes 和上一版的仓库提交(如果你存了)或 App Store Connect 的上次快照 diff 一下。如果一模一样但 build 实质性变了,你漏了更新。

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

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

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

动手前先确认

  • 完整记下最近一次拒回的原文,拒回基本都会引用”缺的那条信息”的具体措辞。
  • 把当前 notes 打印或粘到一个文档里,用红色标出哪些要删哪些要加。
  • 在重写前备份当前 notes 文本,方便对比效果。
  • 决定要不要重打 build。仅改 notes 重交更快;要改代码就准备多等 24 小时。

需要收集的信息

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

最短修复路径

Step 1:用规范化的 review notes 模板替换全部内容

把 App Review Information 字段整段替换成下面这套结构。粘进去后逐块填,可选项可删。

DEMO ACCOUNT
URL or app path: (in-app, tap "Sign In" on launch)
Email: apple-review-2026@yourdomain.com
Password: ReviewPass-Spring2026!
No 2FA. Pre-seeded with sample data.

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" — wait 5 seconds for AI processing.
5. Expected: enhanced image preview with before/after slider.

HOW TO TEST PAYWALL
1. After signing out, sign up with any new email.
2. Try to access "AI Photo Editor" — 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 2:审核每一屏

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

Step 3:清营销词

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

Step 4:把 notes 进版本控制

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

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

REVIEW.md 粘进 App Store Connect;审核员看到的就是你审过的同一份。

Step 5:让非开发同事冷测

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

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

App Store Connect → App Store 标签 → 点 build → Submit for Review。仅 notes 更新不用重新打包。

怎么确认已经修好

  • Notes 通过”60 秒扫读”测试:陌生人扫前半屏就能找到 demo 凭证和功能走查。
  • 下次提交要么通过、要么换了个不同的拒回——两次拒回理由一样就说明这次重写没打到点。
  • Resolution Center 里审核员回复确认收到新信息,而不是重复问之前的问题。
  • 你的非开发测试者第一次就走通了被点名路径。

如果还是没修好

  1. 在 Resolution Center 回复时引用 notes 里回答审核员问题的具体几行。
  2. 上传一段 30 秒 QuickTime 屏录演示被点名的功能路径,通过 Resolution Center 附件上传。
  3. 在 App Store Connect → Resolution Center → Request a Call 申请电话,现场带审核员走一遍。
  4. 同一个 gap 被拒第二次时,通过 Contact App Review 表单升级,要求换审核员。

预防建议

  • 仓库里维护 REVIEW.md 作为唯一真源;每次提交都从它复制。
  • 发布清单加一条:“diff REVIEW.md 和上次提交;让非开发同事走一遍 notes”
  • 每次提交的 notes 存成带 tag 的文件(REVIEW-v2.3.md),方便回滚或审计。
  • Notes 控制在 1500 字符内;写不下就说明你的 App 复杂到 30 分钟测不完,先重构。
  • 别在 App Review notes 里加截图;Apple 审核工具不一定能稳定显示。用清晰文字 + 字段名更可靠。

相关阅读

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