将应用内购买密钥添加至 Adapty
Adapty 使用应用内购买密钥来验证应用内的购买,并为促销活动签名。在 App Store Connect 中生成密钥,然后在 Adapty 的 App settings 的两个部分中输入该密钥。如果密钥失效或需要更换,请替换密钥。
App 内购买密钥与 App Store Connect API 密钥不同,尽管 App Store Connect 对这两种密钥的 ID 均标注为 Issuer ID 和 Key ID。
如需在 App settings > iOS SDK 中一次性填写所有凭据,请参阅配置 App Store 集成。
在 App Store Connect 中生成密钥
-
在 App Store Connect 中,前往 Users and Access > Integrations > In-App Purchase。
同一个密钥可供你的 App Store Connect 团队下所有应用使用。如需复用此页面中已有的活跃密钥,你需要有对应的文件。如果你已有该文件,可跳过第 2-4 步。生成新密钥后,原有的活跃密钥仍然有效。
-
生成密钥需要在 App Store Connect 中拥有 Account Holder 或 Admin 角色。如果你没有这两个角色,请联系拥有相应角色的人员来生成密钥,并让其将文件连同 Issuer ID 和 Key ID 一并发给你。
如果页面上已列出活跃密钥,点击 +;否则,点击 Generate In-App Purchase Key。
-
输入密钥名称,然后点击 Generate。密钥将出现在 Active 列表中。
-
每个密钥只能下载一次。在新密钥旁边,点击 Download In-App Purchase Key。
然后在弹出的对话框中点击 Download。请妥善保管该文件:你需要将它上传到每个使用此密钥的 Adapty 应用中。
Apple 在 创建 API 密钥以授权 API 请求 中描述了这些步骤。
将密钥添加到 Adapty
-
要查找密钥的 Issuer ID 和 Key ID,请在 App Store Connect 中前往 Users and Access > Integrations > In-App Purchase。如果是其他人生成了密钥并将 Issuer ID、Key ID 和文件发送给您,请跳过此步骤。
-
在 Adapty 中,前往 App settings > iOS SDK。在 In-app purchase API (StoreKit 2) 部分,填写以下字段:
- Issuer ID:从 App Store Connect 的 In-App Purchase 页面复制。
- Key ID:从 In-App Purchase 页面的 Active 列表中复制,位于您下载的密钥旁边。
- Private key (.p8 file):上传您下载的文件。
-
Adapty 使用 In-App Purchase 密钥为促销活动签名。在 App Store promotional offers 部分,再次输入密钥:
- Subscription key ID:步骤 2 中的 Key ID。
- Subscription key (.p8 file):步骤 2 中的文件。
若使用了不同的密钥,保存时不会报错,但用户将无法收到促销活动。
-
点击 Save。Adapty 在保存页面之前,会通过 Apple 验证 In-app purchase API (StoreKit 2) 部分中的密钥。如果 Apple 拒绝该密钥,页面将显示”The provided field values are incorrect”:请检查相关值。
替换密钥
如果密钥失效或需要更换,请在吊销旧密钥之前先将新密钥保存到 Adapty。
密钥失效时会出现以下情况:
- 应用内购买无法解锁任何访问等级,且应用不会收到任何报错。
- 用户无法兑换促销活动。
- Refund Saver 无法响应消耗请求。
- Adapty 不会显示任何警告,App Store server notifications 部分中的状态仍显示为 Active。
当您的应用迁移至另一个 Apple 开发者账号时,请将密钥替换为新所有者团队的密钥。
To replace the key:
- 在 Adapty 中,进入 App settings > iOS SDK。要确认 Adapty 当前使用的密钥,在 In-app purchase API (StoreKit 2) 部分,记录 Key ID 字段中的值。
- 生成一个新密钥。
- 在 In-app purchase API (StoreKit 2) 和 App Store promotional offers 部分,将新密钥添加到 Adapty,然后点击 Save。
- 一个密钥可供你 App Store Connect 团队的所有应用使用。如果其他 Adapty 应用也使用了第 1 步中的 Key ID,请将新密钥一并添加到这些应用中。同时,将你服务器上使用旧密钥的地方也替换为新密钥。
- 已吊销的密钥将在所有使用它的应用中立即失效,且无法恢复。请在 App Store Connect 中吊销旧密钥:即第 1 步中 Key ID 对应的有效密钥。
当 Adapty 没有可用密钥时完成购买的用户,可以通过恢复购买找回访问权限。