开始使用 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 管理的终端:
后台 | 托管终端 | 优点 |
|---|---|---|
| 变现 |
| 批量创建和更新广告广告位 (Placements),而不是一时间一个。 如果您定期启动新建应用、添加广告广告位 (Placements)或跨不同广告格式调整测试Devices,这些终端非常有用。 |
| 用户获取 |
| 自动执行更改,而不是在控制面板中一时间执行一个更改。 如果您管理大量广告系列或需要频繁进行更新,这些终端非常有用。 |
要开始使用 Ads Unified 平台 public API,请完成以下设置任务:
- 先决条件
- 创建组织
- 创建服务帐户
- Genate API 密钥
- 实现 Ads 统一平台 public API
Prerequisites
在开始使用 Ads 统一平台 public API 之前,请确保 Team ON 的某个人在 Unity 后台中具有以下组织角色:
后台 | 必需角色 |
|---|---|
| 变现 | 所有者 |
| 用户获取 | 经理 |
Create an organization
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**
Generate your API key
要创建 API 密钥验证 Unity Dashboard(Unity 后台)中的请求,请从新建服务帐户执行以下操作:
1.转到服务帐户的密钥部分。
2.选择 **+ Add key 以创建 API 密钥。
3.选择 Done。
Implement the Ads Unified Platform public API
请参阅以下 API 参考以生成集成。