Live issues

Override creative settings for Rich Media ads

Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. There are many reasons to customize an ad's creative settings, such as setting different properties for a single creative so that it serves in one position on your home page and in another position on other site pages.

Once you insert key-value pairs into ad tags, you can use a preview URL to view how creatives will be served with your overrides applied to them. (See also Customize settings in ad tags.)

Valid key-values for overriding creative settings

The table below describes valid key-value pairs that you can use to override creative settings for a Rich Media ad when you traffic it. When you insert key-value pairs in ad tags, you must use the format key=value.

Key-value Description
ad_container_id=value Lets you specify the <div> that the Rich Media unit is served in. The <div> would otherwise be in a different location on the publisher page from where a DFA tag is served.
breakoutinpage=true Makes In-page creatives break out of iframes like Expanding and Floating creatives.
hideApplets=value Lets you display or hide Java applets in the same web page where a Rich Media ad is being served. This key-value controls Java applets outside of a Rich Media ad, not within the Rich Media ad. Default is false.

Note: You can only override this creative setting for Floating and Expandable creatives. For Expandable creatives the setting only applies when the ad is expanded.
hideObjects=value Lets you display or hide Flash objects in the same web page where a Rich Media ad is being served. This key-value controls Flash objects outside of a Rich Media ad, not within the Rich Media ad. Default is false.

Note: You can only override this creative setting for Floating and Expandable creatives. For Expandable creatives the setting only applies when the ad is expanded.
mtfIFPath=path of the DARTIFrame.html file in the publisher's web server Path must start and end with / character.
mtfDuration=value Lets you specify the amount of time during a visit, in seconds, that the Floating or Overlay creative runs in a web page. Uses auto, none, or positive integer.

Note: You can only override this creative setting for Floating or Overlay creatives.
mtfLeft=value

Lets you specify the distance of the Floating or Overlay ad, in pixels or as a percentage, from the left edge of a web page in a browser window. Uses values from -1500 to 1500 as px, pct, or pxc.

Notes

  • You can only override this value for Floating or Overlay creatives.
  • For ads with Floating or Overlay creatives, you can append px, pct, or pxc after the integer to specify whether the positioning is determined by pixels or as a percentage.
  • For example, if you use the key-value mtfLeft=40pct, the Floating ad is displayed a distance of 40 percent from the left edge of the web page in a user's browser window.
  • If you do not specify px, pct, or pxc after the integer, pixels are the unit of measure by default.
mtfTop=value

Lets you specify the distance of a Floating or Overlay ad, in pixels or as a percentage, from the top edge of a web page in a browser window. Uses values from -1500 to 1500 as px, pct, or pxc.

Notes

  • You can only override this value for Floating or Overlay creatives.
  • For ads with Floating creatives, you can append px or pct after the integer to specify whether the positioning is determined by pixels or as a percentage.
  • For example, if you use the key-value mtfTop=40pct, the Floating ad is displayed a distance of 40 percent below the top edge of the web page in the user's browser window.
  • If you do not specify px or pct after the integer, pixels are the unit of measure by default.
wmode=value Lets you specify the wmode setting of a Rich Media ad. wmode=transparent, opaque, or window. For Floating creatives only. Ignored if used in other creative type.

Example of overriding creative settings with key-values: A DFA trafficker has specified the following creative settings for a Rich Media ad:

  • the ad is positioned 50 pixels from the top edge of the page
  • the ad is positioned 50 pixels from the left edge of the page
  • the ad runs for 20 seconds
  • the ad's wmode is set to transparent
  • the Flash objects are hidden
  • the Java applets are displayed.

Based on these creative settings, you obtain an ad tag for the ad that looks like this:

http://ad.doubleclick.net/adi/N270.maheshdfasite/B3140338.2;dcopt=1_ist;sz=0x0;ord=[timestamp]?

After you obtain the ad tag you decide that you want to override the DFA trafficker's creative settings so that:

  • the ad is positioned to be 60 pixels from the top edge of the web page
  • the ad is positioned to be 10 percent from the left edge of the web page
  • the ad runs for 30 seconds
  • the ad's wmode is opaque
  • the Flash objects are displayed
  • the Java applets are hidden.

To do this, override the creative settings in the ad tag like this:

http://ad.doubleclick.net/adi/N270.maheshdfasite/B3140338.2;dcopt=1_ist;mtfTop=60;mtfLeft=10pct;mtfDuration=30;wmode=Opaque;hideObjects=false;hideApplets=true;sz=0x0;ord=[timestamp]?

Reminder asset override key-values

Key-value Description
mtfAdjustOverflow=true Prompts the ad to adjust the CSS style from overflow:hidden or overflow:auto to overflow:visible on divs containing the ad. This allows the expanded area of a Rich Media ad to be visible in scenarios where the publisher CSS would otherwise prevent the expanded area from being visible.
mtfBody=relative In rare instances, the body of a web page will have the style position:relative, which may cause a floating ad to appear in the wrong location. Add the mtfBody key-value to the ad tag to make the ad appear in the correct location.
mtfIframeRequest=false Tells a Rich Media ad not to attempt to break out of the iframe. This is useful when the ad is running, for example, on a site that is contained entirely in an iframe.
mtfImp = value Tracking interstitial impressions, certain publishers need to pass a URL on the DoubleClick ad tags that's called when the ad is displayed and when the /imp call is made. Because the URL is dynamic for the publisher, the publisher must specify it in the tags.
mtfInline=true/false For fixing expanding ad style="display:inline" in Firefox. Default is false.
mtfRenderFloatInplace=true/false Positions an ad relative to the ad container specified in a tag. Default is false. If it's set to true, the ad's div appends to its container div, not to the page, and calculation of the ad's position starts at the top-left corner of the container. This applies to Floating, Multi-floating, and In-page with Floating formats.

Example

http://ad.doubleclick.net/parkaypreview?creativeid=1234567siteurl=http://www.msn.commtfTop=300;mtfLeft=250;wmode=transparent; mtfImp=http://www.espn.com;mtfDuration=20;mtfIFPath=/doubleclick/