Introduction

Overview

The Adhesion is an ad format that continually adheres to the bottom of the display while the user scrolls through the page. The Adhesion is an upgrade to the Sizmek format “IAB Mobile Adhesion” and expands the support matrix to cover the desktop in addition to tablet and mobile devices.  This format should be used in lieu of “IAB Mobile Adhesion” going forward.

The Ad Builder - Adhesion is the Ad Builder version of the Adhesion. The workspace version is a separate custom format and has added functionality that can be found by referencing the table below. If interested please check the workspace's build guide. Workspace templates give you greater flexibility to adapt the code and program additional customizations while Ad Builder templates provide ease of use. The templates available within these alternate environments may be slightly different, so make sure you use the one based on your needs. The different templates are described below, but check back frequently since new templates are expected to be added.

Ad Builder Templates

There are four flavors of the Adhesion format that are currently available on Ad Builder - Basic Mobile Banner, Basic Desktop Banner, Basic Mobile Expandable, and Basic Desktop Expandable.

Template Name	Video	Banner Dimension	Banner Panel Dimension	Expand Panel Dimension
Adhesion Basic Mobile Banner	No	1x1	320x50	n/a
Adhesion Basic Mobile Expandable	Yes	1x1	320x50	Full Screen with 300x250 overlay
Adhesion Basic Desktop Banner	No	1x1	728x90	n/a
Adhesion Basic Desktop Expandable	Yes	1x1	728x90	Full Screen with 600x600 overlay

The Basic Mobile Banner and Basic Mobile Expandable are design for small screen like mobile phone with banner only and expandable options. The Basic Desktop Banner and Basic Desktop Expandable are design for large screen such as desktop and tablet with banner only and expandable options. Unlike the Workspace version, the expandable will display a fixed size (300x250 for mobile, 600x600 for desktop) overlay centered in a full screen lightbox. The illustrations below show you the Basic Mobile Banner and Basic Mobile Expandable.

Basic Mobile Banner

 

Basic Mobile Expandable (collapsed)	Basic Mobile Expandable (expanded)

The templates available may be slightly different, Below table shows functionality difference between different Ad Builder templates and workspace templates 

Adhesion Functionality	Ad Builder	Workspace
Full width banner	❌	✓
Option to use MRAID default close button	✓*	✓**
Responsive full-screen panel, Panel content resize on browser resize.	❌	✓
Restrict page scroll when full-screen panel is expanded	✓	✓
Sizmek Advertising Suite Support	✓	✓

* via Ad Settings from Ad Builder

** via Custom JS Var mdEnableSDKDefaultCloseButton.

This format includes a fully “domain configurable” / "Liquid Framework" solution. For more information on the domain configurable formats in general, and how to preview the different certified settings, please see Domain Config Solution for Custom Formats

Demos

The following table provides links to the demos for the Adhesion format.

Demo	Desktop Banner Mobile Expandable Desktop Expandable

Supported Platforms

Platform	Supported Versions
Windows	Internet Explorer 10+, Microsoft Edge, Firefox, Chrome, Safari
Mac	Safari, Firefox, Chrome
iPhone	iOS 9.0 and later
iPad	iOS 9.0 and later
Android	Android 6.0 and later (including Tablet)

Note: This format supports in App function such as expand and video playing, however, the adhesion function may or may not work properly depends on the design of the App.

Format Properties

Listed below are common properties available to the format.

Feature	Supported
Polite Loading	✓
Safeframe Support	❌
MRAID (in APP Support)	✓
AdKit-ready	✓
Liquid Framework (One-Tag Solution)	✓
Secure Serving	✓
Sizmek Advertising Suite Support	✓
Workspace Template Available	✓

 

Implementing Adhesion using Ad Builder

Setting up new ad in Ad Builder

Adhesion format is available on Ad Builder.

1. To access the Adhesion format template in Ad Builder, click Template Gallery from the Ad Builder Welcome screen.
   
2. Click the Format tab. You should be able to find Adhesion format from the template list.
3. To create a new ad, simply select a template and then click Create. The new ad will start with the template you selected. The left section of Ad Builder show default panel and banner.
4. Adhesion is served from 1x1 banner and you don't have to edit anything in 1x1 banner.
5. Select one of the panels appearing below 1x1 banner to edit. You can edit panel by changing, removing, or adding components based on your requirements. After you done with editing, you can click on Save to save the ad to Sizmek platform and preview your ad. 

Customizing the Adhesion in Ad Builder

You may remove or replace any existing component in the template with your own creative assets. However, there are some things you need to be aware of:

• Removing the video: If you wish to remove the video component, please make sure you go to the Actions & Animations for each button and remove ”Pause: video-container” action from Tap/Click event.
• Changing the close button: With Ad Builder, you should be able to style your own close button by using component Properties, but if you are removing the close button that come with the template and adding your own close button, please make sure you go to the Actions & Animations and add the following action to Tap/Click event.
• Expandable – Collapse, and select a panel target (banner, expand, or the other name if you have made change to the panel name).
  If your ad contains video, it is recommended to add the following action prior to the Collapse action so the video can be paused when the panel collapses. Normally we will also make the Collapse action start 200ms after the Pause action.
