Google Publisher Console

You can use the Google Publisher Console to inspect ad delivery on pages that use the Google Publisher Tag (GPT) library, so that you can troubleshoot ad loading issues and optimize the performance of your page. This guide explains how to access and use the Publisher Console.

Access the console

You can access the Publisher Console from your browser on any page that uses GPT. There are three ways to access the Publisher Console:

JavaScript console
From the JavaScript console in your browser’s developer tools, run: googletag.openConsole()
JavaScript bookmark

Create a new bookmark for the Publisher Console by dragging the following button to your bookmarks bar:

You can then click the bookmark from any page that includes GPT to load the Publisher Console.

URL query parameters

Add ?google_console=1 to the end of the URL of any page that includes GPT. For example, http://www.example.com?google_console=1

After accessing the Publisher Console on a page, you can use the keyboard shortcut Ctrl+F10 (or fn+control+F10 on a Mac) to show or hide it.

Use the console

The Publisher Console has two tabs: Ad Slots and Page Request. Buttons to audit the page with Publisher Ads Audits for Lighthouse and troubleshoot delivery issues with Ad Manager Delivery Tools are also provided.

Ad overlays

The publisher console adds an overlay to every ad slot registered with GPT. Each overlay contains information about the ad currently loaded in that slot, and a link to view detailed delivery data in Ad Manager Delivery Tools.

Publisher console ad overlay screenshot

Field Description
Ad source The source of the returned ad. Possible values:

  • Direct Sold: Reserved Inventory.
  • Dynamic Allocation Sold: Non-reserved inventory.
  • Empty: The ad slot has not been filled by GPT.
Ad unit path The path to the ad unit, including the parent ad unit path. The name of the displayed ad unit appears on the line below the parent path.
Ad container The ID of the <div> element the ad has been rendered into.
Creative The ID of the Ad Manager creative that was returned. Clicking on this value will open the creative in Ad Manager.
Line Item The ID of the Ad Manager line item to which the returned creative is associated. Clicking on this value will open the line item in Ad Manager.

Ad Slots tab

The ad slots tab contains detailed information about every ad slot currently registered with GPT. Information is organized into cards, with one card displayed per ad slot. Links to view the ad unit, creative, and delivery diagnostics for the returned ad in Ad Manager are also provided.

Publisher console ad slots tab screenshot

Field Description
Ad unit path The path to the ad unit, including the parent ad unit path. The name of the displayed ad unit appears on the line below the parent path.
Div The ID of the <div> element the ad has been rendered into.
Slot size The size of the ad slot (pixel width x pixel height), as specified in the ad tag definition. For more information on slot sizes, see Supported ad sizes.
Out of Page Indicates whether the ad unit displays an out of-the-page creative, such as for pop-up, pop-under, or floating ads. For more information, see Serve out-of-page creatives. Possible values:

  • True
  • False
Service The service used to serve the ad. GPT only supports Ad Manager.
Overlay status Indicates whether the ad slot has an associated Publisher Console overlay. Ad slots that do not have overlays may not be included in the DOM or may be out-of-page slots. Possible values:

  • Displayed
  • Not Displayed
ms to fetch The amount of time, in milliseconds, that it took to fetch the ad from Ad Manager.
Ad fetch count The number of times the ad was fetched since the page was opened, including ad refreshes.
Iframe type The type of Iframe within the creative was rendered. For more information on IFrame types, see Render creatives using SafeFrame. Possible values:

  • FriendlyIframe
  • SafeFrame
Line Item ID The ID of the Ad Manager line item to which the returned creative is associated.
Creative ID The ID of the Ad Manager creative that was returned.
Query ID The ID of the query that returned this ad unit. Your Technical Account Manager (TAM) can use this ID to troubleshoot issues with the displayed creative.

Page Request tab

The page request tab provides general information about the page and the environment in which it is rendered, warnings encountered, and a timeline of ad events.

Publisher console page request tab screenshot

Field Description
URL The URL of the current page.
Browser The user agent string of the browser used to load the page.
Browser viewport width and height The current browser viewport dimensions (pixel width x pixel height).
Property Code The network code, which is a unique, numeric identifier for the Ad Manager network that the ad unit belongs to. For more information, see Find Ad Manager account information.
ms to fetch ads The amount of time, in milliseconds, that it took to fetch all of the GPT ads on the page from Ad Manager.
ms to render ads The amount of time, in milliseconds, that it took to render all of the GPT ads on the page, after the creatives were returned from Ad Manager.

Timeline

The Timeline section of the Page Request tab lists a chronological sequence of events for each GPT ad displayed on the page, from creating the ad slot to rendering the ad. The timeline also includes any warnings or errors returned while requesting or displaying the ad.