Skip to content

Latest commit

 

History

History
139 lines (100 loc) · 4.34 KB

doubleclick.md

File metadata and controls

139 lines (100 loc) · 4.34 KB

Doubleclick

Example

Basic

<amp-ad width=320 height=50
    type="doubleclick"
    data-slot="/4119129/mobile_ad_banner">
</amp-ad>

With additional targeting

<amp-ad width=320 height=50
    type="doubleclick"
    data-slot="/4119129/mobile_ad_banner"
    json='{"targeting":{"sport":["rugby","cricket"]},"categoryExclusions":["health"],"tagForChildDirectedTreatment":1}'>
</amp-ad>

Configuration

For semantics of configuration, please see ad network documentation.

Ad size

By default the ad size is based on the width and height attributes of the amp-ad tag. In order to explicitly request different ad dimensions from those values, pass the attributes data-override-width and data-override-height to the ad.

Example:

<amp-ad width=320 height=50
    data-override-width=111
    data-override-height=222
    type="doubleclick"
    data-slot="/4119129/mobile_ad_banner">
</amp-ad>

Multi-size Ad

To request an ad with multiple sizes, pass a string of comma-separated sizes to the data-multi-size attribute. Each size in the list must be a width followed by a lowercase 'x' followed by a height. Secondary sizes must not be larger than their corresponding dimensions specified by the width and height attributes, or the data-override-width and data-override-height attributes, if they are set. Further, the secondary sizes must not be smaller than 2/3rds of their primary size counterpart, unless data-multi-size-validation is explicitly set to false.

Examples:

With multi-size request

<amp-ad width=728 height=90
    type="doubleclick"
    data-slot="/6355419/Travel"
    data-multi-size="700x90,700x60,500x60">
</amp-ad>

With multi-size request ignoring size validation

<amp-ad width=728 height=90
    type="doubleclick"
    data-slot="/6355419/Travel"
    data-multi-size="300x25"
    data-multi-size-validation="false">
</amp-ad>

Supported parameters

  • data-slot
  • data-multi-size
  • data-multi-size-validation

Supported via json attribute:

  • categoryExclusions
  • cookieOptions
  • tagForChildDirectedTreatment
  • targeting
  • useSameDomainRenderingUntilDeprecated

Temporary use of useSameDomainRenderingUntilDeprecated

An experiment to use the higher performance GPT Light tag in place of the DoubleClick GPT tag causes the ad to render in a second cross domain iframe within the outer AMP iframe. This prevents ads from accessing the iframe sandbox information and methods which are provided by the AMP runtime. Until this API is available to work in the second level iframe, publishers can opt out of this experiment by including "useSameDomainRenderingUntilDeprecated": 1 as a json attribute. This attribute will be deprecated once the new window.context implementation is complete. After that point, the GPT Light tag will become the default and all eligible ads will always be rendered inside a second cross domain iframe.

Example:

<amp-ad width=320 height=50
    type="doubleclick"
    data-slot="/4119129/mobile_ad_banner"
    json='{"useSameDomainRenderingUntilDeprecated":1}'>
</amp-ad>

Unsupported DFP Features & Formats

Unsupported Features:

  • Guaranteed Roadblocks. Non-guaranteed roadblocks (As many as possible, One or More) delivery is supported

Unsupported Formats/Creatives:

  • Interstitials
  • Expandables. Although expandables on interaction/click is a format that is work in progress.
  • Flash
  • Anchor Ads / Adhesion Units
  • Creatives served over HTTP.

DFP Implementation Examples

This website has a list of implementation examples with source code that showcase DFP features.