作为第三方与 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 广告联盟中。

无论您采取哪种路线,都请务必与客户讨论您的帐号应具有的角色和权限,以便您的应用可以访问在客户网络上需要的数据。

现在,您可以开始向客户的 Ad Manager 广告资源网发出 API 调用了。请务必将 networkCode SOAP 标头设置为您要向其发出 API 调用的客户端广告联盟代码。我们的所有客户端库都允许以编程方式进行此项设置。例如,在广告 Java 客户端库中,您可以在构建 DfpSession 实例时以编程方式设置广告联盟代码

了解 API 的最新动态

请务必及时了解哪些 API 版本已弃用或停用,以及新版本的发布时间。您肯定不希望在某个版本被弃用时措手不及,从而有可能破坏您的客户端。我们并不总是能够像对待客户那样,就即将弃用和停用的事宜与第三方联系。因此,您有责任订阅我们的三个主要渠道之一,以便获取 API 更新信息并调整通知设置:

我们还会在开发者网站上提供弃用时间表,请定期查看该时间表。

获取支持

如果您在 Ad Manager 集成方面遇到问题,请根据您的具体问题通过我们提供的以下支持渠道获取帮助。如果您遇到的是产品层面的问题,请在 Ad Manager 产品论坛中发帖提问。如果您遇到的是 API 方面的问题,请在 Ad Manager API 论坛中发帖提问。请参阅这篇博文中的提示,了解如何区分问题是属于产品层面的问题还是特定于 API 的问题。