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 or the edit icon of the format you wish to edit. 

Managing template files

Adhese does not restrict advertising to the use of IAB Standard Formats only. The Adhese templates solution makes it possible to wrap creatives that are more complex (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 via your own Git repository. When you use the Git repository (recommended for advanced users with many complex templates), the UI management is not available and can only be used for read-only consultation of the active templates. The contents 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 screen. 

Changes in a template or advar template will be applied to all creatives using the updated templates, at the next publish 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 columns shows the name of the template.
  2. The Used in Position types column shows the position types in which the template is used.
  3. The Used in Formats column lists the formats in which the template is used.

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 edit. 

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 are 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. 

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 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 simply 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 to use .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 contents of the second file 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 commit currently used. It contains the Git hash, the branch and commit date and message. 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 (eg. 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 contact our Support departement. You will also need to provide the following information:

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

We will send you our 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, you should add this as an ssh key to Your Repo > Settings > Deploy Keys.

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 or the edit icon of the position type you want to edit. 

  • No labels