Expandable

Table of Contents

Introduction

This is a highly customizable and very easy to use Expandable Single File template.

User experience

A user opens the webpage and sees the collapsed 300x250 banner in the placement. On click, the initial area of the banner expands left to 770x500. Once expanded, the banner can offer additional video or other rich media experience. The expanded banner accommodates a link to the predefined landing page. The ad maintains this size until “Close” button click. The ad expands as many times as the user clicks on the banner.

Creative assets

The following items are to be delivered by a creative agency:

  • An asset for 300x250 stage banner, that could be an image or HTML5 file. The banner can be adjusted to your custom size - just change the width and height of the banner in manifest.json file
  • Video player needs a MP4/WEBM/OGV format videos (it is recommended to have more than one video file type). Dimensions 636x264.
  • A 770x500 poster for the video, if there will be a video wall (the wall will be black before playing the video if no poster will be provided).
  • In case that browser is very old and doesn't support HTML5 the backup image (PNG/JPEG) is required (set in additional assets).
  • Banner assets containing manifest.json file and HTML file zipped together with images, scripts and other material.

NOTE: In order to use Adform components for HTML, it is necessary to define global preloadQueue array, where you push all the wanted components to preload before script execution and to load Adform.DHTML.js

INFO: Please refer to the Video Player component for more detailed information on component setup and behavior.

Manifest.json file

  • manifest.json file and HTML file should be in the root directory of the .zip file.
  • Manifest.json file should define the ad dimensions and the HTML file which is used as a banner source.
  • HTML file should include Adform HTML library which enables the banner to receive a clickTAG variable:
    <script src="https://s1.adform.net/banners/scripts/rmb/Adform.DHTML.js"></script>

Specifications

Audio

  • Available on user initiation only (click). Off by default.
  • Audio mute button or volume control required.
  • All audio must be muted or paused on click-through.

Video

  • Available on user initiation only (click). Off by default.
  • Stop/Pause and Play button controls required.
  • Video duration: 30 seconds max. Replay allowed with user initiation.

How to setup

  1. First, create a Floating HTML5 banner. In the *Initial Settings* step, name your banner, select Category as “Expandable” and Format as “Expandable (single file)”. Select a Banner Batch from the drop-down menu.
  2. When it's done, click the Next button.
  3. In the next step, you are asked to select or upload assets. If you have previously uploaded the assets to the system, click the Select button and choose Banner source, i.e. select HTML File named HTML_Expandable. Make sure that the clickTAG is present.

  4. NOTE: Additional assets should be assigned by default order:
    • Video poster goes as a first additional asset;
    • Video files ( MP4/WEBM/OGV formats) should be assigned below poster assets;
    • Backup image should be assigned as Backup Image via Banner Settings panel.

  5. Click the Next button and adjust the Settings:
  6. When done, click the Save button in order to see the preview. If everything is fine, click the Submit button.
Additional assets should be assigned by default order:

Additional info

In order to deliver HTML5 banners fully compliant with the specs, follow the instructions on Producing HTML5 banners in Adform Test and Support Center: http://test.adform.com/testpage/banner-specifications/

The Single-File Expanding ad requires an additional JS script to be added before the main tag for the website which contains (friendly) iFrames. The extension script can be added through Adform System. In order to do that, go to Tags section, select the necessary tag and click JavaScript URLs button. Paste the following script and tick the “Load before banner” check-box.

Custom JS code:
http://s1.adform.net/Banners/Elements/Files/12821/634709/booli_iframes_v1.js?bn=%%ADFTAGID%%

Supported Browsers

Desktop browser version
Internet Explorer 8 (and bellow) not supported (backup image)
Internet Explorer 9 fully supported
Internet Explorer 10 & 11 fully supported
Edge fully supported
Firefox (newest version) fully supported
Chrome (newest version) fully supported
Safari (newest version) fully supported

Tablet Operating System Browser
iOS 8.1 (and above) Safari & Chrome
Android 4.0 (and above) Native, Chrome & Firefox

Other