操作指南
如何批量修改 App 内购买项目和订阅价格
App Store Connect 一次只能修改一个产品的价格。本文介绍如何一次性修改十个、五十个甚至两百个 App 内购买项目和订阅,既不用搭上整个周末,也不会让一半的产品还停留在旧价格。
App Store Connect 能批量修改 App 内购买项目价格吗?
不能一步完成。App Store Connect 没有任何界面可以同时修改多个 App 内购买项目或订阅:你需要逐个打开产品,规划其改价并确认。要一次修改多个,你要么对每个产品重复这个过程,要么用脚本调用 App Store Connect API,要么使用替你驱动 API 的工具,只需审核一次。
为什么 App Store Connect 这么慢
有三件事让点击次数成倍增加。第一,每个 App 内购买项目和每个自动续期订阅都有各自的价格计划,要从各自的页面进入。第二,价格是按店面存放的:Apple 会根据一个基础店面为全部 175 个国家和地区生成可比价格(为 App 内购买项目设置价格),但你手动设置过的任何店面,在你再次修改之前都会保持原样。第三,订阅同样按店面安排改价,并且每次改价都要选择如何处理现有订阅者(管理自动续期订阅的价格)。
所以,在三个 App、每个 App 八个产品的情况下“全部上调 10 %”,就是 24 个独立流程,每个流程都要审核多达 175 行。错误就是这样混进来的:漏掉一个产品、覆盖了某个国家或地区的自定价格,或者因为订阅组被折叠而让某个订阅停留在旧价格。
手动方法:逐个产品操作
如果只有少数几个产品,内置界面就够用了。Apple 把 App 内购买项目的价格变更分为三种:全局(新的基础价格,其他地方为可比价格)、临时(在选定国家或地区设定起止日期)和自定(你在部分或全部国家或地区自行管理的价格)。生效日期可以设为从今天起至下一个日历年年底之前的任意日期(为 App 内购买项目安排价格变更)。
- 在“App”中选择该 App,然后在边栏中点击“App 内购买项目”(非续期订阅在“订阅”下)。
- 打开该产品,在“价格计划”旁点击添加按钮 (+)。
- 选择“全局”“临时”或“自定”,选好日期和基础店面的价格,并查看可比价格。
- 确认,然后对下一个产品重复同样的操作。
- 对每个自动续期订阅:打开它,进入“订阅价格”,选择“计划订阅价格变更”,选好国家或地区、日期和价格,决定如何处理现有订阅者,然后确认。
开始之前,先导出客户目前支付的价格:每个订阅的定价页面都有“导出为 CSV”选项,可导出当前和即将生效的价格。请保存好这个文件,它就是你的撤销清单。
API 方法:工作内容是什么样的
App Store Connect API 能完成界面上的所有操作,脚本也可以遍历产品。你需要一个具有 App Manager 或 Admin 角色的团队 API 密钥(角色权限);如何创建见为定价创建 API 密钥。批量任务的基本流程如下:
| 步骤 | 端点 | 说明 |
|---|---|---|
| 列出产品 | GET /v1/apps/{id}/inAppPurchasesV2, GET /v1/apps/{id}/subscriptionGroups, GET /v1/subscriptionGroups/{id}/subscriptions | 每个 App 一次;App 内购买项目、组内的订阅。 |
| 查找价格点 | GET /v2/inAppPurchases/{id}/pricePoints, GET /v1/subscriptions/{id}/pricePoints | 按国家或地区筛选;Apple 表示订阅的筛选条件将成为必填项(订阅价格点)。 |
| Apple 在其他地方的对应价格 | GET /v1/subscriptionPricePoints/{id}/equalizations, GET /v1/inAppPurchasePricePoints/{id}/equalizations | 其他货币中的对应价格点(均衡价格)。 |
| 写入 App 内购买项目的改价 | POST /v1/inAppPurchasePriceSchedules | 需要 baseTerritory、inAppPurchase 和 manualPrices;每个价格都有 startDate 和可选的 endDate(文档)。 |
| 写入订阅的改价 | POST /v1/subscriptionPrices | 每个国家或地区一次,带有 startDate 和 preserveCurrentPrice(文档)。 |
| 取消待生效的订阅改价 | DELETE /v1/subscriptionPrices/{id} | 仅限尚未开始时。 |
这里的算术很重要。订阅是按店面逐个写入的,所以 20 个订阅乘以 175 个店面就是 3,500 次写入,还没算价格点查询。Apple 按 API 密钥在滚动一小时内限制请求数,在 X-Rate-Limit 标头中报告剩余额度,并以 HTTP 429 和 RATE_LIMIT_EXCEEDED 拒绝超出的调用;其示例为每小时 3,500 次请求,并注明实际限制会有所不同(识别速率限制)。无视这一点的循环会在中途停下,留给你的是一部分产品已改、一部分未改。
- 读取每个响应中的标头,在降到零之前放慢速度;把 429 错误排队稍后重试,而不是在紧凑的循环里反复重试。
- 按产品和国家或地区缓存价格点。它们占了你读取量的大头。
- 预期会出现单项错误(某个店面不存在的价格点、日期太近等),并按产品和国家或地区记录下来,以便只重新发送失败的部分。
- 令牌最长有效期为 20 分钟,所以耗时较长的任务需要重新生成令牌。
- 对 App 内购买项目,先读取当前的价格计划,再以此为基础构建新的计划,这样你手动定价的国家或地区是被有意保留的,而不是碰运气。
- 改动最多可能需要一小时才会在沙盒中显示,所以写入后立即进行测试购买,可能仍会显示旧价格。
我们的 API 定价指南会端到端地演示一个产品的流程;与自己维护脚本的对比见 RepriceCat 与 API 脚本。
多产品的电子表格工作流程
无论是手动点击还是用脚本,电子表格都能让批量改价保持严谨。每个产品和店面一行,今天的价格旁边放新价格,这样在发送任何内容之前,你都可以排序、筛选并通览整个改动。
- 导出当前价格:每个产品 × 店面一行,包含产品 ID、类型、国家或地区、货币、当前价格以及任何已安排的改价。
- 添加几列:规则(例如“+10 %”)、原始目标价格,以及取整后的价格,即该货币中 Apple 实际提供的最接近的价格。
- 筛选出取整后价格与当前价格相同、或变动幅度远超预期的行,并手动修正。
- 添加开始日期列,对订阅还要添加现有订阅者列(保留或应用)。
- 把完成的表格交给你的脚本,或逐个产品重新录入,并把带日期的表格保存下来作为记录。
下表展示了“按百分比上调,并取整到最接近的 .99 价格”这一规则,在简单粗暴地取整时对常见美国价格造成的结果。请留意那些几乎没有变化、或可能取整回今天价格的行:
| 当前价格 | 规则 | 原始目标价 | 最接近的 .99 价格 | 实际变动 |
|---|---|---|---|---|
| $2.99 | +20 % | $3.59 | $3.99 | +33 % |
| $4.99 | +10 % | $5.49 | $4.99 或 $5.99(持平) | 无变化,或 +20 % |
| $4.99 | +20 % | $5.99 | $5.99 | +20 % |
| $9.99 | +15 % | $11.49 | $10.99 | +10 % |
| $49.99 | +10 % | $54.99 | $54.99 | +10 % |
| 免费 | +10 % | $0.00 | 跳过 | 无变化 |
发送前的谨慎检查清单
| 检查项 | 原因 |
|---|---|
| 导出今天的价格 | 如果改价出了问题,这是唯一的回退办法。请连同日期一起保存。 |
| 试运行 | 构建所有请求但不发送;统计产品数、店面数和预期的错误数。 |
| 审核每一行 | 产品 × 国家或地区,旧价 → 新价。留意未变动的行、大幅跳涨以及手动设置的国家或地区。 |
| 选择开始日期 | 未来的日期让你有时间取消,也能让各店面的改价对齐。各地区的开始时间不同(开始时间)。 |
| 决定如何处理现有订阅者 | 保留他们的价格,或应用新价格;对现有订阅者应用涨价须遵循 Apple 的通知和同意规则。 |
| 检查已安排的改价 | 新的订阅改价会替换该店面已安排的那一项。 |
| 分批发送 | 按速率限制控制节奏;按产品和国家或地区关注失败项。 |
| 验证并记录 | 读回价格计划,与你的表格对照,并将结果归档。 |
批量操作中容易踩的坑
- 取整。对低价格应用小百分比,可能取整回今天的价格(见上文 $4.99 +10 %),而且取整可能把 +15 % 变成 +10 %,或把 +20 % 变成 +33 %。务必确保涨价后的价格始终高于今天的价格、降价后的价格低于它,并审核取整后的价格,而不是规则。
- 免费产品。零的百分比还是零。按百分比改价时跳过免费产品,或有意为它们设定价格。
- 手动设置的店面。如果你在某个店面设置了自己的价格,Apple 就不再为它按税费和汇率调整。从基础店面发起的全局改价,不一定适用于这些店面;请逐个店面决定。
- 订阅按店面、按次改价。Apple 允许每个店面、每种计费方案类型同时只有一次未来的改价;再安排一次会覆盖第一次(Apple 的订阅定价规则)。
- 生效后无法撤销。已经生效的订阅涨价无法回退,而降价总会应用于现有订阅者;你只能再安排一次改价。
- 订阅组。只涨月付而不涨年付,会改变年付方案的折扣,并可能让升级看起来比降级更不划算。请同时调整一个组内的所有方案,并检查它们的比例。
- Apple 不会按税费或汇率调整订阅价格,但可能会调整它所管理的店面中的 App 内购买项目价格。要清楚你的哪些价格仍可能被 Apple 调整。
订阅涨价在通知和同意方面有自己的规则;在对现有订阅者应用涨价之前,请阅读如何上调 App Store 订阅价格。
用 RepriceCat 来做
RepriceCat 连接你的 App Store Connect 团队密钥,只需一次审核即可完成整个流程。“批量修改价格”让你可以跨 App 选择最多 200 个产品,并提供全部订阅、月付、年付、App 内购买项目或 App 价格的快捷选项,然后按百分比上调或下调,或设定一个新价格。在你查看审核结果并确认之前,不会向 Apple 发送任何内容。
- 百分比改价会取整到 Apple 最接近的 .99 价格,且涨价至少会移到上一个更高的价格(降价则至少移到下一个更低的价格),因此不会取整回今天的价格。免费产品会被跳过,每一个取整过的行都会在审核中标出。
- 区域价格档可开可关:其他国家或地区采用其价格档的价格,或采用 Apple 自己的价格并保留你手动设置的价格。
- 立即生效或指定日期生效;订阅还可选择“现有订阅者保留其价格”(即 Apple 的 preserve-current-price)。
- 产品 × 国家或地区的审核表,显示今天的价格 → 新价格,另有不发送任何内容的试运行。
- 电子表格往返:把当前价格导出到 Excel、Numbers 或 CSV,编辑后再导入;错误会优先列出,导入的行会成为待处理的改动,供你审核。
- “活动”记录每个国家或地区的每次改动,列出失败的国家或地区及 Apple 给出的原因,方便你只重新发送这些,还可以回滚改动。
了解它如何工作,请看批量修改 App Store 价格,或免费试用一个月。
常见问题
可以在 App Store Connect 中一次性修改所有 App 内购买项目的价格吗?
无法在单个界面中完成。App Store Connect 一次只修改一个产品的价格;要一次修改多个,需要用脚本调用 App Store Connect API,或使用基于它构建的工具。
如何批量更新订阅价格?
为每个订阅和店面安排一次价格变更,可以在 App Store Connect 中操作,也可以通过 API 的 POST /v1/subscriptionPrices 完成。请为每次改价决定现有订阅者是否保留当前价格。
批量改价会影响我现有的订阅者吗?
只有当你把它应用到他们身上时才会。涨价时你可以让现有订阅者保留当前价格;降价则总会应用于他们。对现有订阅者应用涨价须遵循 Apple 的通知和同意规则。
为什么我的 10 % 涨价没有改变某些价格?
价格必须落在 Apple 的某个价格点上。对低价格应用小百分比,例如 $4.99 加 10 %,可能取整回当前价格。发送之前请检查每一行取整后的价格。
通过 API 批量改价适用什么速率限制?
Apple 按 API 密钥在滚动一小时内限制请求数,并在 X-Rate-Limit 标头中报告剩余额度。其示例为每小时 3,500 次,但实际限制会有所不同,所以请控制任务节奏,并稍后重试 429 错误。
可以撤销批量改价吗?
尚未开始的改动可以删除。一旦改价生效,你只能再安排一次改回旧价格,这也是为什么要先导出当前价格。