Salesforce

HTML5 creative specifications

« Go Back
Information
HTML5 creative specifications
HTML5-creative-specifications
Details

Overview

This article explains:

  • how HTML5 creatives are structured
  • how HTML5 creatives have to be zipped to work in Equativ
  • which file formats can be used in HTML5 creatives
  • how the pricing works

Integration types

The table below indicates if this article is relevant for your type of integration with Equativ.
Integration typeRelevant_______Integration typeRelevant
Web integrations  Header bidding integrations 
smart.js library Prebid.js
AMP Prebid Server
Video integrations  Holistic+
Video plugin Managed Holistic+
Embedded Ad Manager Server to server integrations 
Standalone VAST requests POST Ad API
Connected TV GET Ad API
Addressable TV Server side bidding
Mobile in-app integrations    
In-app display SDK   
In-app in-stream SDK   

Inside the HTML5 creative

Here is a list of items you will find in most HTML5 creatives.

  • a main html file, typically named "index.html"
  • the assets: image files (e. g. png), video files (e. g. mp4) etc.
  • a css file
  • a javascript file

Keep in mind: If the HTML5 creative is served in a secure context, the HTML5 creative must load libraries (javascript file, css file, etc.) and any other resources with https. Check all the URLs inside the HTML5 creative and make sure that libraries and resources are called with https. Otherwise, browsers will issue a security warning and ad delivery will fail.

HTML5 zip file

Before you upload an HTML5 creative in Equativ's user interface, bundle it into a zip file following these rules:

  • name the main html file "index.html" (without the quote characters)
  • in the <head> of the "index.html" file, add the line <meta charset="UTF-8"> to allow for the reading of most special characters
  • place the index.html file into the root of the zip file (do not place it in a sub-folder)
  • place the assets into sub-folders or into the root of the zip file; if you choose sub-folders, do not compress them
  • only use assets used by the HTML5 creative; do not use "orphan" assets
  • keep the zip file as light as possible (read about best practices here)
  • the name of the zip file must not contain any dots (e. g. creative.test.zip is prohibited)
  • the name of the zip file must not contain any special (language-specific) characters: e. g. letters with accents (é à ê ï ñ ç) and special characters, such as ! ? ¿ ¡ @ # %, are not allowed
  • names of folders zipped inside the HTML5 creative must not contain any dots (e. g. test.folder/ is prohibited)
  • names of files zipped inside the HTML5 creative must not start with a dot
  • names of creative files must not start with a dot

File formats supported by Equativ

File formatFile name extension
HTML, CSS, Javascripthtml, css, js
Imagejpg, jpeg, png, gif
Video/Audio/Playlistmp4, m4v, wmv, m4a, avi, webm, 3gp, ogg, mp3, aac, ogv, m3u8*
Othertxt, zip, xml, woff, woff2
* the max. file size for videos is 50 MB - this allows for HD video ads with a duration of up to 30 seconds 
 

Keep in mind
Javascript libraries with the extension min.js (minified javascript) are not supported!


For HTML5 video assets, the most common formats are H.264/MP4 and VP8/WebM. At a minimum, an HTML5 video should be transcoded into these two formats. For more information about video formats, read the IAB's recommendation (page 18).

Maximum file size and pricing

For the maximum file size of the compressed zip file (including index.html, css, js, assets), there are two types of limits:

  • the maximum size the user interface allows you to upload; this limit is 50 MB
  • the maximum size of the uploaded zip-file without additional "heavy creative" pricing: please check in your contract with Equativ to see the maximum size and the additional charges for heavier creatives

Powered by