Table of Contents |
---|
Challenge
You are planning to use the ADvendio Creative Upload features to manage your creatives in ADvendio and upload them directly to your Google Ad Manager (GAM) network. Now you are wondering:
Which creative types and features are already supported?
Which steps are needed to set up and configure the creative upload feature for GAM
Can ADvendio handle custom templates? And how to configure this?
...
Solution
In order to set up the Creative Upload in ADvendio, there are so-called Ad Creative Templates 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 video creatives for your video Campaign Items and similar.
...
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 GAM requirements
Connect Ad Creative Templates to Ad Types in ADvendio, to make them available to your Users
Features and Creative formats currently supported for GAM
The following Creative formats are currently supported by ADvendio:
All image-related formats
Image (direct upload of files)
Image URL (Url to an externally stored image) → Available with Version 2.147
Overlay (direct upload of files) → Available with Version 2.147
Custom Template Creatives / Natives → Available with Version 2.157
The ADvendio Creative Data Model
Here is an overview of the data model and what it means:
ADvendio Object | Google Ad Manager |
---|---|
Ad Creative | The actual creative that will be uploaded to an advertiser in GAM and will later be assigned to a line item |
Campaign Item | represents the Line Item in GAM |
Creative Assignments | ADvendio assigns Creatives to Line Items in GAM based on the Creative Assignment object in ADvendio. |
Ad Creative Template | The GAM Creative Template to use (if applicable) |
Ad Creative Template Variable | The fixed settings and fields required for GAM Creatives, more information can be seen below |
Import your templates from your Google Ad Manager Network
Info |
---|
This is available as a BETA release with version 2.157, we will delivery additional functions within the following releases |
...
Note |
---|
Attention: All templates imported by ADvendio, receive a Unique Key in the field Unique Key External. If you want to modify a template for your own needs, please empty this Unique Key or set an own one. Otherwise if you start the import process a second time, we might overwrite your changes! |
...
Manually create an Ad Creative Template in ADvendio
You start off by creating your Ad Creative Template in ADvendio, this will help you to configure the types of creatives you want to manage from ADvendio.
...
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 to your users
Connection (optional): Please link to the connection record, which represents your GAM network
Creative Type: Determines which type of Creative will be uploaded to Google AdManager. The following formats are currently supported:
Image
Image URL
Overlay
Template ID: Currently not used
External Status: Currently not used
Active: Please set your template to active, otherwise it will not be available during the creative upload process
Manually configure your Ad Creative Template Variables
Once the template is there, you will need to define which fields you want or need to use. In our example, there are a few fixed variables we always need for the GAM banner.
...
Name: A general name for your variable. This will also be shown as Field Name to the user during 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 for 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.
Variable ID: The Id to target the value to the external system (case-sensitive). Please check the table below for more information.
Default: A possible default value to support the user in the selection.
Help Text: A possible help text which will soon be shown in the UI.
Mapping ADvendio Variables to GAM
ADvendio Variable ID | Field to target | Relevant Variable Type | Possible Values* | Max Length (characters) | Required | Relevant for Creative Formats |
---|---|---|---|---|---|---|
File | The actual image file to upload | attachment |
|
| Image / Overlay | |
DestinationURL | Destination URL where the ad leads | string |
| 1024 | Image / Image URL / Overlay | |
DestinationURLType | The type of destination a user reaches once the ad is clicked. Default to lead to a website is CLICK_TO_WEB | picklist | CLICK_TO_WEB CLICK_TO_APP CLICK_TO_CALL |
| Image / Image URL / Overlay | |
TargetSize | The slot size | string | any 123x345 format |
| Image / Image URL / Overlay | |
ImageURL | The URL where the actual asset resides. | attachmentURL |
| 1024 | Image URL | |
AlternativeText | Alternative text to be rendered along with the creative used mainly for accessibility. | string |
| 500 | Image / Image URL | |
ImpressionURL | An impression tracking URL to ping when the creative is displayed. | string |
| 1024 | Image / Image URL | |
CustomParameters | A comma separated key=value list of parameters that will be supplied to the creative. | string |
|
| Overlay | |
Duration | Minimum suggested duration in seconds. | integer |
|
| Overlay | |
Orientation | A locked orientation for the creative to be displayed in. | picklist | UNKNOWN FREE_ORIENTATION PORTRAIT_ONLY LANDSCAPE_ONLY |
| Overlay |
*Please note, that ADvendio currently requires exactly the values as listed here to be set, otherwise the creative upload will end in an error message.
Example for a Google Ad Manager Creative Template in ADvendio
So to use Google Creative Upload a simple example for a template can look like this:
...
Ad Creative Template Variable Name | Variable Type | Variable ID | Possible Values | Required | Help Text | Default Value |
---|---|---|---|---|---|---|
Image File | attachment | File | True | Upload the image file you want to use for your ad | ||
Goal URL | string | DestinationURL | True | Enter which URL a user should reach, once the ad is clicked. Please use ‘www.example.com’ as format. | www.example.com | |
Type of Goal | picklist | DestinationURLType | CLICK_TO_WEB;CLICK_TO_APP;CLICK_TO_CALL | True | What type of action will be started, once a user clicks the ad. | CLICK_TO_WEB |
Slot Size | picklist | TargetSize | Values should be based on the slot sizes your products use. Example: “120x600;300x250;728x90;1x1” | True | Please select the size that your Creative uses, in most cases this is equal to the size of your image. | |
Alternative Text | string | AlternativeText | False | Enter an alt text for your ad, which will be shown if the image could not be displayed. |
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: 4.12.2 How to upload Ad Materials (Creatives) to ADvendio?
...