+1 
google dfp premium default

Note: This block is used with:
Marketplace / Banner Ads
Design / Blocks

Note:  This block template will automatically generate the HTML and JavaScript necessary to integrate ad Google DFP (DoubleClick for Publishers) ad units on a page.

Note:  Please see Google's Online Documentation for more information on how to gather your ad units and sizes which are required for this block. 


Best Practice - It is recommended that when positioning DFP Ads on your site that you position the smaller Ads at the top working towards larger ones at the bottom. The purpose is because if the larger ad is first, then the width of the ad space is reserved going down the page, thus creating white space on your site.

Note: DFP Ads cannot be used with Email Reach (Newsletters) setup due to javascript.



Note: This block is available as the following Block Type: Static


Ads: Google DFP (Premium) - Appearance Properties

+1 
ads google dfp premium dfp dropdown
Property Description
Block title Sets the title of the block, visible on website.
DFP
Network Code This identifies your DFP network setup.
Include Domain This includes the domain name of the site after the Network Code in the Ad Unit.
Include the URLMap path

This determines the URL Map entry associated with the current URL, and inludes the path in the ad unit. This works by the Ad Unit includes the URL (and possible sub-URLs). These blocks identify the URL they're sitting on, and use that URL as part of the overall Ad Unit it expects to match from DFP. These blocks rely on the requirement that the DFP Ad Unit is formatted as a URL (ie: domain.com/news).

This is also where block inheritance comes in. So for example, if this block is placed on the homepage and inherits through the rest of the site, when viewing the block on the homepage, the Ad Unit would be: /1234/domain.com/homepage

  • The same block (which inherits from the homepage) on news, the ad unit would be: /1234/domain.com/news
  • The same block (which inherits from the homepage) on sports, the ad unit would be: /1234/domain.com/sports
    • Example DFP code generated: <data-dfp-adunit="/1234/domain.com/news">
Include an Index/HomePage Slug Includes an indicator to the ad unit that identifies index pages (home page) uniquely from asset pages. (Rarely used) If you had the need to serve separate ads on an index page or homepage, you can use this to add the necessary slug to the end of your ad unit. So for example, if you have the need to serve an ad on /sports, but a completely separate ad on sports' sub-URLs (ie. /sports/baseball, /sports/basketball, etc.), then you could use this slug in a block to add "index" to the end of the ad unit, identifying the /sports URL Example DFP code generated: <data-dfp-adunit="/1234/domain.com/news/index">.
Sizes This sets the Ad Slot creative size or sizes.
Include a Custom Targeting Keyword (POS) This adds to the Ad Unit a Custom Targeting parameter, named POS, that can be used to uniquely target this Ad Slot Position on the page.
Always Load This will override the CSS visibility check for this ad slot so that it will always be filled with an ad form the ad server. This means that this ad will always generate impressions regardless of whether or not it is visible when the page is loaded. This behavior is needed, for example, in cases where ads will be placed behind a hidden navigation item that will show on mouse hover.
Audience Targeting
Hide From Audience (comma separated list) Hide this block to users in the provided audience list. This feature requires participation in our TownNews iQ and our TownNews Content Exchange programs. Audience lists are found in the Developer Console Logs. For more information, contact your Regional Sales Representative.
CSS Class
CSS Class Allows you to use a CSS Class to style the block and/or show/hide the block based on device sizes - ie: hidden-lg (hides on desktop) visible-sm (visible on smart phone)
Template
Template Information A description of the block template
Edit/Change Template Allows you to edit or change the block template

Network Code

The Network code identifies your DFP setup. You can find it by looking at the URL of the DFP admin console: https://www.google.com/dfp/{NetworkCode}#delivery . The Network code is used in the first part of the ad unit: /{NetworkCode} . 

The network code is located in the upper right side in Google DFP. 

Include Domain

Include the domain name of the site right after the Network Code in the ad unit. /{NetworkCode}[/{Domain}]


Best Practice: We recommend setting this custom property to True.


Best Practice: In order to make sure the Include Domain custom property works smoothly in all cases, we recommend adding the domain to Design > Blocks, in the Page customizations panel, in the Advertising dropdown. For more information on this custom property and its location, please see the Page Customizations documentation.


To find the domain, go to Inventory 1, and choose Ad Units 2 from the column on the left side. 

The domain is located before the / on any given ad unit. 

Include the URL Map path

This determines the URL Map entry associated with the current URL, and inludes the path in the ad unit. This works by the Ad Unit includes the URL (and possible sub-URLs). These blocks identify the URL they're sitting on, and use that URL as part of the overall Ad Unit it expects to match from DFP. These blocks rely on the requirement that the DFP Ad Unit is formatted as a URL (ie: domain.com/news).

This is also where block inheritance comes in. So for example, if this block is placed on the homepage and inherits through the rest of the site, when viewing the block on the homepage, the Ad Unit would be: /1234/domain.com/homepage

  • The same block (which inherits from the homepage) on news, the ad unit would be: /1234/domain.com/news
  • The same block (which inherits from the homepage) on sports, the ad unit would be: /1234/domain.com/sports
    • Example DFP code generated: <data-dfp-adunit="/1234/domain.com/news">

    Best Practice: We recommend setting this custom property to True.


Include a Index/HomePage Slug

Includes an indicator to the ad unit that identifies index pages (home page) uniquely from asset pages. (Rarely used) If you had the need to serve separate ads on an index page or homepage, you can use this to add the necessary slug to the end of your ad unit. So for example, if you have the need to serve an ad on /sports, but a completely separate ad on sports' sub-URLs (ie. /sports/baseball, /sports/basketball, etc.), then you could use this slug in a block to add "index" to the end of the ad unit, identifying the /sports URL Example DFP code generated: <data-dfp-adunit="/1234/domain.com/news/index">


Best Practice: We recommend turning this on for future use, even if you are not selling ads exclusive to section pages currently. 


Sizes

This property sets the ad slot creative size or sizes, which will be used to set the creative sizes that will be eligible to serve to this ad slot. A single ad size would use the syntax: [width, height]. Indicate multiple sizes using the syntax: [[width1, height1],[width2, height2],[width3, height3]].

The size value is an absolute value. In order to make responsive, you should create multiple blocks with differently sized ads and use Bootstrap classes to hide and show those blocks based on the viewport. For more information on Bootstrap classes, please see Bootstrap documentation.

Include a Custom Targeting Keyword (POS)

Adds to this ad unit a Custom Targeting parameter, named pos, that can be used to uniquely target this ad slot position on the page. 

Always Load

This will override the CSS visibility check for this ad slot so that it will always be filled with an ad form the ad server. This means that this ad will always generate impressions regardless of whether or not it is visible when the page is loaded. This behavior is needed, for example, in cases where ads will be placed behind a hidden navigation item that will show on mouse hover.

The options are False or True