Page tree
Skip to end of metadata
Go to start of metadata

Formats

A format defines the conditions of an ad creative, such as its file size and dimensions.

The Formats screen lists all available formats.

The Formats screen consists of a table with three columns:

  1. The No column displays the ID of the format.
  2. The Format column shows the name of the format and its dimensions.
  3. The Template file column shows the template file that belongs to the format.

To create a new format, click the Create a format button. 

To edit a format, click the name of the format you wish to modify or use the edit icon

Template files

Adhese does not restrict advertising to the use of IAB Standard Formats only. The Adhese templates solution makes it possible to wrap more complex creatives (for example, an overlayer, takeover, or floor ad) because of advanced functionalities by using, for example, JavaScript, HTML and CSS. 

There are two ways of managing templates: either directly through the Admin UI or your own Git repository. UI management is not available when you use the Git repository (recommended for advanced users with many complex templates). It can only be used for read-only consultation of the existing templates. The content and features of templates do not differ for each approach.

UI Managed templates

When using the UI for managing templates, you can edit the files directly through the text editor on the screen. 

Changes in a template or advar template will be applied to all creatives using the updated templates at the next publishing cycle.

Format Templates

The Template files screen lists all templates that are available within your account. 

The Template files screen presents a table with three columns:

  1. The Format column shows the name of the template.
  2. The Used in Position types column shows the position types in which the template is active.
  3. The Used in Formats column lists the formats in which the template is running.

To create a new template, click the Create a template button.

To edit a template, click the name of the template file you wish to modify. 

Advar templates

Adhese introduced its own template format: Advar. Advar templates are pre-defined creatives consisting of Javascript, CSS, custom JSON objects etc. The result of Advar templates is pre-made ads, such as a text ad including a small image.

The Advar templates screen lists all available Advar templates. 

The Advar templates screen lists the name of the Advar template in the Format column

To create a new Advar template, click the Create an advar template button.

To edit an Advar template, click the name of the Advar you wish to modify. 

HTML5 templates

Here you can store your HTML5 templates for immediate and future use. When you click the link, the following screen appears:

HTML5 template screen - click for larger view

The following options are available:

  • Upload a new file: click the Upload a new HTML5 template file (ZIP) and choose a file to upload.
  • Delete a template: select the file and click the delete button.
  • Filter the list by typing in the filter box.

You can find the above HTML5 templates in the creative screens under Add Advar.

Position types

Position types add extra functionalities to a position. The main purpose of a position type is to define the MIME type of the response and the possible templates wrapped around the output.

The Position types screen lists all available position types. 

The Position types screen presents a table with three columns:

  1. The No column displays the ID of the position type.
  2. The Position type column shows the name of the position type.
  3. The Template column shows the template that belongs to the position type.

To create a new position type, click the Create a new position type button.

To edit a position type, click the name of the position type you want to modify or use the edit icon

Template Repository

Template Repository lets you control Template Files and Advar Templates with a Git version control system. Once this option is active, you can keep your templates in your own version control system, keep a detailed history of your changes, and easily switch between different versions of your templates. You edit your templates in the IDE of your choice and only checkout a branch in your Adhese account.

Changes in the checked-out version on your Adhese account will be applied to all creatives using the updated templates with the next publish.

Directory Structure

The main directory of your repository should contain all templates. Filename extensions are not obligatory, but we do recommend using .txt for readability. You can also add a directory named fi. "advar_templates" that contains all Advar template files and their description files (.descr). The name of the directory will be added to your Adhese configuration.

Advar Templates always consist of two files. When creating Advar templates, you should always include a second file with the same name but with a .descr extension. If you have a template called "advertorial.txt", the 2nd filename should be "advertorial.txt.descr". The second file contents are needed for rendering the UI Form through which users will fill out the actual creative.

Usage

The Template Repository screen shows two panels. On the left, you can see a summary of the Git commits currently used. It contains the Git hash, the branch, and the date and message when it was committed. On the right, you see a text field and button to change the commit for checkout:

  1. Enter branch name or Git hash to use (e.g. origin/master) 
  2. Press Checkout button

The specified Git commit will be checked out. All the template changes will be applied in the next publish phase.

Activation

To activate this option, please get in touch with our Support department. You will also need to provide the following information:

  • the URL of your Git repository, this needs to be accessible from the outside (e.g. git@github.com:adhese/my_template_repo.git)

We will send you the public ssh key that you need to add to your Git configuration to allow us access to the repository you would like to use for managing your templates. If you use Github, add this as an ssh key to Your Repo > Settings > Deploy Keys.


  • No labels