第三方不是 Ad Manager 的直接用户,因为他们可能没有自己的 Ad Manager 广告资源网。而是为他们的客户(即 Ad Manager 客户)创建服务或与 Ad Manager 集成。本指南通过提供最佳实践、提示和技巧,介绍了第三方集成的基础知识。
本指南假定您已掌握 Ad Manager API 的应用知识。如果您不熟悉 Ad Manager API,请参阅我们的入门文档。
第三方入门指南
如需使用 Ad Manager API 访问 Ad Manager 客户的网络,只需遵循以下准则。您无需获得 Google 的额外批准,但请注意,访问和/或使用 Ad Manager API 即表示您同意 Ad Manager API 条款及条件。
如何以第三方身份测试 Ad Manager 集成
作为第三方,您可能想知道如何在客户的生产网络中运行之前测试 Ad Manager 集成。建议的方法是创建测试网络。您无需成为 Ad Manager 客户即可执行此操作。任何拥有 Google 账号的用户都可以创建测试网络。
但请注意测试网络和生产网络之间的差异。测试广告资源网无法投放广告。测试网络也不一定包含客户在其正式版网络上可能提供的所有功能。如果您需要针对测试广告资源网中不提供的 Ad Manager 功能进行测试,一种方法是通过 Ad Manager 转销商购买非测试广告资源网的访问权限。
此外,您应向客户明确说明,他们的生产网络需要具备哪些功能,您的应用才能正常运行。您的应用应通过以下方式处理功能可能不存在的情况:捕获异常并妥善处理失败,或保留客户端列表以及每个客户端具有或不具有的功能。您的客户应负责与其 Google 联系人合作,管理其广告资源网中的功能。
身份验证:如何正确访问客户的 Ad Manager 广告资源网
为了让您的应用能够访问客户的 Ad Manager 广告资源网,您需要以安全的方式设置身份验证工作流程。
这就涉及到以下两个步骤:
- 创建一个 Google 账号邮箱,用于访问客户的广告资源网。
- 让客户将此账号作为用户添加到其 Ad Manager 广告资源网中。
对于第 1 步,您可以为每个客户创建一个单独的 Google 账号,也可以创建一个主账号,用于所有客户。如果您的某个账号遭到入侵,前一种选项会更安全。后者意味着您只需执行第 1 步一次。
无论您在第 1 步中采取何种操作,在第 2 步中,您都需要让每个新客户将您为其创建的相应 Google 账号作为用户添加到其 Ad Manager 广告资源网中。
1. 创建 Google 账号
您可以通过多种方式创建可添加到 Ad Manager 广告资源网的 Google 账号。
选项 1:创建 OAuth2 服务账号,该账号会为您生成一个服务账号邮箱,该邮箱可作为 Google 账号使用。有关创建新服务账号的说明。
选项 2:您可以通过注册为新用户来创建常规 Google 账号(“Gmail”账号)。 如果您已有 Google 账号,请在无痕式窗口或新的浏览器会话中完成此注册。或者,如果贵公司使用 Google Workspace,您可以在贵公司的网域中创建一个 Google 账号,并使用该账号。在本指南中,我们将这两种账号统称为“常规”Google 账号。
2. 请客户将您的 Google 账号添加到其广告资源网
在您获得用于访问客户广告资源网的 Google 账号后,请让客户将该账号作为新用户添加到其 Ad Manager 广告资源网中。
如果您向他们提供 OAuth2 服务账号邮箱,请让他们将其添加到自己的广告资源网中。
如果您向他们提供的是常规 Google 账号,请让他们将您的账号添加为用户,以便您访问其广告资源网。
无论您采用哪种方式,请务必与客户讨论您的账号应具有哪些角色和权限,以便您的应用可以访问客户网络中所需的数据。
现在,您可以开始向客户的 Ad Manager 广告资源网发出 API 调用。请务必将 networkCode SOAP 标头设置为您要对其进行 API 调用的客户的广告资源网代码。我们的所有客户端库都允许以编程方式设置此参数。例如,在 Ads Java 客户端库中,您可以在构建 DfpSession 实例时以编程方式设置广告资源网代码。
及时了解 API 的最新动态
请务必及时了解哪些 API 版本已弃用或停用,以及新版本的发布时间。您不希望在某个版本停用时措手不及,并面临客户端损坏的风险。我们无法始终像对待客户那样,就即将发生的弃用和停用事宜与第三方联系。因此,您有责任订阅我们的三个主要 API 更新渠道之一,并调整您的通知设置:
- 我们的 Ad Manager API 弃用公告群组。
- 我们的 Google Ads 开发者博客。
我们还会在开发者网站上提供弃用时间表,您应定期查看。