Search
Clear search
Close search
Google apps
Main menu

GPT request and rendering modes

Google Publisher Tags offer flexibility in how you request ads from DFP and then render those ads on your page. Developers can view example tags to learn how to enable each mode in your code.

Request modes

Single request architecture (5:54)

  • Single request architecture (SRA): All ad requests for a page view are sent to DFP at one time from the header of your content, which can improve your page’s loading speed and makes it possible to guarantee roadblocks. All DFP creative types and line item types are supported by SRA, except DoubleClick Rich Media Dynamic ads. This is the recommended request mode.
  • Multi-request: Each ad request defined is sent to DFP separately from the body of your content. Unlike with SRA, multi-request tags do not guarantee roadblocks. This is the default request mode. Learn more about how DFP connects multiple requests for a page view

Rendering modes

Asynchronous and synchronous rendering (4:21)

  • Asynchronous: Allows your content and ads to load independently, instead of loading content and ads together in sequence. Each ad renders within an iframe that’s reserved on the page until the ad is ready to display. If a creative is slow in loading, your content does not need to wait. This is the recommended rendering mode.
  • Synchronous: Loads ads in sequence with the rest of your content. Each ad renders directly on the page, rather than in an iframe, which can be useful for prestitials or passbacks but also slows your page’s loading time. 
Important limitations of synchronous rendering mode
  • Video companion display is not supported.
  • Cannot dynamically refresh ad slots with the pubService.refresh(slots) method.
  • Might significantly slow down your webpages or affect mobile ad serving. Learn more

Mixing asynchronous and synchronous ad tags in the same web page is not recommended. You can use asynchronous tags on some pages of your website and synchronous tags on others, but avoid combining these rendering modes on the same page.

Combine SRA and asynchronous rendering mode for best performance
This combination offers the best page load experience and the ability to serve guaranteed roadblocks or competitive exclusions.

SafeFrames and friendly iframes

SafeFrame is a cross-domain iframe that enables transparent and rich interactions between page content and ads, while preventing ads from accessing publisher data. We recommend using SafeFrames and creatives compatible with SafeFrame for expansion instead of friendly iframes. Learn more about rendering creatives using SafeFrame

SafeFrame is supported in DFP and enabled by default when using Google Publisher Tags. Reservations serve into SafeFrames by default, but you can disable this setting at the creative level and use friendly iframes instead, if needed. Ad Exchange line items from dynamic allocation also serve into SafeFrames by default for security reasons, but this setting is not configurable.

Some creatives, such as expandable ads or creatives that access your page’s DOM elements, might not render correctly in SafeFrames or other cross-domain iframes. We recommend updating these creatives to make them SafeFrame-compatible, in order to retain SafeFrame’s security benefits. If this is absolutely not an option, there are a few things you can do to allow reservation ads of this type to render properly:

Was this article helpful?
How can we improve it?