本文主要介绍了 AppleParty v3,一款方便开发者管理 App Store Connect 的工具。文章详细描述了新版本中支持的功能,如内购商品的批量上传、设置销售范围和价格机制等。作者还提到了 API 的一些限制和未来改进的可能性。若您对游戏行业有需求,如管理大量内购项目和多语言应用,AppleParty 可能是一个不错的选择。总之,本文为您提供了一个全面了解 AppleParty v3 的机会,以便更好地管理您在 App Store Connect 上的应用。
一、前言
大家好!我们又见面啦,我们在上篇文章《使用 App Store Connect API v2.3 管理 App Store 新定价机制》讲解了关于 App Store 新定价机制 API 的介绍。但当时没有对 API 之间的关系性和联动进行介绍,有接口也不知道怎么串联起来使用。所以本文将详细介绍 App Store Connect API v2.3 如何实现批量配置自定价格和销售范围等。
首先,纠正一下我们之前文章《App Store 新定价机制 - 2023年最全版》提到 订阅类型价格调整 的影响,当时认为苹果全球均衡价格系统,会影响到自动续期订阅产品!但是仔细看 App Store Connect API 后发现,Apple 不会对你的自动续期订阅产品进行价格调整。
Apple 不会对你的自动续期订阅产品进行价格调整。Apple 可能会针对税务变化和重大汇率变动调整零售价格,但价格调整不涉及自动续期订阅。请注意,由于你的收益和 Apple 的佣金均在扣除增值税(VAT)之后计算,因此 VAT 税率变化会影响你的收益。你可以选择调整你的订阅价格,以减少税务或外汇变化对你的收益造成影响。
自动续期订阅产品,跟现有 App 和一次性 App 内购买项目的价格一样,不再使用价格等级,并且支持的价格点是一致的。但是自动续期订阅产品的价格,不能设置自动根据全球均衡价格系统调价! 这个就是区别,下文会详细介绍到~
二、支持 App Store 新定价机制
在讲解 AppleParty(苹果派)支持 App Store 新定价机制之前,如果大家对 AppleParty(苹果派)不太了解,可以通过我们自己的文章学习,这里就不展开了。
- AppleParty 下载
- 苹果派安装使用教程:开源一款苹果 macOS 工具 - AppleParty(苹果派)
- 苹果派批量创建内购教程:使用 App Store Connect API 批量创建内购商品
2.1 基本功能和表格模板
使用批量内购商品配置,首先要更新到 v3.0.0 版本,登陆账号后选择 “我的 App”,然后点击 “上传内购项目”,打开内购管理内容:
- 刷新:刷新当前 App 的内购商品列表(刚刚上传的商品不会自动刷新,所以可以手动刷新)
- 导入表格:通过固定表格的形式,批量创建内购品项
- 导出表格:导出所有品项的信息 Excel 表
- 导出品项 ID:导出品项 productID 和内购品项 id 的映射表
- 下载表格示例:批量创建内购品项的示例 Excel 表格
首次,需要点击 下载表格示例
,下载模板表格,用于配置内购信息的信息。
2.2 内购商品:基本信息配置
打开示例表格,可以看到如下图所示例:
注意:
AppleParty
、PricePoints
、Territories
这 3 个工作表的名字不能更改,App 是根据这些名字来读取对应的内容。
- Product ID:内购商品的标识,注意不能重复。
- 参考名字:内购商品 ASC 后台显示的名字,不会对用户显示。但需要注意,每个内购商品的参考名字不能相同!
- 应用内购买类型:内购类型,具体不同类型介绍,参见
帮助
工作表。 - 审核截图(可选):内购审核的截图,填写的是需要上传的图片的名字,包含后缀,例如
test01.jpg
或t01.png
。 - 审核备注(可选):内购审核的备注。
- zh-Hans | en-US:对应 ASC 后台的
App Store 本地化版本
,可以配置多个语言版本,只需要在表格后面,表头添加对应的语言标识。
下面是示例说明:
Product ID | 参考名字 | 应用内购买类型 | 审核截图(可选) | 审核备注(可选) | zh-Hans | zh-Hans | en-US | en-US |
---|---|---|---|---|---|---|---|---|
com.iap.01 | 测试suc1 | 消耗型 | test01.jpg | 中文名字01 | 中文描述01 | 英文名字01 | 英文描述01 |
示例表格中使用 zh-Hans
和 en-US
,在编辑内购商品的信息时,如果不需要这2种语言,可以删除或更改其它语言。需要注意,表格前面的几列,位置顺序不能更改,也不能删除列数等。上传到苹果 ASC 后台的效果:
App Store 本地化版本语言代码,可以查看表格的 帮助
工作表。例如日本是 ja
,在 AppleParty
工作表后面添加2列 ja
的表头,然后就可以配置对应的多语言。
审核截图的上传,下文会提到,这里暂时略过。
2.3 内购商品:基准国家和自定价格配置
切换到 PricePoints
工作表,可以看到如下图所示例:
- Product ID:用于映射多个工作表的内容,所以可以在
AppleParty
工作表的内购商品信息填写好后,直接复制过来。 - 基准国家(代码):当前内购商品的基准国家,注意是填写代码。175 个国家和地区的代码,可参考
苹果各国家地区代码
工作表。 - 基准国价格:当前内购商品的基准国家对应的价格点,表格中提供了
部分国家和地区价格点
工作表,全部的国家和地区的价格点,请从苹果 ASC 后台下载。 - 自定价格国家 | 自定价格:需要自定(固定)价格的国家或地区,如果不填写,则表示以基准国家的价格点,根据苹果的全球均衡价格自动设置价格。
下面是示例说明:
Product ID | 基准国家(代码) | 基准国价格 | 自定价格国家1 | 自定价格1 | 自定价格国家2 | 自定价格2 | 自定价格国家3 | 自定价格3 | 自定价格国家4 | 自定价格4 |
---|---|---|---|---|---|---|---|---|---|---|
com.iap.01 | JPN | 100 | ||||||||
com.iap.02 | HKG | 10 | MAC | 1.9 | TWN | 65 | ||||
com.iap.03 | USA | 2.79 | KOR | 990 | CHN | 7 | LBR | 2.19 | COL | 6500 |
com.iap.01
:设置基准国家为JPN
(日本),定价为100
日元,而没有填写自定价格国家或地区,所以其余 174 个国家或地区,根据基准国家的 100 日元,苹果全球均衡价格系统自动调整对应的地区价格。com.iap.02
:设置基准国家为HKG
(中国香港),定价为10
港元,分别设置了中国澳门和中国台湾 2 个自定价格,其余 172 个国家或地区,根据基准国家的 10 港元,苹果全球均衡价格系统自动调整对应的地区价格。com.iap.03
:设置基准国家为USA
(美国),定价为2.79
美元,分别设置了4个国家或地区的自定价格,其余 170 个国家或地区,根据基准国家的 2.79 美元,苹果全球均衡价格系统自动调整对应的地区价格。
总结:
- 如果没有自定价格的国家或地区,则只配置基准国家和基准国价格就可以。
- 如果有自定价格的国家或地区,则在表格右边填写对应的自定价格的国家或地区,不同内购商品可以填写不同的国家和地区,并且填写个数也可以不同。
- 175 个国家和地区的代码,可参考
苹果各国家地区代码
工作表。
2.4 内购商品:销售范围配置
切换到 Territories
工作表,可以看到如下图所示例:
- Product ID:用于映射多个工作表的内容,所以可以在
AppleParty
工作表的内购商品信息填写好后,直接复制过来。 - 在所有国家/地区销售(1是,0否):注意,如果此值为
1
,则其它项的配置直接忽视,并且为 1 时,包含将来新国家/地区自动提供。如果值为0
,则默认下架状态,然后根据其它项的配置来决定销售范围,见下一项的配置。 - 将来新国家/地区自动提供(1是,0否):如果字段
在所有国家/地区销售
值为1
,则此字段值固定为1
。否则,此值为1
表示将来 App Store 添加新国家/地区时自动提供销售,值为0
表示将来新国家/地区不会自动提供销售。 - 自定销售国家:如果字段
在所有国家/地区销售
值为1
,则此字段设置无效。否则,填写一个或多个国家或地区时,则表示不会在所有国家/地区销售,只会在填写的国家和地区中上架销售。
下面是示例说明:
Product ID | 在所有国家/地区销售(1是,0否) | 将来新国家/地区自动提供(1是,0否) | 销售1 | 销售2 | 销售3 | 销售4 | 销售5 |
---|---|---|---|---|---|---|---|
com.iap.01 | 0 | 1 | TWN | HKG | MAC | ||
com.iap.02 | 1 | 0 | |||||
com.iap.03 | 0 | 0 | USA | JPN | CHN | LBR | COL |
com.iap.04 | 0 | 1 | |||||
com.iap.05 | 0 | 0 |
com.bbbap.01
:当前只在TWN
(中国台湾)、HKG
(中国香港)、MAC
(中国澳门) 销售,并且将来新国家/地区自动提供销售。com.bbbap.02
:在所有国家/地区销售,并且将来新国家/地区自动提供销售。com.bbbap.03
:当前只在USA
(美国)、JPN
(日本)、CHN
(中国)、LBR
和COL
销售,并且将来新国家/地区不提供销售。