Parallax (app)
Overview
Formerly named "SDK Parallax Banner" / "RTB+ SDK Parallax Banner". The "Parallax" creative template displays a piece of a background ad while the user is scrolling.
In case of iOS, this ad format can be used in UITableView and UICollectionView. Limitation when used in UIScrollView: the scrollview cannot be zoomed and the parallax effect does not apply when scrolling horizontally.
In case of Android, this ad format can be used with any "scrollable" views: ListView, RecyclerView, ScrollView, etc.
Most common sizes
Most common RTB sizes of this ad format: 300x250, 640x200, 320x480, 300x50, 320x100.
Demo
Parallax demo available in these apps:
Compliancy
| Criterion | Compliancy |
|---|---|
| MRAID 1.0 | ❌ |
| MRAID 2.0 | ❌ |
| RTB | ✅ |
Creatives
This section applies for the direct creative template only. The Parallax ad format works with one single creative, which is used for both portrait and landscape modes. This ad format is based on the aspect ratio: all creatives and parallax windows are resized according to the screen size.
Supported file formats:
- image
- creative script
- HTML5 (without interaction); Note: avoid using a large window (in height); otherwise, the user interaction may be caught by the creative instead of the structure of the app (this would break the scrolling process and lead to poor user experience)
- Keep in mind: MRAID creatives are not supported!
Recommended sizes:
- Smartphone: 50kb (max)
- Tablet: 100kb (max)
Creative size handling
Setting a creative size (in the creative's detail view in Equativ's user interface) is strongly recommended.
Creative size of image creatives
In case of image creatives, the image size specified in the user interface will be the reference to display the ad.
Creative size of creative script and HTML5 creatives
It is strongly recommended to specify an appropriate creative size. If the creative size is specified in the user interface, this size will be the reference to display the ad (like for image creatives).
If unspecified, Equativ will use the size specified for the format (note that a small format dimension (e. g. 320x50) will lead to a poor parallax effect). If the specified format size is 0x0, nothing will be displayed.
Setting a creative size is not required in case of responsive creatives; instead, make sure you enable the "Creative is responsive HTML" creative template parameter.
Parameters
| Parameters | Description | Default value |
|---|---|---|
| App link URL (iOS only)* | App URL that will be opened by the SDK instead of the creative click URL, if the app is available on the iOS device. The SDK will fall back on the creative click URL otherwise. | |
| Background color |
(for fixed image creative only) The color that will displayed under the creative if it does not fit the display area. |
#ffffff |
| Border color* |
(if borders are enabled) The border color of the parallax ad. |
#000000 |
| Border font color* |
(if borders are enabled) The font color for the text displayed on the top border. |
#ffffff |
| Border font size* |
(if borders are enabled) The font size for the text displayed on the top border. |
|
| Border height* |
(if borders are enabled) The height of the bottom border and the height of the text margin of the bottom border. |
|
| Border text* |
(if borders are enabled) The text displayed on the top border. |
|
| Borders enabled* | If enabled, a border is displayed on the top and on the bottom of the creative. | Disabled |
| Creative is responsive |
(for Fixed Parallax mode only) Enable this option if your creative is HTML responsive to have the parallax take the whole screen; this prevents the parallax from being displayed in the size of the format (e. g. a banner format sized 320x50) |
Disabled |
| Other parallax window height |
(only used when parallax window aspect ratio is set to "other") A custom height of the parallax window. |
|
| Other parallax window width |
(only used when parallax window aspect ratio is set to "other") A custom width of the parallax window. |
|
| Parallax mode |
fixed - the image is centered in the container depending on the parameter Image resize mode dynamic height - the image will adapt its scrolling speed to match the container height sticky top (SDK 7 only) ** - the image will stick to the top; SDK7 only sticky bottom (SDK 7 only) ** - the image will stick to the bottom; SDK7 only API-based parallax (SDK 7 only) - (for HTML creative only) the parallax scrolling is disabled, but the position of the parallax window is forwarded to the creative via the Parallax JS API; SDK7 only |
fixed |
| Parallax window aspect ratio | Window aspect ratio through which the parallax banner will be visible. | 32:5 (classic banner) |
| Redirect to third party (iOS only)* | disabled - the SDK will always attempt to open the creative click URL in-app (Safari modal, Store modal etc.) enabled - the SDK will always open the creative click URL outside the app (Safari, App Store, etc.) | Disabled |
| Resize policy for background image* |
(for fixed image creatives only) cover - the image width will match the device width; contain - the image will be resized to be contained in the screen (without modifying the aspect ratio); 100% - the image will be stretched to match both the device width and height |
cover |
| Third party impression pixels | Comma separated list of URLs that will be called when the impression is counted by the SDK. | |
| RTB options (only for the RTB template) | ||
| Acceptable sizes |
Acceptable creative sizes retrieved from RTB; format: comma-separated list of width*height pairs (no spaces). Example: 250*300,320*250 |
|
* SDK 7 only
** To get a nice parallax effect in case of the parallax modes "Sticky top" or "Sticky bottom", make sure you set the window size to match exactly the size of the zone you want to remain visible.
Limitations
- MRAID creatives are not supported
- When used in UIScrollView, the scrollview cannot be zoomed and the Parallax effect does not apply when scrolling horizontally.
- Creative rotation is not supported when different creative types are used in the insertion.
Known issues
n/a
Release notes
- 28-11-2018 - Add Display SDK7 compatibility; Improve MRAID support; Activate viewability tracking