配置 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 基本功能(例如订阅处理)所必需的。

  1. 打开 App Store Connect。选择您的应用,然后进入 GeneralApp Information 部分。

  2. General Information 子部分中复制 Bundle ID

  1. 从 Adapty 顶部菜单打开 App settings -> iOS SDK 标签页,将复制的值粘贴到 Bundle ID 字段中。
  1. 返回 App Store Connect 中的 App information 页面,从中复制 Apple ID
  2. 在 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 中生成应用内购买密钥 部分生成的加密密钥相关联的唯一标识符。

  1. 打开 App Store Connect。前往 Users and AccessIntegrationsIn-App Purchase 部分。
  2. Active 列表中,找到您在 在 App Store Connect 中生成应用内购买密钥 部分创建的密钥。
19a2868-issuer_apple.webp
  1. 复制 Issuer ID 并将其粘贴到 Adapty 看板中的 In-app purchase Issuer ID 字段。
c2b42e7-issuer_id.webp
  1. 复制 Key ID 并将其粘贴到 Adapty 看板中的 In-app purchase Key ID 字段。

步骤 3. 上传应用内购买密钥文件

将您在 在 App Store Connect 中生成应用内购买密钥 部分下载的 In-App Purchase Key 文件

88cdfff-download_inapp_file.webp

上传到 Adapty 看板中的 Private key (.p8 file) 字段。

253b840-in-app_file_upload.webp

步骤 4. 针对试用和特别优惠 – 设置促销活动

如果您的应用有试用或其他促销活动,此步骤是必需的。

  1. 将您在步骤 2 中使用的相同密钥 ID 复制到 App Store promotional offers 部分中的 Subscription key ID 字段。
  2. 将您在步骤 3 中使用的相同 In-App Purchase Key 文件上传到 App Store promotional offers 部分中的 Subscription key (.p8 file) 区域。
promo-key.webp

步骤 5. 输入 App Store 共享密钥

App Store shared secret(也称为 App Store Connect Shared Secret)是一个 32 字符的十六进制字符串,用于应用内购买和订阅收据验证。

  1. 打开 App Store Connect。选择您的应用并前往 GeneralApp Information 部分。

  2. 向下滚动到 App-Specific Shared Secret 子部分。

2bd112a-shared_secret_apple.webp

如果 App-Specific Shared Secret 子部分不存在,请确保您具有 Account Holder 或 Admin 角色。如果您具有 Admin 角色但仍无法看到 App-Specific Shared Secret 子部分,请让应用的 Account Holder(在 App Store Connect 中创建应用的人)为该应用生成 App Store 共享密钥。之后,该子部分也会向 Admin 显示。

  1. 点击 Manage 按钮。
2d8b4c0-shared_secret_apple_copy.webp
  1. 在打开的 App-Specific Shared Secret 窗口中,复制 Shared Secret。如果没有看到共享密钥,请先点击 ManageGenerate 按钮(以可用的为准),然后再复制 Shared Secret

  2. 将复制的 Shared Secret 粘贴到 Adapty 看板中的 App Store shared secret 字段。

4f9624d-shared_secret.webp
  1. 点击 Adapty 看板中的 Save 按钮以确认更改。

步骤 6. 添加 App Store Connect API 密钥

生成 App Store Connect API 密钥并将其添加到 Adapty,以便能够从 Adapty 看板管理您在 App Store 中的产品

  1. 在 App Store Connect 中,前往 Users and Access > Integrations > Team keys 并点击 +
app-store-connect-api.webp
  1. Generate API key 窗口中,输入密钥名称并授予其 Admin 访问权限。
generate-api-key.webp
  1. 点击密钥旁边的 Download。请注意,您只能下载一次。
download-api-key.webp
  1. 在 Adapty 看板中,前往 App settings > iOS SDK 并点击 Connect API key
connect-api-key.webp
  1. 填写窗口中的字段:
issuer-id.webp
key-id.webp
  • API key:上传您从 App Store Connect 下载的 API 密钥文件。
app-store-connect-key.webp
  1. 点击 Connect

下一步