Side Bar

Table of Contents

Introduction

This is a highly customizable and very easy to use animated Side Bar template for Desktop non responsive sites.

User experience

User opens a webpage and on the right screen side sees a responsive ad banner. When the user scales the website in or out, the ad responsively covers the predefined area. The ad can offer additional video or other rich media experience. It accommodates a link to the predefined landing page.

Creative assets

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

  • Video player needs a MP4/WEBM format videos.
  • A 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: manifest.json file and HTML file should be in the root directory of the .zip file.

Customizing the banner

The file “index.html” can be adjusted to customize the banner components.

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

These are the values that can be changed:

  • clicktag - banner's / video player's landing page landing page;
  • video - setting different video parameters;
  • poster - video poster. By default, it uses second additional asset assigned through Additional assets panel.
  • %%ADFTAGID%% - this is a macro that needs to be there at all times.
  • compoundSeqNo - Sync banner's compound sequence number (optional).
  • target - id of the element to which the sidebar should be sticked. Instead of element id, a ClassName or TagName can also be used for this parameter, but then, the 'selector' and 'index' parameters should be used too.
  • selector - specifies how to get the 'target' element. Available values: 'id', 'class', 'tag' (default 'id').
  • index - if 'class' or 'tag' selector is used, this parameter specifies which member to select (default 0).
  • sticky - specifies if sidebar should be 'sticky' - Available values 'false' or '0' to disable stickyness (default true - enabled).
  • maxWidth - specifies max width of the sidebar (for example 'maxWidth=300;').
  • maxHeight- specifies max height of the sidebar (for example 'maxHeight=600;').
  • ar - specifies if banner aspect ratio should be maintained when the banner is scaled (by default is disabled, specify 'ar=1;' to enable this feature).
  • top, left, right, bottom - specifies custom sidebar position (example: 'top=0px;right=0px;').
  • publisher - specifies for which network/publisher extension is used. A number of publishers specify list of domains for which to apply custom configuration.

Currently available publishers

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

Manifest.json 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.
  • Maximum volume level must be reasonable and user friendly.
  • “Mute” or "Volume control" button is required.

Video

  • Available on user initiation only.
  • Video duration: 30 seconds max. Replay allowed with user initiation.
  • “Close” button is required.

How to setup

  1. In the Initial Settings step, name your banner, select Category as “Adhesion” and Format as “Side Bar”. 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_Side_bar. Make sure that the clickTAG is present.

  4. NOTE: Additional assets should be assigned by default order:
    • Video files (MP4/WEBM formats) go as first additional assets;
    • Video poster should be assigned below video files.

  5. Click the Next button.
  6. Adjust the Settings:
  7. When done, click the Save button in order to see the preview. If everything is fine, click the Submit button.

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 format requires an additional script to be loaded before the tag. In order to do that, navigate to the “Tags” section in the Adform system. Select the needed tag and click the “JavaScriptURLS” button. Paste in the following script URL and tick the “Load before banner” check-box.

Custom Script URL:
http://s1.adform.net/Banners/scripts/extensions/Adhesion_SideBar.js?bn=%%ADFTAGID%%;publisher=bauer;

Supported Browsers

Browser version
Internet Explorer 8 (and bellow) not supported
Internet Explorer 9 limited animation
Internet Explorer 10 & 11 fully supported
Edge fully supported
Firefox (newest version) fully supported
Chrome (newest version) fully supported
Safari (newest version) fully supported

Other

  • For technical questions write: technical@adform.com;
  • For traffic questions: traffic@adform.com;
  • For format certifications: certifications@adform.com;
  • For more details about format production: please contact our local office.