开始使用广告服务统一平台公共 API
设置组织、服务帐户和 API 密钥，以便开始使用 广告服务 Unified Platform public API 以编程方式管理您的应用、广告位或广告系列。
阅读时间6 分钟最后更新于 1 个月前
广告服务 Unified Platform public API 是 Unity Monetization（变现）和 Unity User Acquisition（用户获取）后台的最新版本的管理 API（旧版）。
如果已在 Unity Monetization 或 User Acquisition（用户获取）后台中使用管理 API（旧版），请参阅改用广告服务统一平台公共 API 迁移到新 Unity Dashboard。
虽然您可以直接在 Unity Dashboards 中管理您的应用、广告位和广告系列，但广告服务统一平台公共 API 允许您以编程方式管理终端。下表详细介绍了可以使用 API 管理的终端：
后台 | 托管终端 | 优点 |
|---|---|---|
| 变现 |
| 批量创建和更新广告位，而不是一时间一个。 如果您定期启动新应用、添加广告位或跨不同广告格式调整测试设备，这些终端非常有用。 |
| 用户获取 |
| 自动执行更改，而不是在控制面板中一时间执行一个更改。 如果您管理大量广告系列或需要频繁更新，这些终端非常有用。 |
要开始使用广告服务统一平台公共 API，请完成以下设置任务：
- 先决条件
- 创建组织
- 创建服务帐户
- 生成 API 密钥y
- 实现广告服务统一平台公共 API
Prerequisites
在开始使用广告服务统一平台公共 API 之前，请确保团队中的某个人在 Unity 后台中具有以下组织角色：
后台 | 必需角色 |
|---|---|
| 变现 | 所有者 |
| 用户获取 | 经理 |
Create a service account
从 New Unity Dashboard 创建服务帐户以验证 API 调用。
Advertisers
要从 User Acquisition（用户获取）后台创建服务帐户并为其添加广告主指定的角色，请完成以下步骤：
1.转到 User Acquisition（用户获取）后台 > 设置 > 组织 > 管理组织 > 服务帐户 > + 新建。
2.选择 + 管理组织角色。
3.输入服务帐户名称和服务帐户描述。
4.在创建的新服务帐户页面中，转到 Organization roles 部分 > + Manage organization roles。
5.从 Organization roles 对话框中，转到 Grow 下拉选单，然后选择列表中的所有 Advertise API 角色以添加到服务帐户。
Publishers
要从 Monetization（变现）后台创建服务帐户并为其添加发布者指定的角色，请完成以下步骤：
1.转到 Monetization（变现）后台 > 设置 > 组织 > 管理组织 > 服务帐户 > + 新建。
2.选择 + 管理组织角色。
3.输入服务帐户名称和服务帐户描述。
4.在创建的新服务帐户页面中，转到 Organization roles 部分 > + Manage organization roles。
5.从 Organization roles 对话框中，转到 Monetization 下拉选单，然后选择以下 Publisher API 角色以添加到您的服务帐户：
- 广告服务发布者自动化
- 广告服务商测试设备自动化
Generate your API key
要创建 API 密钥来验证 Unity Dashboard 的请求，请从新服务帐户执行以下操作：
1.转到服务帐户的 Keys 部分。
2.选择 + 添加密钥 以创建 API 密钥。
重要
后台仅显示一次密钥，因此请将 Key ID 和 Secret 安全地存储在一起，供以后参考。如果丢失了键值，则必须创建新键。
3.选择 Done。
Implement the Ads Unified Platform public API
请参阅以下 API 参考以构建集成。
- 发布者：广告服务统一平台发布者公共 API
- 广告主：广告服务统一平台广告主公共 API