• Video Action – Pause, and select a video target (video-container or the one you create)

Restrictions & Important Notes

• The auto expand and frequency capping option from ad settings on MDX platform is not working properly with the ad builder templates, please avoid to use those options.

Setting up Adhesion on the Sizmek Platform

Setting Adhesion on MDX2.0 Platform

Once you have saved the ad to the platform, you can now use the settings from the Platform to setup your ad.

1. Go to Ad Settings on platform.
2. Do required updates if any.
3. Save the ad.
4. Create a new placement for the ad.
5. Fill out the form. Set the Placement type to In Banner and the Banner size to 1x1.
   After you’ve saved your placement, you can then generate preview tags to test on your web site.

Setting Adhesion in Sizmek Advertising Suite

Once you have saved the ad to the platform, you can now use the settings from the Platform to setup your ad.

1. Go to Ad Settings on platform.
2. Do required updates if any.
3. Save the ad.
4. Create a new placement for the ad.
5. Fill out the form. Set the Placement type to In Banner and the Banner size to 1x1.
   After you’ve saved your placement, you can then generate preview tags to test on your web site.

Custom Variables

Variable Name	Type	Description	Default Value
mdBannerPanelName	String	Name of the banner panel.	banner
mdExpandPanelName	Integer	Name of the expand panel.	expand
mdHideBannerOnUserScroll	Boolean	Decides if the banner will need to be hidden while user scroll the publisher page.	Yes
mdRestrictPageScrollWhenExpand	Boolean	Decides if user be able to scroll the publisher page while the ad expanded. Note: User may still be able to scroll on some devices, but our ad will try to scroll the page back to the previous position when the ad expands. Alternatively if using the banner template, the ad will scroll to the top of the page on ad load; you can set the value of this variable to "No" to cancel scrolling to the top of the page on ad load.	Yes
mdEyeDivZIndex	Number	The z-index of the eye div.	2147483647
mdIsDomainConfigEnabled	Boolean	Set ad to load with domain configuration.	No
mdProgSettingsFolderPath	String	Path to the folder of the settings files, not including protocol	//services.serving-sys.com/programmatic/DomainList/
mdAutoRepositionInterval	Number	Repositions all panels every N milliseconds. if set to 0, automatic repositioning is disabled.	0
mdBackupImgPath	String	Relative path to the backup image, if a custom image is desired. This allows a fallback experience to display an image that is not a 1x1 even though the tag is a 1x1 tag. For example, if this custom var were set to "images/300x250_Default.jpg," then a file would attempt to be loaded from the images folder. You must be sure this file exists in the workspace. When set to undefined, the normal 1x1 fallback occurs.	undefined
mdParentLevelsToResize	Integer	This variable is only used when the ad is serving a default image. When set to any value over 0, this number of publisher parent elements of our tag will be resized to the default image size, if they are smaller than the default image serving.	0

Reported Custom Interactions

Besides the standard HTML5 ad interactions, the following are the custom interactions reported by this format and can be reviewed in Sizmek reporting.

Custom Interactions	Description
closeAd	Sent when user click the close icon on the top right corner.
UserAction	Send when user click the UserAction button.

Known Issues

• The video may not play full screen in native video player, the full screen video will plays within the full browser instead.
• The page may zoomed out when rotate the device on Native Android browser on some Android 4.x devices.
• On IE11 panel may shift from left to center during page resize.
• When using the Adhesion Desktop formats and the Mobile Expandable, users cannot upload assets without saving the ad first. It also does not display format image in the template gallery.

 

Change Log

January 8, 2018 (v 1.3.0)

• Created new custom format "Ad Builder - Adhesion" only for Ad Builder template. "Adhesion" support workspace only.
• Ad Builder template re-created under new format name "Ad Builder - Adhesion"
• Expandable template, Banner panel will not collapse completely instead the visibility is changed when full screen panel expand or collapse.
• Added full MRAID support.
• Workspace related custom variable has been removed

September 12, 2017

• Custom format renamed from HTML5 Adhesion to Adhesion
• Ad Builder templates re-released with new custom format name.

July 17, 2017 (v 1.2.0)

• Updated to support the liquid framework.
• Modified interaction tracking - previously interactions were coming from the banner, but since banner was a 1x1 that was never displayed, all interactions are now assigned to the panel that is acting as the banner.
• Fixed issue where the page would incorrectly snap back to the top if the user put in a delay when showing the adhesion banner or if the user had to scroll the page to see the adhesion banner.

Feburary 2, 2017

• Released Ad Builder templates in Sizmek Advertising Suite

July 6, 2016 (v 1.1.0)

• Add Ad Builder templates on MDX2.0 Platform
• Support polite loading