7.2.21.1 Creation of Ad Creative Templates and Variables
Challenge
This article explains the basics of how to make an Ad Creative Template and highlights the steps needed to set up Ad Creative Template Variables.
Solution
In order to set up the Creative Upload in ADvendio, Ad Creative Templates are required. Those templates control, which fields and settings will be available in the Creative Upload UI and thus which information your Sales Reps will be able to see.
Additionally, you can determine which Campaign Items, and which Creative Templates are available. This helps you for example to make sure to only use Print creatives for your Print Campaign Items and similar.
Underneath each Ad Creative Template in ADvendio, there are Template Variables, which can configure which fields are visible in the Creative Upload Screen.
The ADvendio Creative Data Model
Here is an overview of the data model and what it means:
ADvendio Object | Description |
|---|---|
Ad Creative | The actual creative that will be uploaded to an advertiser and will be connected with a Campaign Item |
Campaign Item | Represents the Line Item |
Creative Assignments | ADvendio assigns Creatives to Campaign Items to ensure the creative connection to the campaign |
Ad Creative Template | The Creative Template to be used |
Ad Creative Template Variable | The fixed settings and fields which are required for Creatives |
Custom Macros from your template (applicable only for Xandr) |
Three important steps To set up Creative Upload:
To set up your Creative Upload for Google AdManager you will need to go through the following steps:
Create or Import (version 2.155 and up) Ad Creative Templates into ADvendio
Configure your Ad Creative Template Variables for each template (based on your non-digital products, GAM or Xandr requirements)
Connect Ad Creative Templates to Ad Types in ADvendio, to make them available to your users
1. Create an Ad Creative Template
Start by creating your Ad Creative Template in ADvendio, this will help you to configure the types of creatives you want to manage from ADvendio.
In Ad Creative Template View select the button “New”. It will open “New Ad Creative Template”:
Generally, these fields need to be filled:
Creative Template Name: You can pick any name that you like. This name will be shown to the user when uploading a new creative to ADvendio, so we recommend using something which is relatable for your users
The following fields:
Connection - links to the connection record, which represents your product network
Creative Type - determines which type of Creative will be uploaded to your product network
Template ID - enter the Creative Template ID which you are planning to use
External Status - currently not used (it worked to import the current status template in the internal system. Useful when the user manually wants to decide which template to offer as active in Advendio)
Active: Please set your template to active, otherwise inactive templates will not be shown during the creative upload process
Please note fields below not relevant when working with non-digital products:
Connection
Creative Type
Template ID
External Status
Please note GAM, Xandr and non-digital products are supporting different formats of Ad Creative Templates.
Product-specific examples and screenshots of how to Create, Configure and Connect your Ad Creative Template:
How to set up the creative upload feature for non-digital products?
How to set up the creative upload features for Google Ad Manager?
How to set up the creative upload features for Xandr?
2. Configure your Ad Creative Template Variables
Once the template is there, you will need to define which fields you want or need to use.
To manage the variables of a template, you need to switch to the related tab in your Ad Creative Template record and view the related list ‘Ad Creative Template Variables’.
Click the button new to create a new Variable. Depending on your creative type there are certain Variables which might be needed. Each Variable record you create will then be its own field in the Creative Upload window your user sees so that they can fill in the required information.
Ad Creative variable Fields and its meanings:
Ad Creative Template Variable Name: A general name for your variable. This will also be shown as Field Name to the user during the creative upload process, so we recommend picking something your users can recognize
Variable Type: Which data type is this variable? The selection will also reflect how your field will be shown to the users. Possible types are:
attachment: This type should be used for files.
boolean: This type represents a checkbox with true or false.
date: This type represents a date with a calendar selection.
integer: This type represents a whole number.
picklist: This type represents a list of multiple values.
string: This type represents a text.
textarea: This type represents a longer text.
attachmentURL: This type should be used for URLs to externally stored images.
Required: Check this if the field is required for the user.
Possible Values: Only applicable for picklist Variable Types to enter the possible values to be selected separated by a semicolon.
Note: In order for the picklist values to be in a dropdown list you have to write the values separated by ; (semicolon)Variable ID: An Id to save the value in the background. This value needs to be set (for non-digital items you could set the same value as the name).
Default: A possible default value to support the user in the selection.
Help Text: A possible help text displayed over the template field and which be shown in the UI.
Placeholder: A placeholder text which will be displayed for each variable.
Sort order: Unique sort number within the template to define in which position this field will be shown in UI (see more details in the section below).
Unique key: Filled by Advendio to ensure that during automatic imports, we can identify any update for already existing creative template variables.
Maximum number: The maximum count of characters that can be entered for a string and text area variable in the Ad Creative Template. This setting defines the limit for the length of text that users can input.
NOTE: that for numerical inputs, this limit will be interpreted as a maximum value rather than a digit count.
3. Connect your Template to Ad Types
Once the template is created with all its Ad Creative variables, you will need to define which Ad Types you would like to assign this template. Without assigning the Templates to Ad Types you won’t be able to create new Creatives in the UI as described in: https://advendio.atlassian.net/wiki/spaces/SO/pages/2829713409
To connect the template to one or multiple Ad Types please go to the related lists of the Ad Creative Template record. For the related list “Assigned Ad Types“ you need to hit the new button in order to select the relevant Ad Type for which this template and its variables should be usable. After you selected the Ad Type you can either hit the save button if you just want to assign one Ad Type. If you would like to assign multiple Ad Types you can also hit the Save & New button.
Sort Order of fields
Sort Order of fields - a unique sort number in the template. It defines in which order this field will be visually displayed in the UI.
In the screenshot below you can see when you select for ‘Target Size GAM' sort order 'position 1’ then the target size variable is moved to the top of the page in the UI.
Screenshot of the variable with the sort order field:
