作为第三方与 Google Ad Manager 集成

第三方不是 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 广告资源网,您需要以安全的方式设置身份验证工作流程。

这就涉及到以下两个步骤:

  1. 创建您将用于访问客户网络的 Google 账号电子邮件地址。
  2. 让客户将此账号作为用户添加到其 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 调用的客户的广告资源网代码。我们的所有客户端库都允许以编程方式设置此属性。例如,在广告 Java 客户端库中,您可以在构建 DfpSession 实例时以编程方式设置广告资源网代码

及时了解 API 的最新动态

请务必及时了解哪些 API 版本已弃用或停用,以及何时发布新版本。您不希望在某个版本被弃用时措手不及,导致客户端出现故障。我们无法像对待客户那样,就即将发生的弃用和终止向第三方发送通知。因此,您有责任订阅我们的三个主要 API 更新渠道之一,并调整通知设置:

我们还在开发者网站上提供了弃用时间表,您应定期关注。