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.)
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.
||Lets you specify the
||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.|
||Makes In-page creatives break out of iframes like Expanding and Floating creatives.|
||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.
||Path must start and end with / character.|
||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.
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.
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.
||Lets you specify the wmode setting of a rich media ad.
Example of overriding creative settings with key-values: A DCM 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:
After you obtain the ad tag you decide that you want to override the DCM 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:
||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.|