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 |
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.
- To access the Adhesion format template in Ad Builder, click Template Gallery from the Ad Builder Welcome screen.
- Click the Format tab. You should be able to find Adhesion format from the template list.
- 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.
- Adhesion is served from 1x1 banner and you don't have to edit anything in 1x1 banner.
- 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.
- Go to Ad Settings on platform.
- Do required updates if any.
- Save the ad.
- Create a new placement for the ad.
- 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 Script Notice:
Since the Interstitial format is a HTML5 Custom Format, there is no need to attach a custom script since the appropriate one will be pulled in automatically. For reference, the following custom script is being used:
PL_AdBuilderAdhesion.js
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.
- Go to Ad Settings on platform.
- Do required updates if any.
- Save the ad.
- Create a new placement for the ad.
- 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 Script Notice:
Since the Interstitial format is a HTML5 Custom Format, there is no need to attach a custom script since the appropriate one will be pulled in automatically. For reference, the following custom script is being used:
PL_AdBuilderAdhesion.js
Custom Variables
Variable Name |
Type |
Description |
Default Value |
|
String |
Name of the banner panel. |
banner |
|
Integer |
Name of the expand panel. |
expand |
|
Boolean |
Decides if the banner will need to be hidden while user scroll the publisher page. |
Yes |
|
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 |
|
Number |
The z-index of the eye div. |
2147483647 |
|
Boolean |
Set ad to load with domain configuration. |
No |
|
String |
Path to the folder of the settings files, not including protocol |
//services.serving-sys.com/programmatic/DomainList/ |
|
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 |
|
Sent when user click the close icon on the top right corner. |
|
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
Notice
The information contained in this document is proprietary and confidential to Sizmek and/or any of its affiliated companies. Disclosure, copying, reproduction, storing or any use of this document or any part thereof without the express prior, written consent of Sizmek or its authorized representatives is strictly prohibited. The information furnished in this document is believed to be accurate and reliable. However no responsibility is assumed by Sizmek for the use of this information. Sizmek reserves the right to make changes to the information included in this document at any time and without notice.
Copyright © 2017 Sizmek. All rights reserved.
Comments