控制广告加载和刷新

在我们的使用入门示例和基本概念示例中，Google 发布商代码使用 (GPT) 库的 display() 方法注册并显示广告位但有时最好或甚至必要来分隔这些操作，精确地控制何时加载广告内容。例如，使用意见征求管理平台或出于用户意愿而请求广告内容操作。

在本指南中，我们将探索 GPT 提供的机制，以控制广告内容的加载并按需提取新广告内容。完整代码基于事件的请求示例网页。

控制广告加载

默认情况下，display() 方法的行为是在广告位中注册、请求和呈现广告内容。您可以使用 PubAdsService.disableInitialLoad() 方法停用自动请求和呈现广告内容。

停用初始加载后，调用 display() 将仅注册广告位。在进行第二项操作之前，不会加载任何广告内容。这样，您就可以从而精确控制何时发出广告请求

为避免发出意外的广告请求，必须调用 disableInitialLoad() 和调用 display() 之前。

<!doctype html>
<html>
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <meta name="description" content="Request GPT ads based on events." />
    <title>Event-based ad requests</title>
    <script
      async
      src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"
      crossorigin="anonymous"
    ></script>
    <script>
      window.googletag = window.googletag || { cmd: [] };

      googletag.cmd.push(() => {
        // Define the ad slot.
        googletag
          .defineSlot("/6355419/Travel", [728, 90], "div-for-slot")
          .setTargeting("test", "event")
          .addService(googletag.pubads());

        // Disable initial load.
        // This prevents GPT from automatically fetching ads when display is called.
        googletag.pubads().disableInitialLoad();
        googletag.enableServices();
      });
    </script>
    <style></style>
  </head>
  <body>
    <div id="div-for-slot" style="width: 300px; height: 250px"></div>
    <script>
      googletag.cmd.push(() => {
        // Register the ad slot.
        // An ad will not be fetched until refresh is called.
        googletag.display("div-for-slot");
      });
    </script>
  </body>
</html>

在本例中，系统会停用初始加载，以确保不会发出任何广告请求并且调用 display() 时不会呈现任何广告内容。槽已就绪接受并展示广告，但要等到广告位展示时，刷新。

刷新

PubAdsService.refresh() 方法用于使用新的广告内容填充一个或多个广告位。此方法可用于尚未加载任何内容（由于 disableInitialLoad()）的槽，或用于替换已填充的槽的内容。不过，只有可以刷新。display()

<!doctype html>
<html>
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <meta name="description" content="Request GPT ads based on events." />
    <title>Event-based ad requests</title>
    <script
      async
      src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"
      crossorigin="anonymous"
    ></script>
    <script>
      window.googletag = window.googletag || { cmd: [] };

      googletag.cmd.push(() => {
        // Define the ad slot.
        googletag
          .defineSlot("/6355419/Travel", [728, 90], "div-for-slot")
          .setTargeting("test", "event")
          .addService(googletag.pubads());

        // Disable initial load.
        // This prevents GPT from automatically fetching ads when display is called.
        googletag.pubads().disableInitialLoad();
        googletag.enableServices();
      });
    </script>
    <style></style>
  </head>
  <body>
    <div id="div-for-slot" style="width: 300px; height: 250px"></div>
    <button id="showAdButton">Show/Refresh Ad</button>
    <script>
      googletag.cmd.push(() => {
        // Register the ad slot.
        // An ad will not be fetched until refresh is called.
        googletag.display("div-for-slot");

        // Register click event handler.
        document.getElementById("showAdButton").addEventListener("click", () => {
          googletag.cmd.push(() => {
            googletag.pubads().refresh();
          });
        });
      });
    </script>
  </body>
</html>

在此修改后的示例中，当用户点击“显示/刷新广告”按钮时按钮，系统会调用 refresh() 方法。这会触发获取新广告内容的请求并将其加载到已注册的槽中，从而覆盖任何预先存在的内容。

请注意，在前面的示例中，调用了 refresh() 方法时未使用参数，这相当于刷新所有已注册的广告位。不过，您还可以通过传递传递给 refresh() 方法。如需查看相关示例，请参阅刷新广告展示位置示例。

最佳做法

在使用 refresh() 时，应遵循一些最佳实践。

不要过快刷新。

如果广告位刷新太快，可能会导致您的广告请求受限。为避免这种情况，请避免每 30 秒刷新一次以上。
请勿不必要地调用 clear()

刷新广告位时，请勿先调用 PubAdsService.clear()。这不必要，因为无论之前是否加载了任何广告内容，refresh() 都会替换指定槽位的内容。立即拨打 clear() 在调用 refresh() 之前，只会增加空白槽时间对相应用户可见

仅刷新可见的广告位

使用 refresh() 替换永远无法展示的广告位的内容，可以显著降低 ActiveView 展示次数占比。通过 ImpressionViewableEvent 可用于确定广告位何时可见，示例：

googletag.cmd.push(function() {
  var REFRESH_KEY = 'refresh';
  var REFRESH_VALUE = 'true';

  googletag.defineSlot('/6355419/Travel',[728, 90], 'div-for-slot')
      .setTargeting(REFRESH_KEY, REFRESH_VALUE)
      .setTargeting('test', 'event')
      .addService(googletag.pubads());

  // Number of seconds to wait after the slot becomes viewable.
  var SECONDS_TO_WAIT_AFTER_VIEWABILITY = 60;

  googletag.pubads().addEventListener('impressionViewable', function(event) {
    var slot = event.slot;
    if (slot.getTargeting(REFRESH_KEY).indexOf(REFRESH_VALUE) > -1) {
      setTimeout(function() {
        googletag.pubads().refresh([slot]);
      }, SECONDS_TO_WAIT_AFTER_VIEWABILITY * 1000);
    }
  });

  googletag.enableServices();
});