| Table of Contents |
|---|
...
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
...
| Info |
|---|
Incoming changes with ADvendio July 2024 Release There are some slight modification to the logic of how Creative Templates are imported into ADvendio by the July 2024 release. Please see the section at the bottom of this page for more information: Release 2.171 Breaking Change in import of Picklist Type Variables |
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.
...
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
Campaign Manager 360 Creatives (Tags) →
Third-Party Creative Available with version March 2024 (2.162Third Party Creative170)
Custom Code Creatives Available with March 2024 (2.170)
Custom Template Creatives / Natives → Available with Version 2.157
Video Redirect Creatives Available with March 2024 (2.170)
The ADvendio Creative Data Model
...
You can now import templates from your Google Ad Manager network into ADvendio. With this enhancement, you have ready-to-use templates already created at the click of a button!
In order to To access this feature, you will need to go to your Google Ad Manager Connection record in ADvendio and select ‘transfer to ADvendio’
...
After the import process from the AdServer is finished, you will receive a result email. This will also provide you with an overview of problems during the import process. Some of the more common issues can be:
Non-working / invalid credentials for your connection
Missing Permissions on your Third-Party Platform User
Salesforce Problems, when uploading data, such as no editing permissions on the required fields and objects, storage limitations or custom validations
If a Creative Template can not be created by the ADvendio import process, all related variables will also fail, with an error message that ‘ADvendio__UniqueKeyExt__c was not specified’
...
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
Campaign Manager 360
Third-Party Creative
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
...
Click the button new to create a new Variable. Depending on your creative format there are certain Variables which are always required. See also the section on the mapping below. Each Variable record you create will then be its own field in the Creative Upload window your user sees, so they can fill in the required information.
...
Name: A general name for your variable. This will also be shown as a 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.
Variable ID: The Id 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
...
Google Ad Manager
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 | “0691j000001mK5aAAE” |
|
| Image / Overlay Overlay Custom Code Creative (with 2.170 release) |
DestinationURL | Destination URL where the ad leads | string |
| 1024 |
| Image / Image URL / Overlay Custom Code Creative (with 2.170 release) |
DestinationURLType | The type of destination a user reaches once the ad is clicked. Default to lead to a website is CLICK_TO_WEB | picklist |
|
|
| Image / Image URL / Overlay Overlay Custom Code Creative (with 2.170 release) |
TargetSize | The slot size | string | any 123x345 format |
|
| Image / Image URL / Overlay / Third-Party Custom Code Creative(with 2.170 release) |
OverrideSize | A size to use instead of the actual slot size of the image | string | any 123x345 format |
| CampaignManager360 | |
ImageURL | The URL where the actual asset resides. | attachmentURL |
| 1024 |
| Image URL |
RedirectURL | Contains the redirect URL of the creative Asset; Usually the Tag received from CampaignManager360 | RedirectURL |
| CampaignManager360 | ||
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 |
|
|
| Overlay / Third-Party Custom Code Creative (with 2.170 release) |
SSLManualOverride | You can define if Google should check the SSL of Third Party HTML creatives or to overwrite if the creative is compatible or not compatible | picklist |
|
| Third-Party Custom Code Creative (with 2.170 release) | |
HTMLSnippet | Use this to paste the HTML code of your Third Party Creatives | long text |
|
| Third-Party Custom Code Creative (with 2.170 release) | |
MacroName | MacroName | string | “%%CLICK_URL_UNESC%%” |
| Custom Code Creative(with 2.170 release) | |
IsInterstitial | IsInterstitial | string |
|
| Custom Code Creative(with 2.170 release) |
*Please note, that ADvendio currently requires exactly the values listed here to be set, otherwise the creative upload will end in an error message.
...
Ad Creative Template Variable Name | Variable Type | Variable ID | Possible Values | Required | Help Text | Default Value |
|---|---|---|---|---|---|---|
Image File | attachment | FileTrue |
| Upload the image file you want to use for your ad | ||
Goal URL | string | DestinationURLTrue |
| 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 |
| 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. ExampleExamples:
| True
| Please select the size that your Creative uses, in most cases this is equal to the size of your image. | |
Alternative Text | string | AlternativeTextFalse |
| Enter an alt text for your ad, which will be shown if the image could not be displayed. |
...
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 just 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 select 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.
...
Release 2.171 Breaking Change in import of Picklist Type Variables
What has changed:
We slightly changed the logic as how Creative Templates for Google are imported. This affects Variables, that have a predefined set of possible values, like for example the DestinationURLType.
Before, these were imported as String type variable, so that users had to manually enter the expected values:
After the change, we now import them as picklist Variable Type and already prefill the possible values. This makes them ready to use, without having to further modify the creative template in that regard.
Will you be affected?:
If you are not using the Transfer to ADvendio Feature to import Creative Templates, you will not be affected by this change.
As stated above, if you have modified Creative Templates in any form and run the import again, we will overwrite any modifications. If you want to customize your templates, please overwrite the Unique Key External field, so that our import will not overwrite changes. Starting with version 2.171, the following Creative Templates, will be imported in the new style:
Image
Overlay
Image URL
Google Custom Template
Campaign Manager 360
Third Party
Custom Code
Video Redirect
HTML
The variables by default were added as picklists for the following present variables at different templates:
DESTINATION_URL_TYPE =
"CLICK_TO_WEB", "CLICK_TO_APP", "CLICK_TO_CALL", "NONE"ORIENTATION =
"FREE_ORIENTATION", "PORTRAIT_ONLY", "LANDSCAPE_ONLY"SSL_MANUAL_OVERRIDE =
"NO_OVERRIDE", "SSL_COMPATIBLE", "NOT_SSL_COMPATIBLE"SKIPPABLE_AD_TYPE =
"DISABLED", "ENABLED", "INSTREAM_SELECT", "ANY"
...