为应用设置收入验证

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

操作前须知

增长方案:

收入验证作为 Adjust 增长解决方案提供。要将此功能添加至套餐，请联系您的 Adjust 代表或发送邮件至sales@adjust.com。

要求​

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

必备知识点​

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

1. 设置 Adjust SDK

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

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

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

安卓：​

验证参数定义示例
JSON 密钥您的 JSON 密钥，从 Google Cloud Console 的服务账户页面下载。example_key_file

iOS：​

验证参数定义示例
发行商 ID（Issuer ID）App Store Connect 中集成界面显示的 issuer ID。57246542-96fe-1a63-e053-0824d011072a
密钥 ID（Key ID）App Store Connect 中集成界面显示的私人密钥 ID。2X9R4HXF34
应用内购买 API 密钥从 App Store Connect 下载的 P8 API 密钥。授权 Adjust 通过 App Store Server API 访问您的应用数据。 -----BEGIN PRIVATE KEY-----
MIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQgNxUqm0R2vt4IrLAQr9gfDPixwSxH9wJZ6NV3X0ax4eWgCgYIKoZIzj0DAQehasda2ANCAAQx53AlofI4Of54lbR04A6D2QMbe0mt8+JtRHkJJCEUesUfySoZsm2jeh3qodLE0pZ2Rayv26qFMKuKEwemB2Op
-----END PRIVATE KEY-----

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

安卓设备

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

启用 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 密钥

1/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 中设置广告渠道一文中的说明。操作至选择数据分享选项一步时，请确保选择 应用内收入​ 。

请注意:

请务必确保您的设置准确无误，任何凭证输入错误、双重编码获其他配置问题都会影响事件发送验证信息。