AppleParty 使用说明

Welcome to the AppleParty wiki!

3.2 使用说明

因为账号记录是存放在 Keychain 里，所以首次打开时，会提示需要访问钥匙串：

如果点击“拒绝”，则不会保存账号和密码信息。

然后，会显示主界面：

默认情况下弹出登陆界面，也可以点击取消登陆（快捷键esc）：

现在默认登陆都需要双重认证：

如果需要使用短信验证码，可以点击“发送短信验证码”，如果希望通过语言验证码，可以勾选“拨打语言来电”切换：

3.2.1 批量上传内购买项目

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 销售，并且将来新国家/地区不提供销售。
• com.bbbap.04：当前下架状态，直到将来有新国家/地区时自动提供销售。
• com.bbbap.05：下架。

关于这个销售范围的描述，在导入表格后，会显示对应的销售范围说明，参考下一章节内容。

2.5 内购商品：批量上传

点击 “导入表格”，可选择excel表进行导入，然后会显示导入的品项明细表：

首先，检查导入的数据，是否正确，包括 销售范围 和 价格机制 等。

然后，在右下角有 上传截图 按钮，点击导入图片。如下图：

截图是根据表格中填写的名字，匹配对应的图片文件，所以需要保证截图文件的名字和后缀一致，否则无法识别和上传。如果截图为空或错误，商品信息会正常更新，但截图不会更新。

左下角的 保留自动续期订阅者现有定价，就是表示自动订阅商品，已经订阅的用户，如果价格调整的话，是否原有用户保持原订阅价格。如下图，是不保留原定价和保留的不同效果：

首次点击 提交 后，如未设置 API 密钥，会显示下面的界面：

首次需要设置，或者点击右下角 设置密钥 重新设置。密钥获取，参考我们之前的文章：App Store Connect API 密钥生成

最后，点击 提交，会显示提交的日志输出：

上传失败时，查看 ❌ 就是说明有异常或错误内容，需要自行判断是否正常：

[04-18 10:12:50] 内购已经存在：com.tc.2 ，开始更新信息中...
[04-18 10:12:51] 开始更新价格计划表：com.tc.2，HKG，10
[04-18 10:12:53] 基准国家的内购价格点：HKG，10.1 ，未找到此档位！❌ 

[04-18 10:13:23] 内购商品：com.tc.6 无送审截图或未上传截图~
[04-18 12:22:17] 内购已经存在：com.tc.7 ，开始更新信息中...
[04-18 12:22:17] 无价格计划表：com.tc.7 ，请确认！❌ 

至此，批量内购创建和上传操作完成！✅

2.6 其它问题

• 订阅商品：不支持配置订阅时限，现在默认值是一个月。
• 家人共享：目前默认是不开启。
• 删除商品：避免运营错误操作风险，所以暂时没有提供删除内购商品的功能。下文有脚本，可以自动获取。
• 临时调价：目前不支持不同时间段的价格调整，后续看看大家是否有需要才继续迭代。

最后，大家使用过程中，有任何疑问或建议，欢迎反馈~

3.2.2 其它扩展功能

邮箱功能，一方面是可以设置快速邮件发送，另一方面是工具效率自动邮箱的通知需求。

二维码功能也是一个工作中的小痛点。