文档

Unity 变现服务

开始使用 Ads Unified 平台 public API

设置Organization、服务帐户和 API 密钥,以便Start使用 Ads Unified 平台 public API 以编程方式管理您的应用、广告位 (Placements)或广告系列。
阅读时间6 分钟最后更新于 2 天前

Ads Unified 平台 public API 是 Unity 变现服务(变现)和 Unity 用户获取(用户获取)后台的最新版本的管理 API(Legacy)。
如果已在 Unity 变现服务或用户获取后台中使用管理 API(Legacy),请参阅改用 Ads 统一平台 public API 迁移到新建 Unity Dashboard。
虽然您可以直接在 Unity Dashboards 中管理您的应用、广告位 (Placements)和广告系列,但 Ads Unified 平台 public API 允许您以编程方式管理终端。表详细细节了可以使用 API 管理的终端:

后台

托管终端

优点

变现
  • 应用程序
  • 广告位
  • 测试 Devices
批量创建和更新广告广告位 (Placements),而不是一时间一个。
如果您定期启动新建应用、添加广告广告位 (Placements)或跨不同广告格式调整测试Devices,这些终端非常有用。
用户获取
  • 应用程序
  • 归因
  • Campaigns(广告系列)
  • 广告系列管理
  • 广告素材包
  • Creatives(广告素材)
自动执行更改,而不是在控制面板中一时间执行一个更改。
如果您管理大量广告系列或需要频繁进行更新,这些终端非常有用。
要开始使用 Ads Unified 平台 public API,请完成以下设置任务:
  1. 先决条件
  2. 创建组织
  3. 创建服务帐户
  4. Genate API 密钥
  5. 实现 Ads 统一平台 public API
1

Prerequisites

在开始使用 Ads 统一平台 public API 之前,请确保 Team ON 的某个人在 Unity 后台中具有以下组织角色:

后台

必需角色

变现所有者
用户获取经理
2

Create an organization

创建一个Organization以便在 Ads Unified 平台 public API 中管理您的终端。
请参阅创建组织以设置一个组织,并参阅其他组织文章以在创建组织后管理或更新组织。
3

Create a service account

从 新建 Unity Dashboard 创建服务帐户以验证 API Calls。

Advertisers

要从 用户获取(用户获取)后台创建服务帐户并为其添加指定的于广告主的角色,请完成以下步骤:
1.转到 用户获取(用户获取)后台 > Settings > Organization > Manage Organization > Service Accounts > + 新建。 2.选择 + 管理组织角色。 3.输入服务帐户名称和服务帐户描述。 4.在创建的新建服务帐户Page中,转到 组织角色 部分 > + Manage 组织角色。 5.从 组织角色 对话框中,转到 用户获取 Dropdown选单,然后选择列表中的All Advertise API 角色以添加到您的服务帐户。

Publishers

要从 Monetization(变现)后台创建服务帐户并为其添加指定的于发布者者的角色,请完成以下步骤:
1.转到 Monetization(变现)后台 > Settings > Organization > Manage Organization > Service Accounts > + 新建。 2.选择 + 管理组织角色。 3.输入服务帐户名称和服务帐户描述。 4.在创建的新建服务帐户Page中,转到 组织角色 部分 > + Manage 组织角色。 5.从 组织角色 对话框中,转到 Monetization Dropdown选单,然后选择以下 发布者 API 角色以添加到您的服务帐户:
  • Ads 发布者 Automation**
  • Ads 发布者 测试 Devices Automation**
4

Generate your API key

要创建 API 密钥验证 Unity Dashboard(Unity 后台)中的请求,请从新建服务帐户执行以下操作:
1.转到服务帐户的密钥部分。 2.选择 **+ Add key 以创建 API 密钥。
重要
后台仅显示一次密钥,因此请将 Key id 和 Secret 安全地存储在全体学员,供以后参考。如果丢失了Key,则必须创建Keyy。
3.选择 Done。
5

Implement the Ads Unified Platform public API

请参阅以下 API 参考以生成集成。