Follow

DFP Premium Initial Set-up

Summary

Publishers on the Tempest licensing model may use their own ad server with their Tempest site. Below outlines standard DFP integration based on the Tempest internal DFP setup. This allows for seamless translation of Tempest features (such as ad configuration) and CMS metadata into your ad server.

This page describes in detail the standard DFP integration for publishers using their own DFP instance. We provide a powerful set of targeting options out of the box. For these to be available, the publisher must set up their DFP account as described here.

DFP Ad Unit Hierarchy

In site configuration set "DFP" as the Ad Server to enable the third-party DFP Premium set up. Provide the DFP Account ID to your Site Producer.

Publishers with a DFP Premium instance will have the following Ad Unit hierarchy:

Level One

  • Code: Primary Domain (e.g. www.biography.com, cupcakesandcashmere.com)
  • Name: Site Name (e.g. Biography, Cupcakes & Cashmere)

Level Two

  • Code: Section Code (e.g. fashion, diy, homepage)
  • Name: Section Name (e.g. Fashion, DIY, Homepage)

NOTE on Homepage Section: For ease of use with targeting and reporting we treat the Homepage as a section, with the code "homepage". Although this is not a standard section in the CMS, being able to easily target the homepage can be very useful.

Ad Sizes

Tempest supports multi-size ad requests for the following standard sizes and ad types:

  • 300x250
  • 300x600
  • 320x50
  • 728x90
  • 970x250
  • 970x90

We also support Out-of-page requests for interstitials. At this time, Tempest does not fully support video.

Sizes per Page Type and Ad Zone

The three most common Page Types are Hub Pages (e.g. the homepage or a section hub page), Article pages (the general term "Detail Page" refers to single pieces of content, like articles or recipes) and Gallery pages.

Ad Zones are regions within pages that have their own unique behavior, logic, ad sizes, and configuration options. For the most part Ad Zones are the same on all page types, but there are a few exceptions:

  • The "In Card" Ad Zone is specific to card stream components in size C, which are typically on Hub pages (though sometimes appear below content on Article pages).
  • The "In Content" Ad Zone refers to any horizontal ad break within a page. In most cases this Ad Zone supports one or two 300x250 ads, but on Hub pages in size C it supports a single wider ad (e.g. 728x90).
  • Gallery pages have their own set of Ad Zones and do not include Out-of-page requests.

Tempest uses the following breakpoints, which change the eligible ad sizes:

  • Size A: less than 680 px wide
  • Size B: 680 px wide to 1023 px wide
  • Size C: 1024 px wide and greater
Ad Zone
Breakpoints
Sizes
Sidebar C 300x600
Interstitial A, B, C Out-of-page
In Content (Hub) A 300x250
In Content (Article) A 300x250
In Card C 300x250
Header A 320x50
Gallery Top A 320x50
Gallery Sidebar C 300x600
Gallery Interstitial A, B, C 300x250
  B 728x90
  C 728x90, 970x90, 970x250
  B 300x250 x2
  C 728x90, 970x90, 970x250
  B 300x250 x2
  C 300x250 x2
  B, C 728x90
 
Key Values

Tempest automatically provides many key-values for more advanced ad targeting. Key values must be set up exactly as described in this document to work properly. Do add key values select "Inventory" from the DFP menu and select "Key-values" from the left-hand side bar. Use the "New Key" button to define a new set of key values.

Page Type

It is fine to leave out any page types which are not used by the site. For example, a site may not have any recipes.

Use the following configuration for setting up the Page Type key values.

  • Name: pagetype
  • Display name: Page Type
  • Values type: Predefined (Users will select from predefined targeting values.)

Add the page types which are used by the site. When you select  "Add values" input the targeting values. You can later specify a display name for each value.

Targeting Value
Display Name
article Article
basicpage Basic Page
gallery Gallery
homepage Homepage
recipe Recipe
richterm Rich Term Hub
section Section Hub
userprofile User Profile
hub Misc Hub

Ad Zone

It is fine to leave out any ad zones which are not used by the site. For example, a site may not have the header ad zone enabled.

Use the following configuration for setting up the Ad Zone key values.

  • Name: adzone
  • Display name: Ad Zone
  • Values type: Predefined (Users will select from predefined targeting values.)

