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:
- The No column displays the id of the format.
- The Format column shows the name of the format and its dimensions.
- TheTemplate 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
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 disabled 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.
The Template files screen lists all templates that are available within your account.
The Template files screen presents a table with three columns:
- The Format columns shows the name of the template.
- The Used in Position types column shows the position types in which the template is used.
- 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.
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 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, at the next publish cycle.
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.
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:
- Enter branch name or Git hash to use (eg. origin/master)
- Press checkout button
The specified git commit will be checked out. All the template changes will be applied in the next publish phase.
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. firstname.lastname@example.org:adhese/my_template_repo.git)
We will send you our public ssh key, to be added to your git configuration and 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 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:
- The No column displays the id of the position type.
- The Position type column shows the name of the position type.
- 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.