配置 App Store 集成

本节介绍如何为您的 iOS 应用建立 App Store 与 Adapty 之间的连接。这是我们显示订阅数据图表和验证购买所必需的步骤。您可以在初始用户引导期间完成集成，也可以稍后在 Adapty 看板的 App Settings 中进行配置。

虽然您可能在用户引导期间已完成移动应用与 Adapty 的集成配置，但您仍可以随时在 App settings 中修改这些设置。

Danger

在沙盒阶段，只要你的移动应用尚未正式上线，可以安全地进行配置更改。应用发布后再做更改可能会破坏应用内的购买流程。

步骤 1. 填写 Bundle ID 和 Apple app ID

Bundle ID 和 Apple app ID 均为必填项。Bundle ID 是您的应用在 App Store 中的唯一标识符，它是订阅处理等 Adapty 核心功能的基础。Apple app ID 也是必须填写的，这样才能在 Products 页面创建新产品并推送到商店。

Note

若未填写 Apple app ID，Products 页面上的 Create a new product and push to stores 选项将被禁用，且看板不会给出任何提示说明原因。

打开 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 字段。

第二步：提供 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 中生成应用内购买密钥部分生成的加密密钥关联的唯一标识符。

Note

App Store Connect 有两种密钥类型，它们的字段都标注为 Issuer ID 和 Key ID。第 2–3 步使用的是 Integrations → In-App Purchase 标签页中的 In-App Purchase 密钥。Team keys 标签页中的 App Store Connect API 密钥是另一种密钥，有其独立的 ID——你将在第 6 步中添加它。

打开 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) 字段。

第四步：针对试用期和特殊优惠——配置促销活动

Important

如果你的应用包含试用期或其他促销活动，此步骤为必填项。

将你在第二步中使用的同一个 Key ID 复制到 App Store promotional offers 部分的 Subscription key ID 字段中。
将你在第三步中使用的同一个 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 子板块。

Info

如果 App-Specific Shared Secret 子部分未显示，请确认您拥有 Account Holder 或 Admin 角色。如果您已具有 Admin 角色但仍看不到 App-Specific Shared Secret 子部分，请联系该应用的 Account Holder（即在 App Store Connect 中创建该应用的人），让其为该应用生成 App Store shared secret。生成后，Admin 也可以看到该子部分。

点击 Manage 按钮。

在打开的 App-Specific Shared Secret 窗口中，复制 Shared Secret。如果没有看到共享密钥，请先点击可用的 Manage 或 Generate 按钮，然后再复制 Shared Secret。
将复制的 Shared Secret 粘贴到 Adapty 看板中的 App Store shared secret 字段。