iOS 应用验证

iOS 应用需要先经过验证才能接收 SKAdNetwork 数据,或在 Conversion Hub 中设置转化值映射。请按照本文中的说明操作,申请并管理 iOS 应用验证。

操作前须知

以下是您在操作前需要了解的内容。

要求

  • 管理员、编辑员或自定义编辑员权限

为何要验证应用 ID?

应用 ID 被 Adjust 验证后,您就可以在应用中使用 Adjust 的 SKAdNetwork 解决方案了。

SKAN 回调由 Apple 发送至投放广告的渠道,渠道会填充特定字段,随后将回调发送至 Adjust。回调只将详细 Apple App ID作为标识符,Adjust 可使用该标识符在系统内将回调数据指定至特定应用。

Apple 的应用 ID 是公开的,因此要保护数据安全,应用验证十分关键。也就是说,Adjust 可以确认您确实是应用的所有者,其他人无法错误地将您的应用添加到自己的账户并接收其 SKAN 回调数据。

我的应用没有应用 ID 怎么办?

在 Adjust 中更改或移除应用 ID 会发生什么?

1. 使用您的 Apple ID 登录 App Store Connect

使用您的 Apple ID 登录 App Store Connect账户。

请注意:
您需要 App Store Connect 的管理员权限才能进行后续步骤。

2. 收集验证参数

要生成 JSON Web Token (JWT) 并授权发送至 App Store Connect API 的请求,Adjust 需要以下参数:

验证参数定义示例
发行商 ID(Issuer ID)App Store Connect 中 API 密钥界面显示的 issuer ID。57246542-96fe-1a63-e053-0824d011072a
密钥 ID(Key ID)App Store Connect 中 API 密钥界面显示的私人密钥 ID。2X9R4HXF34
App Store Connect API 密钥您的 P8 API 密钥 (从 App Store Connect 下载)。该密钥可授予 App Store Connect 中应用数据的访问权限。
  • 此密钥至少应拥有 开发者 (Developer) 访问权限。
-----BEGIN PRIVATE KEY-----
MIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQgNxUqm0R2vt4IrLAQr9gfDPixwSxH9wJZ6NV3X0ax4eWgCgYIKoZIzj0DAQehasda2ANCAAQx53AlofI4Of54lbR04A6D2QMbe0mt8+JtRHkJJCEUesUfySoZsm2jeh3qodLE0pZ2Rayv26qFMKuKEwemB2Op
-----END PRIVATE KEY-----

查找发行商 ID

A screenshot showing where to find the necessary credentials in App Store Connect.
  1. 在 App Store Connect 中,选择 用户与权限​ 图标。
  2. 选择 密钥 (Keys)​ 标签页。
  3. 在左侧的 密钥类型 (Key Type)​ 菜单中,选择 App Store Connect API​ 。
  4. 在页面顶部 发行商 ID (Issuer ID)​ 旁,选择 复制 (Copy)​ 。

生成新的 API 密钥

我们建议您生成 Adjust 验证专用的 API 密钥。

选择 + 生成 API 密钥

1/4
  1. 选择 Generate API Key​ (生成 API 密钥) 或 +​ 图标创建新的密钥。

    • 如果您尚未在 App Store Connect 账户中请求 API 访问权限,请先完成请求。
  2. 名称 (Name)​ 字段中输入密钥名称。

  3. 访问权限 (Access)​ 字段中选择Developer作为角色。

  4. 选择 Generate​ (生成)。

  5. 新的 API 密钥及其密钥 ID 会显示在活跃密钥列表中。

  6. 将光标悬停在生成密钥的密钥 ID 一栏中。选择出现的 复制密钥 ID​ (Copy Key ID) 链接。

  7. 选择 下载​ () 图标。

  8. 选择 下载​ 以继续。

  9. 复制下载文件中的完整 App Store Connect API 密钥。

3. 在关联页面中关联至 App Store Connect

  1. 关联​ 页面的概览中选择 + 新关联​ 。
  2. 在合作伙伴列表中找到App Store Connect
  3. 选择 iOS 应用验证​ 作为服务。
  4. 粘贴您的 Private key​ 。
  5. 输入您的 Issuer ID​ 。
  6. 输入 Key ID​ 。
  7. 选择 关联​ 。

请求关联账户后,Adjust 会生成 JSON web token (JWT) 并从 App Store Connect API 调取特定应用信息。

如果输入的验证参数有效,那么连接就已建立。如果提供的值有问题,您就会看到错误信息。

4. 在 AppView 中请求应用验证

选择 AppView> 所有应用。从列表中选择您的应用。

1/2

要请求 Adjust 验证您的应用 ID,请按照以下步骤在 Adjust 控制面板中操作。

  1. 找到 AppView​ > 所有应用​ 。
  2. 从列表中选择您的应用。
  3. 选择 平台​ 标签页
  4. Apple App Store下输入您的 应用 ID​ 。
  5. 选择 请求验证​ 。
  6. 您可以在 App Store 图标上看到徽章,该徽章会指示应用 ID 验证的状态。
  • 已请求验证应用 ID,但验证尚未完成 – App Store 图标上的徽章呈 红色​ ,并显示 "已请求 iOS 应用 ID 验证" 的信息。
  • 应用 ID 已验证 – App Store 图标上显示 绿色​ 的徽章,以及 "iOS 应用 ID 已验证" 的信息。

如果在验证应用 ID 时出错,那么就会出现验证失败窗口。

Screenshot 2024-01-18 at 16.32.50.png

如果您尚未在关联中输入认证参数,请 前往关联​ ,然后按照"在关联中连接至 App Store Connect 中的步骤操作。

如果您已经在关联中输入了认证参数,请仔细检查您在 Adjust​ 控制面板中输入的应用 ID是否与 App Store Connect 中的应用 ID 相匹配。

在关联页面输入验证参数并确认应用 ID 正确后,请再次选择 请求验证​ 。如果错误弹窗再次出现,可能意味着出现了其他问题 (例如认证参数有效但是针对的是错误的 App Store Connect 账户)。请发送邮件至support@adjust.com或联系您的 Adjust 代表。

5. 移除关联及撤销密钥

Adjust 只需要连接到 App Store Connect API 来对您的 iOS 应用进行一次性验证。确认验证已完成后,我们建议删除此关联,保护数据安全。按照以下步骤在 Adjust 控制面板中移除关联:

  1. 找到 DataWorks​ ,选择 关联​ 。
  2. 在合作伙伴列表中选择 App Store Connect​ 。
  3. 找到操作竖列,选择 删除 图标。
  4. 选择 删除​ 。

未来,如果您在 Adjust 账户中添加了 iOS 应用,则可以按照本文中的步骤使用同一个 API 密钥再次连接到 App Store Connect API 并验证新应用。完成 iOS 应用验证后,可以按照以下步骤操作,撤销在 App Store Connect 中创建的 API 密钥:

  1. 使用拥有管理员权限并拥有相关应用访问权限的 Apple ID 登录您的App Store Connect账户。
  2. 选择 用户和访问权限​ 图标。
  3. 选择 密钥 (Keys)​ 标签页。
  4. 活跃​ 密钥部分的右侧点击 编辑​ 按钮。
  5. 找到要撤销的密钥,选择左侧的复选框。
  6. 选择撤销密钥( Revoke Key​ )。
  7. 选择 撤销​ (Revoke) 。