Contact support
    • Monetization
    • Monetize
    • Set up and manage inventory
    • Manage creative templates
    • Official creative template specifications
    • Display: Web template specifications

    Expand (1 creative)

    Table of Contents

    Overview Demo Compliancy Creatives Creative template parameters Features Supported browsers External functions for HTML5 creatives Limitations Known issues Release notes

    Overview

    Formerly named "Expand (1 creative)". The "Expand (1 creative)" creative template displays an ad that expands on mouse over or on click, using a single creative for both the collapsed and expanded states.

    Demo

    Expand (1 creative) demo

    Compliancy

    Criterion Compliancy
    Creative rotation

    ✅
    Friendly iFrame

    ✅
    IFrame buster

    ✅
    Multi-instance

    ✅
    Responsive web design

    ✅
    RTB

    ❌
    Viewability counting (MRC standard)

    ✅

    Creatives

    Supported file formats:

    • image (png, jpg, gif)
    • HTML5

    Creative template parameters

    Name Description Default value
    Background color Adds a background color to the page body. white
    Background image Adds a background image to the ad.  
    Background position Sets the background position. More information here.  
    Background repeat Repeat the background: repeat: the background image will be repeated both vertically and horizontally repeat-x: the background image will be repeated only horizontally repeat-y: the background image will be repeated only vertically no-repeat
    Collapsed height Height in the collapsed state in pixels.  
    Collapsed width Width in the collapsed state in pixels.  
    Display duration The ad is expanded for a defined number of seconds while the user loses focus. 0
    Expand direction Sets in which direction the ad should be expanded. left
    Expanding speed Specifies the speed of the animation (in seconds). 1
    Initial expand capping The number of times the creative will be expanded at the beginning. If you set -1, the ad is always expanded on the ad's load. 0
    On click expands Specifies if the ad should expand on click. false
    On load display duration Displays the expanded ad when the page loads for the defined number of seconds.  
    On mouse out collapses Specifies if the ad should collapse on mouse out. true
    On mouse over expands Specifies if the ad should expand on mouse over. true
    Pushdown If checked the ad unfolds down the site. Note: works only for the bottom and top directions. false
    Z-index The z-index property specifies the stack order of the ad. An element with greater stack order is always in front of an element with a lower stack order. 100

    Features

    The "Expand (1 creative)" displays an ad which will be extended during mouseover or on click.

    Supported browsers

    This ad format is compatible with all major browsers:

    • Chrome
    • Firefox
    • Safari
    • Opera
    • IE (8 and above)

     

    External functions for HTML5 creatives

    This creative template allows you to deliver multiple instances of the same template on the page. This causes difficulties in the communication when using a global function (expand and collapse). There are different functions defined for every instance on the page so you have to pass the format id in the function name, e.g.: pub_ist_expand_xxx(), pub_ist_collapse_xxx(), where xxx is the format id.

     

    HTML creatives

    For HTML5 creatives, you can use expand and collapse methods with a post message. Example of post message for expand button (communication between iframe and creative template):

    var expandButton = document.getElementById("id-of-expand-button");
expandButton.onclick = function(){
window.parent.postMessage("pub_ist_expand_xxx", "*");
}

    Example of post message for collapse button (communication between iframe and template):

    var collapseButton = document.getElementById("id-of-collapse-button");
collapseButton.onclick = function(){
window.parent.postMessage("pub_ist_collapse_xxx", "*");
}

    Keep in mind:

    If you wish to control the expand and collapse from the creative level you must uncheck these options in the creative template parameters:

    • On mouse over expands
    • On mouse out collapses
    • On click expands

     

    Limitations

    n/a

    Known issues

    n/a

    Release notes

    • 05-03-2025 - Update for action pixels generation
    • 26-09-2023 - Improved impression counting
    • 17-04-2023 - Update sas-libs version to 1.1 and remove document.write from the EMP template
    • 28-05-2018 - Fix for html5 click counting
    • 27-03-2018 - Fix for hasAd (Smart Adserver library function)
    • 07-02-2018 - Additional RTB parameters in viewability log
    • 04-01-2018 - Enable viewability counting by default
    • 13-09-2017 - Add tagID compatibility
    • 12-09-2017 - Add viewability module
    • 16-08-2017 - Support for standalone tag
    • 10-07-2017 - Fix for expanding/collapsing animation

    RELATED ARTICLES