Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To minimize the chances of malicious creatives serving, we recommend activating SafeFrame whenever possible, in conjunction with the HTML5 sandbox attribute, to prevent top-level navigation. 

googletag.SafeFrameConfig 

Below is a configuration object for SafeFrame containers

Property Summary
allowOverlayExpansion

Whether SafeFrame should allow ad content to expand by overlaying page content

allowPushExpansion

Whether SafeFrame should allow ad content to expand by pushing page content

sandbox

Whether SafeFrame should use the HTML5 sandbox attribute to prevent top-level navigation without user interaction

useUniqueDomain

Deprecated. Whether SafeFrame should use randomized subdomains for reservation creatives


setSafeFrameConfig example based on JavaScript

Code Block
googletag.pubads().setForceSafeFrame(true);

const pageConfig = {
  allowOverlayExpansion: true,
  allowPushExpansion: true,
  sandbox: true,
};

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

// The following slot will not allow for expansion by overlay.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig(slotConfig)
  .addService(googletag.pubads());

// The following slot will inherit the page level settings, and hence
// would allow for expansion by overlay.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

...