回传代码

借助 Google 发布商代码 (GPT) 库,您可以生成具备回传功能的广告代码。只要发送至第三方的广告请求最终应由在您自己的 Google Ad Manager 广告联盟中投放管理的广告填充时,就可以使用这样的代码。

使用场景

投放补余订单项或后备订单项

当第三方服务器没有可以投放的广告,或相关广告不符合与第三方商定的最低每千次展示费用/底价要求时,即可使用回传代码。在这种情况下,第三方服务器将改为投放 GPT 回传代码,该代码会返回您自己的 Ad Manager 广告联盟中的自家广告或其他补余广告

在其他发布商的网站上投放广告

回传代码可用于在其他发布商的网站上投放您 Ad Manager 广告资源网的广告。在这种情况下,GPT 回传代码将由其他发布商投放,并会返回您自己的 Ad Manager 广告联盟中的广告。

投放视频广告

如要创建视频广告回传代码,请使用标准视频广告代码从第三方回传到 Ad Manager。

您可以手动构建此代码,也可以使用 Ad Manager 视频广告代码生成器构建此代码。

构建回传代码

您可以使用与构建常规 GPT 广告代码相同的 API 来构建回传代码。不过,回传代码必须在 iframe 内呈现,以防止它们沿用发布商网站上任何其他有效 GPT 实例的网页级设置。

下一部分展示了一个基本的回传代码。请注意,此 fragment 旨在 iframe 内呈现。如需查看实际效果,您可以在 StackBlitz 上试用此示例的实时演示

<script src="https://securepubads.g.doubleclick.net/tag/js/gpt.js" crossorigin="anonymous" async></script>
<div id="gpt-passback">
  <script>
    window.googletag = window.googletag || {cmd: []};
    googletag.cmd.push(function() {
        googletag.defineSlot('/6355419/Travel/Europe', [728, 90], 'gpt-passback')
          .addService(googletag.pubads());
        googletag.enableServices();
        googletag.display('gpt-passback');
    });
  </script>
</div>

配置回传代码

回传代码支持 GPT 代码可用的正常功能范围,例如键值定位指南代码示例中介绍的功能。以下部分将介绍仅适用于回传代码的特性,或在回传情境中使用时需要特殊配置的特性。

启用点击跟踪

如需向回传代码添加点击跟踪,可将点击后到达网址宏附加到该代码,如以下示例所示。此点击后到达网址宏会动态添加为 Ad Manager 广告服务器上存储的点击后到达网址的前缀。

<script src="https://securepubads.g.doubleclick.net/tag/js/gpt.js" crossorigin="anonymous" async></script>
<div id="gpt-passback">
  <script>
    window.googletag = window.googletag || {cmd: []};
    googletag.cmd.push(function() {
        googletag.defineSlot('/6355419/Travel/Europe', [728, 90], 'gpt-passback')
          .addService(googletag.pubads())
          .setClickUrl('%%CLICK_URL_UNESC%%');
        googletag.enableServices();
        googletag.display('gpt-passback');
    });
  </script>
</div>

继承隐私设置

由于回传代码是在 iframe 中呈现的,因此它们不会自动继承在网页级配置的隐私权设置。如果使用回传来将广告从一个 Ad Manager 发布商投放给另一个发布商,则可以使用 TFCD 宏在回传广告请求中包含当前网页级“面向儿童的内容”处理设置。

<script src="https://securepubads.g.doubleclick.net/tag/js/gpt.js" crossorigin="anonymous" async></script>
<div id="gpt-passback">
  <script>
    window.googletag = window.googletag || {cmd: []};
    googletag.cmd.push(function() {
        googletag.defineSlot('/6355419/Travel/Europe', [728, 90], 'gpt-passback')
          .addService(googletag.pubads())
        googletag.pubads()
          .setPrivacySettings({childDirectedTreatment: Boolean('%%TFCD%%')});
        googletag.enableServices();
        googletag.display('gpt-passback');
    });
  </script>
</div>

管理子发布商的广告资源

多客户管理 (MCM) 是一项 Ad Manager 功能,可让您访问其他发布商委托给您账号的广告请求。如需了解详情,请参阅多客户管理简介

若要使用 MCM,必须更新父级发布商的回传代码,使其包含子发布商的 Ad Manager 广告资源网代码。这样一来,Ad Manager 就能识别子发布商广告资源网,并有助于验证广告素材是否正确投放。

<script src="https://securepubads.g.doubleclick.net/tag/js/gpt.js" crossorigin="anonymous" async></script>
<div id="gpt-passback">
  <script>
    window.googletag = window.googletag || {cmd: []};
    googletag.cmd.push(function() {
        googletag.defineSlot('/6355419,1234/Travel/Europe', [728, 90], 'gpt-passback')
          .addService(googletag.pubads())
        googletag.enableServices();
        googletag.display('gpt-passback');
    });
  </script>
</div>

在上述示例中,6355419 是父发布商的 Ad Manager 广告资源网代码,1234 是子发布商的广告资源网代码。

指定网页网址

由于回传代码是在 iframe 中呈现的,因此 GPT 可能无法确定投放代码的网页的网址。如果您使用 Ad Exchange 或 AdSense 来填充回传展示,则在没有网页网址的情况下,这些系统无法将网页的相关背景信息发送给买方。这会导致填充率或每千次展示费用降低,在某些情况下,还会导致广告请求遭拒。

为避免这种情况,您可以使用 PATTERN 宏向第三方广告联盟或广告服务器提供网页网址信息。然后,您可以将此信息作为 page_url 属性添加到回传代码中。

<script src="https://securepubads.g.doubleclick.net/tag/js/gpt.js" crossorigin="anonymous" async></script>
<div id="gpt-passback">
  <script>
    window.googletag = window.googletag || {cmd: []};
    googletag.cmd.push(function() {
        googletag.defineSlot('/6355419/Travel/Europe', [728, 90], 'gpt-passback')
          .addService(googletag.pubads());
        googletag.pubads().set('page_url', 'URL');
        googletag.enableServices();
        googletag.display('gpt-passback');
    });
  </script>
</div>