跳到内容

操作指南

如何批量修改 App 内购买项目和订阅价格

App Store Connect 一次只能修改一个产品的价格。本文介绍如何一次性修改十个、五十个甚至两百个 App 内购买项目和订阅,既不用搭上整个周末,也不会让一半的产品还停留在旧价格。

更新于 阅读约需 9 分钟

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 内购买项目安排价格变更)。

  1. 在“App”中选择该 App,然后在边栏中点击“App 内购买项目”(非续期订阅在“订阅”下)。
  2. 打开该产品,在“价格计划”旁点击添加按钮 (+)。
  3. 选择“全局”“临时”或“自定”,选好日期和基础店面的价格,并查看可比价格。
  4. 确认,然后对下一个产品重复同样的操作。
  5. 对每个自动续期订阅:打开它,进入“订阅价格”,选择“计划订阅价格变更”,选好国家或地区、日期和价格,决定如何处理现有订阅者,然后确认。

开始之前,先导出客户目前支付的价格:每个订阅的定价页面都有“导出为 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 脚本。

多产品的电子表格工作流程

无论是手动点击还是用脚本,电子表格都能让批量改价保持严谨。每个产品和店面一行,今天的价格旁边放新价格,这样在发送任何内容之前,你都可以排序、筛选并通览整个改动。

  1. 导出当前价格:每个产品 × 店面一行,包含产品 ID、类型、国家或地区、货币、当前价格以及任何已安排的改价。
  2. 添加几列:规则(例如“+10 %”)、原始目标价格,以及取整后的价格,即该货币中 Apple 实际提供的最接近的价格。
  3. 筛选出取整后价格与当前价格相同、或变动幅度远超预期的行,并手动修正。
  4. 添加开始日期列,对订阅还要添加现有订阅者列(保留或应用)。
  5. 把完成的表格交给你的脚本,或逐个产品重新录入,并把带日期的表格保存下来作为记录。

下表展示了“按百分比上调,并取整到最接近的 .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 错误。

可以撤销批量改价吗?

尚未开始的改动可以删除。一旦改价生效,你只能再安排一次改回旧价格,这也是为什么要先导出当前价格。

试一试

从一个基准价格为每个国家/地区重新定价

价格档、自动对齐价格点、一张检查表、一次确认,全部通过 App Store Connect API 完成。首月免费,之后每个 App 每月 $1。