Add the ad zones which are used by the site. When you select  "Add values" input the targeting values. You can later specify a display name for each value.

Targeting Value
Display Name
header Header
in_card In Card
in_content In Content
sidebar Sidebar
gallery_top Gallery Top
gallery_interstitial Gallery Interstitial
gallery_sidebar Gallery Sidebar
interstitial

Interstitial

Ad Index

Within an Ad Zone each ad slot is sequentially numbered from top to bottom starting with 0. The Ad Index can be used for targeting and reporting to distinguish particular ad slots. Ads are numbered within an Ad Zone to make targeting and reporting regular and predictable, since the ordering of ads varies from page to page depending on the content. Additionally, it's possible to enable, disable and change the frequency of ads. You may not be able to predict which ad slot will be the second on a page overall, but you know that the first sidebar ad is always a 300x600.

Use the following configuration for setting up the Ad Index key values.

  • Name: adindex
  • Display Name: Ad Index
  • Values type: Predefined (Users will select from predefined targeting values.)

When you select  "Add values" input integers from 0 to 20 (e.g. 0, 1, 2 ...). You can add as many as you need, but around 20 is typically sufficient. 

Channel

The channel key-value is used to target ads to AMP pages and Instant Articles.

Use the following configuration for setting up the Channel key values.

  • Name: channel
  • Display name: Channel
  • Values type: Predefined (Users will select from predefined targeting values.)

When you select  "Add values" input the targeting values. You can later specify a display name for each value.

Targeting Value
Display Name
amp AMP
fbia Facebook Instant Articles
web Web

Rich Terms

Rich terms set in the CMS are available for targeting in the ad server. A common use-case is sponsoring a custom group of articles. Some sites also use rich term hubs in their nav bar, instead of section hubs. An article can be tagged with multiple rich terms. Note that for targeting in DFP any special characters are removed. You can read more about this in the DFP documentation for key-value targeting under the "Format key names and values" heading.

Use the following configuration for setting up the Rich Terms key values.

  • Name: terms
  • Display Name: Rich Terms
  • Values type: Free-form (Users will enter targeting values when creating line items or checking inventory.)

You do not need to pre-populate free-form key-values. They will be added automatically when used for targeting or forecasting. Rich term key-values are targeted exactly as they appear in the CMS, and may include spaces.

URL Path

URL path targeting makes it very easy to target any page on your site, which can be useful for sponsorships, as well as testing. Note that the page path begins with the "/" character (for example, “/2016/04/21/example-article”).

Use the following configuration for setting up the Rich Terms key values.

  • Name: path
  • Display Name: URL Path
  • Values type: Free-form (Users will enter targeting values when creating line items or checking inventory.)

You do not need to pre-populate free-form key-values. They will be added automatically when used for targeting or forecasting.

Referrer

You can target users coming to your site by common social and search referrers with the Referrer key-value target. Tempest detects and adds the common referral sources listed below to DFP targeting.

Use the following configuration for setting up the Rich Terms key values.

  • Name: referrer
  • Display name: Referrer
  • Values type: Predefined (Users will select from predefined targeting values.)
Targeting Value
Display Name
bing.com Bing
facebook.com Facebook
google.com Google
google.ca Google CA
google.co.uk Google UK
pinterest.com Pinterest
t.co Twitter
search.yahoo.com Yahoo

Note that the Facebook target includes the various subdomains of facebook.com such as www.facebook.com and m.facebook.com.

Custom Functionality

Site Skin

Tempest sites are able to support site skins on desktop. These are served as a 1x2 ad request with a large site skin image creative targeted to the 1x2 size.

The site skin ad format is an image creative with the size 1720x1500. This creative is targeted to the skin ad slot using override targeting, since the creative size is different from the ad slot size.

This feature is not enabled by default.

Suppressing Ad Slots

Serving a blank creative with the size 7x7 into an ad slot will trigger custom logic within Tempest to remove the ad zone from the page so that it collapses, rather than appears blank, or fills with another ad. This is used primarily when roadblocks or sponsorships don’t support all of the available ad sizes on a page.

Note: the In Card ad zone cannot be collapsed.

Mature Content Flag

The "m" rich term can be applied to any content which you want to flag as Mature. This triggers special functionality to remove all ads from the page to avoid issues with ads appearing on content which is not brand-safe.

 
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk