为应用设置收入验证

要开始使用收入验证，您需要确保已在应用中正确设置 Adjust SDK 并为 Adjust 提供必要的凭证，授权相关商店购买数据许可权限。

操作前须知

要求​

• Adjust 管理员、编辑员或自定义编辑员权限
• 创建和管理应用商店凭证：
  • Google Cloud: 项目或服务账户的Service Account Key Admin权限。
  • App Store Connect: Admin权限。

必备知识点​

• 收入验证仅适用于通过 Google Play 商店或 Apple App Store 进行的应用内购买，不适用于实体物品的购买。
• 适用于 iOS、安卓和 Unity 应用。

1. 设置 Adjust SDK

如需将 Adjust 购买验证集成到您的应用中，请确保已安装符合要求的最低版本 SDK 并完成发送购买收入事件所需的步骤。

• 安卓 v4.34.0 或更高版本
• iOS v4.34.0 或更高版本
• Unity v4.34.0 或更高版本

可选：设置验证 SDK 回传

设置 SDK 验证回传来在应用中直接接收购买的验证状态。通过在应用中实时接收此信息，您可以在随后启用自动发货，向用户发送已购买物品。

请注意，应用内验证 SDK 回传只可用于使用 Adjust 原生 SDK v5 的 iOS 和安卓应用。使用下面的链接了解如何迁移至 SDK v5，以及如何设置验证回传。

迁移至 Adjust SDK v5：​

• 安卓
• iOS
• Unity

设置验证 SDK 回传：​

• 安卓
• iOS
• Unity

2. 查找您的应用商店凭证

要与商店验证购买情况，您需要向 Adjust 提供特定凭证，以便我们匹配您的账户。

安卓：​

iOS：​

按照适用于应用商店平台的说明找到必要的凭证。

安卓设备

要为一个项目获服务账户创建服务账户密钥，您的用户账户必须拥有 服务账户密钥管理员​ 权限。

启用 Google Play Android Developer API

1. 在 Google Play 管理中心内找到 API 和服务 (APIs & Services)​ 。
2. 选择 + 启用 API 和服务 (Enable APIs and Services)​ 。
3. 在Mobile部分，选择 Google Play Android Developer API​ 。
4. 选择 启用​ 。
5. 设置必要的 API 凭证。
   1. 在 已启用的 API 和服务 (Enabled APIs & Services)​ 部分选择 Google Play Android Developer API​ 。
   2. 选择 创建凭证 (Create Credentials)​ 。
   3. 在Select an API部分，选择 Google Play Android Developer API​ 。
   4. 在What data will you be accessing?下，选择 应用程序数据 (Application data)​ 。
   5. 选择下一步。

创建服务账号

1. 在 Google Cloud 中找到创建服务账户 (Create service account)

2. 选择您的 Google Cloud 项目。

3. 输入服务账户名称。

   • 系统会自动生成服务账户 ID。

4. 可选：提供服务账号描述。

5. 选择 Create and Continue (创建并继续)​ 。

6. 授予服务账号项目访问权限

   1. 为服务账号分配 Pub/Sub 管理员​ 角色。
   2. 选择 + 添加其他角色 (Add another role)​ 。
   3. 为服务账户分配 监控查看者 (Monitoring Viewer )​ 角色。
   4. 选择 Continue​ (继续)。
   5. 可选：授予用户访问该服务账号的权限
   6. 选择 完成​

创建新的 API 密钥

1. 在 Google Cloud 中找到 IAM & 管理员 (IAM & Admin)​ 。
2. 选择 服务账户 (Service Accounts)​ 查看项目的服务账户。
3. 针对您创建的服务账户，选择 操作​ (三点图标)。
4. 选择 Manage keys (管理密钥)​ 。
5. 选择 添加密钥 > 创建新密钥 (Add Key > Create new key)​ 。
6. 在密钥类型 (Key type) 下选择 JSON​ 。
7. 私钥会自动下载。

iOS 设备

您需要拥有 App Store Connect 的 管理员​ 权限才能创建和管理 API 密钥。

查找发行商 ID

1. 在 App Store Connect 中，选择 用户与权限​ 图标。
2. 选择 集成​ 标签页。
3. 在左侧的密钥类型 (Key Type) 菜单下选择 应用内购买 (In-App Purchase)​ 。
4. 在页面顶部的 Issuer ID 旁选择复制。

生成新的 API 密钥

我们建议您生成一个专用于 Adjust 应用内收入验证的 API 密钥。

选择 + 生成 API 密钥

为新密钥命名，然后选择生成 (Generate)。

您现在可以在活跃密钥列表中看到新密钥了。选择下载 (Download)。

确认下载新的 API 密钥。

1/4

(1/4)

(2/4)

(3/4)

(4/4)

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

   • 如果您尚未在 App Store Connect 账户中请求 API 访问权限，请先完成请求。

2. 在 名称 (Name)​ 字段中输入密钥名称。

3. 选择 Generate​ (生成)。

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

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

6. 选择 下载应用内购买密钥 (Download In-App Purchase Key)​ 。

7. 选择 下载​ 以继续。

8. 复制下载文件中的完整 API 密钥。

3. 对于 iOS: 将 Adjust 连接至 App Store Connect

按照以下步骤在 Adjust 控制面板中添加 App Store Connect 凭证:

1. 在 Adjust 中找到 DataWorks > 关联​ 。
2. 选择 + 新关联​ 。
3. 从列表中选择 App Store Connect (应用内购买)​ 。
4. 在服务中选择 收入验证​ 。
5. 输入您的 Issuer ID​ 。
6. 输入 Key ID​ 。
7. 通过文本编辑器打开 .p8 文件，复制整个私钥，将其粘贴进 Private key (私人密钥) 字段。

4. 为您的应用添加收入验证

现在为您的应用启用收入验证：

1. 在 Adjust 中找到 AppView​ 并选择您的应用。

2. 找到 数据保护​ 标签页。

3. 在 收入验证​ 下，选择 编辑​ ()。

4. 将收入验证开关切换为 " 开​ "。

5. 提供平台特定信息：

   • 对于 iOS 应用：如果您正在设置 iOS 应用，则需要选择要使用的 App Store Connect 账户。
   • 对于安卓应用：上传之前下载的 JSON 密钥文件。

6. 然后选择 保存​ 。

一切就绪！

与合作伙伴分享已验证收入数据

Adjust 的购买验证解决方案可确保只与合作伙伴分享已经过验证的收入数据。也就是说，您可以确保分享的数据准确无误，后续的推广活动优化也会更加高效。

如果您已经在 Adjust 控制面板中设置了与合作伙伴的应用内收入分享，则无需进行任何变更。Adjust 会自动只转发带有verified passed状态的收入数据。

要设置新的合作伙伴并启用应用内收入分享，请按照在 Campaign Lab 中设置广告渠道一文中的说明。操作至选择数据分享选项一步时，请确保选择 应用内收入​ 。