Rivista: Responsive Ad - Google DFP

Responsive Ad - Google DFP

  • The Responsive Ad - Google DFP module allows Publishers to easily create and deploy advertisements on their site that use Google's Dart for Publishers (DFP).
  • This module has optional settings that allow the Publisher to control when ads are displayed based on the screen size available. This is useful for Publishers using a responsive theme such as the Rivista 5 theme. Note that this module can be used to create non-responsive ad modules as well, simply by leaving out the optional Maximum and Minimum Screen Width parameters.

Before Making Your Ad

  • Before making Google DFP ads, you must configure your Rivista application with the Network Code from your Google DFP account.  You can obtain this from your Google DFP account.
  • If you want to set this for all publications in the site, you can add this code in Network Settings under the Admin tab in Google's DFP interface.
  • Enter this code into Rivista under the Administration tab in the DFP Network Code field.
  • If you have different Google DFP accounts associated with different Publications within Rivista, you can set the Network Code for a specific Publication in the Publication Manager, under the Configuration Options for that Publication.

Creating Your Ad Module In Rivista

Figure 3: Content Manager where Responsive Ad - Google DFP ad modules are created

To make a Responsive Ad - Google DFP module follow these steps:

  1. Go to Content Manager (Figure 3-A).
  2. Create a new Content Module (Figure 3-B).
  3. In the list, select Responsive Ad - Google DFP module.
Figure 4: Content Manager where Responsive Ad - Google DFP ad objects are created
  • Title: The name of the module in Rivista.
  • Category: How object is categorized to make it easier to find in internal Rivista tools. It has no user-facing effect.
  • ID Name: Not used.
  • Published: Sets publication status of ad.
  • Notes: Allows administrators to make internal notes about ad object.
  • HTML ID: Not required. You can use this field to assign an ID to your ad object so it can show up in markup language. Each class must start with a letter and may not include a space.
  • HTML Class Name(s): Not required. Use this field to set CSS class for your module.
  • Ad Slot Name: This is the name of the Ad Slot. Required. Example: "Square_300x250". You can obtain this from your Google DFP interface.
  • Ad Width: Required. The width, in pixels, of the ad. Example: "300".
  • Ad Height: Required. The height, in pixels, of the ad. Example: "250".
  • Template: Set to module.rad_dfp.default.tpl.
  • Maximum Screen Width: Optional. The maximum screen width at which the ad should render. Values should be an integer, and represent a pixel value.
    Minimum Screen Width: Optional. The minimum screen width at which the ad should render. Values should be an integer, and represent a pixel value.
    • Maximum and minimum screen widths may be supplied to control whether or not the ad is loaded and rendered. Note that this determination is made when the page is rendered. So, if a browser on a desktop has a small width - below the minimum screen width parameter, and then, after the page renders, the user scales up their browser, the ad will not appear. In the converse situation, where a user has a large enough window to render the ad, but then, after the page renders, the user scales down their browser, the ad will disappear, as it will be hidden by CSS. It is not expected that the typical user will scale up and down their browser after rendering a page, however.
  • Include The "Advertisement" caption?


Google DFP Custom Targeting With Ad Categories

Google DFP custom targeting can also be utilized with Rivista using the Ad Categories built into Rivista. To do so:

  • You can use the default Ad Categories in Rivista, edit these, or create new ones. The Ad Categories editor can be found under the Publishing Tab in the left-hand menu.
  • Create a Custom Targeting key in Google DFP, under the Inventory tab. This key must be named "category".
  • Create values for this key that correspond to the names defined in your Ad Categories in Rivista. Note that Rivista will modify the names of Ad Categories before sending them to the Google DFP script. Names will be modified in the following way: The name will be converted to all lower-case. Ampersands - "&" - will be converted to the word "and". All non-alphanumeric characters will be converted to and underscore, including spaces. Example: Your Ad Category in Rivista is "Restaurants & Bars". It will be output to Google DFP as "restaurants_and_bars". This is what you will add as a value to your "category" key in Google DFP's interface.
  • Tag your Rivista pages with the corresponding Ad Category in the Page Editor and Article Editor interface.
  • Once these steps have been taken, you will be add custom targeting criteria to your line items in Google DFP, and these will be in effect on pages tagged with the corresponding Ad Category in Rivista.
Have more questions? Submit a request


Powered by Zendesk