公告：更新用于 ROI360 iOS 收据验证的 App Store 凭证

推荐用于
营销人员
最近更新：
最新动态 由于 Apple 已弃用当前的验证 API，AppsFlyer ROI360 的 iOS 收入验证流程将迁移至 Apple 全新的应用内购买验证 API。
为了确保您能够持续实时、准确地验证 iOS 收入数据，请您在 AppsFlyer 平台中更新 App Store 凭证。
如果您的应用仍在使用 Apple Notifications Version 1，请在更新凭证前切换至 Version 2 。
更新日期 02/04/2025
重要须知

此变更适用于使用 ROI360 进行 iOS 应用内购买与订阅收入验证的应用。
升级至新版 iOS 验证流程后，您将获得以下优势：

  • 通过 Apple 新的接口端点，增强与 Apple Store 的实时验证功能。
  • 应用内事件结构或参数保持不变。
  • AppsFlyer Purchase SDK Connector 的验证结果响应将会更新，其中包括一个store_status用于标识验证失败的新代码。
  • 无需更改现有 SDK 实现方式。

Apple 可能随时停用旧版 API，为避免数据中断，我们强烈建议您尽快完成更新。
待办事项
请按照以下步骤操作：
  1. 在 App Store Connect 中生成应用内购买密钥。
  2. 将该密钥上传至 AppsFlyer 平台中的「收入设置（Revenue Settings）」页面。
如果您的应用仍在使用 Apple 服务器通知版本 1，则在更新凭证前必须先切换至版本 2 。若您的应用需满足此前提条件，系统将在「收入设置」页面显示提示消息。
请参阅下方的详细操作指南：

设置苹果服务器通知的版本2

如果您的应用之前使用了 Apple 服务器通知版本 1，您必须在更新验证凭据之前在 App Store Connect 中切换到版本 2。（如果您的应用符合此前提条件，您将在收入设置页面看到相应提示。）

设置苹果服务器通知的版本 2

  1. 在 App Store Connect 中，进入应用信息部分，找到 App Store 服务器通知。

    image__9_.png

  2. 对于 Production Server URL，点击 编辑。

  3. 请勿更改 Production Server URL 中的 URL。

    image__9_.png

  4. 在通知版本项下，选择版本 2 通知。
  5. 点击保存。
  6. 在App Store 服务器通知部分，点击Sandbox Server（沙盒服务器） URL旁的编辑按钮。
  7. 重复步骤 3-5。

更新用于 ROI360 iOS 收据验证的 App Store 凭证

iOS 应用内购买 API 对接所需的凭证是：

  • 应用内购买密钥
  • Key ID
  • Issuer ID

前期准备 ：

  • 更新密钥涉及在 App Store Connect 和 AppsFlyer 两个平台中的操作。请在设置过程中保持这两个页面同时开启。
  • 您需要管理员权限才能在 AppsFlyer 中设置密钥。

更新 iOS 凭证的步骤：

  1. 在 App Store Connect 中，进入 用户和访问权限页面
  2. 前往用户和访问权限> 对接，在密钥列表中，选择应用内购买。
  3. 点击 + 生成一个新的应用内购买密钥。
  4. 输入您的 API 密钥名称。
  5. 点击生成。
  6. 在刚刚生成的密钥旁边，点击下载应用内购买密钥。请注意：该密钥只能下载一次，请妥善保存。
  7. 在 AppsFlyer 平台中，从侧边菜单选择设置 > 收入设置。
  8. 从列表中选择相关应用。
  9. 在购买和订阅选项卡中，点击更新密钥。
  10. 在新密钥区域的应用内购买密钥字段中，单击上传图标（upload-2.png）以上传 p8 文件。
  11. 在 App Store Connect 中，复制您刚刚生成的密钥的 Key ID，并将其粘贴到 AppsFlyer 购买和订阅设置中的 Key ID字段里。

  12. 在 App Store Connect 中，复制 Issuer ID ，并将其粘贴到 AppsFlyer 购买和订阅设置中的 Issuer ID字段。请注意：如果页面顶部未显示 Issuer ID，请创建一个 App Store Connect API 密钥（具有任意权限级别）。之后，Issuer ID 将出现在应用内购买密钥的页面顶部。

  13. 在 AppsFlyer 购买和订阅设置中，点击 验证密钥 以确保您输入的密钥是正确的。 
  14. 点击更新密钥。一旦密钥更新，您的应用将全面迁移至 Apple 的新版 iOS 验证流程。