配置 App Store 集成
本节介绍如何为您的 iOS 应用建立 App Store 与 Adapty 之间的连接。这是我们显示订阅分析和验证购买所必需的。您可以在初始用户引导期间或稍后在 Adapty 看板的 App Settings 中完成集成。
尽管您可能在用户引导期间已初步配置了移动应用与 Adapty 的集成,但您可以在 App settings 中稍后修改这些设置。
配置更改可以在沙盒阶段安全进行,即在您安装了 Adapty SDK 的移动应用上线之前。应用发布后进行更改可能会破坏应用中的购买流程。
步骤 1. 提供 Bundle ID 和 Apple App ID
Bundle ID 是您的应用在 App Store 中的唯一标识符。这是 Adapty 基本功能(例如订阅处理)所必需的。
-
打开 App Store Connect。选择您的应用,然后进入 General → App Information 部分。
-
在 General Information 子部分中复制 Bundle ID。
- 从 Adapty 顶部菜单打开 App settings -> iOS SDK 标签页,将复制的值粘贴到 Bundle ID 字段中。
- 返回 App Store Connect 中的 App information 页面,从中复制 Apple ID。
- 在 Adapty 看板的 App settings -> iOS SDK 页面中,将该 ID 粘贴到 Apple app ID 字段。
步骤 2. 提供 Issuer ID 和 Key ID
In-app purchase Issuer ID(在 App Store Connect 中称为 Issuer ID)是一个特殊 ID,用于标识创建身份验证令牌的发行者。In-App Purchase Key ID(在 App Store Connect 中称为 Key ID)是与您在 在 App Store Connect 中生成应用内购买密钥 部分生成的加密密钥相关联的唯一标识符。
- 打开 App Store Connect。前往 Users and Access → Integrations → In-App Purchase 部分。
- 在 Active 列表中,找到您在 在 App Store Connect 中生成应用内购买密钥 部分创建的密钥。
- 复制 Issuer ID 并将其粘贴到 Adapty 看板中的 In-app purchase Issuer ID 字段。
- 复制 Key ID 并将其粘贴到 Adapty 看板中的 In-app purchase Key ID 字段。
步骤 3. 上传应用内购买密钥文件
将您在 在 App Store Connect 中生成应用内购买密钥 部分下载的 In-App Purchase Key 文件
上传到 Adapty 看板中的 Private key (.p8 file) 字段。
步骤 4. 针对试用和特别优惠 – 设置促销活动
如果您的应用有试用或其他促销活动,此步骤是必需的。
- 将您在步骤 2 中使用的相同密钥 ID 复制到 App Store promotional offers 部分中的 Subscription key ID 字段。
- 将您在步骤 3 中使用的相同 In-App Purchase Key 文件上传到 App Store promotional offers 部分中的 Subscription key (.p8 file) 区域。
步骤 5. 输入 App Store 共享密钥
App Store shared secret(也称为 App Store Connect Shared Secret)是一个 32 字符的十六进制字符串,用于应用内购买和订阅收据验证。
-
打开 App Store Connect。选择您的应用并前往 General → App Information 部分。
-
向下滚动到 App-Specific Shared Secret 子部分。
如果 App-Specific Shared Secret 子部分不存在,请确保您具有 Account Holder 或 Admin 角色。如果您具有 Admin 角色但仍无法看到 App-Specific Shared Secret 子部分,请让应用的 Account Holder(在 App Store Connect 中创建应用的人)为该应用生成 App Store 共享密钥。之后,该子部分也会向 Admin 显示。
- 点击 Manage 按钮。
-
在打开的 App-Specific Shared Secret 窗口中,复制 Shared Secret。如果没有看到共享密钥,请先点击 Manage 或 Generate 按钮(以可用的为准),然后再复制 Shared Secret。
-
将复制的 Shared Secret 粘贴到 Adapty 看板中的 App Store shared secret 字段。
- 点击 Adapty 看板中的 Save 按钮以确认更改。
步骤 6. 添加 App Store Connect API 密钥
生成 App Store Connect API 密钥并将其添加到 Adapty,以便能够从 Adapty 看板管理您在 App Store 中的产品:
- 在 App Store Connect 中,前往 Users and Access > Integrations > Team keys 并点击 +。
- 在 Generate API key 窗口中,输入密钥名称并授予其 Admin 访问权限。
- 点击密钥旁边的 Download。请注意,您只能下载一次。
- 在 Adapty 看板中,前往 App settings > iOS SDK 并点击 Connect API key。
- 填写窗口中的字段:
- Issuer ID:从 Users and Access > Integrations > Team keys 复制。它位于 API keys 表格上方。
- Key ID:从 Users and Access > Integrations > Team keys 复制。它位于 API keys 表格中您的密钥旁边。
- API key:上传您从 App Store Connect 下载的 API 密钥文件。
- 点击 Connect。
下一步