7.3.4.11 How to setup the creative upload features for Google Ad Manager?

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 setup 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 for which Campaign Items, 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.

Also the templates will help to define which information is sent to which fields in GAM. Some of the templates in ADvendio will refer to a Creative Template in GAM.

Underneath each Ad Creative Template in ADvendio there are Template Variables, those can configure which fields are visible in the Creative Upload Screen.

Here is an overview about the data model and what it means:

ADvendio Object

GAM

ADvendio Object

GAM

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

To start configuring your ADvendio Org for the creative upload to GAM, you need to follow these steps:

  • Create Ad Creative Templates in 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

Which Features and Creative formats are 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

For the first version ADvendio only supports uploading actual image files to GAM, the support of URLs to externally stored images as well as other formats will be supported soon.

 

Create an Ad Creative Template in ADvendio

You start of by creating your Ad Creative Template in ADvendio, this will help you to configure the types of creatives you want to manage from ADvendio.

Let’s say we want to use the Standard file image template. We proceed to create an Ad Creative Template record in ADvendio, which could look like this:

 

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

  2. Connection (optional): Please link to the connection record, which represents your GAM network

  3. Creative Type: Determines which type of Creative will be uploaded to Google AdManager. The following formats are currently supported:

    1. Image

    2. Image URL

    3. Overlay

  4. Template ID: Currently not used

  5. External Status: Currently not used

  6. Active: Please set your template to active, otherwise it will not be available during the creative upload process

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.

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 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 an own field in the Creative Upload window your user sees, so they can fill in the required information.

The fields mean the following:

  • 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 the 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

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 AdManager Creative Template in ADvendio

So to use the Google Creative Upload a simple example for a template can look like this:

AdCreative Template Field

Value

AdCreative Template Field

Value

Name

Google Image (upload file)

Creative Type

Image

Connection

The connection record of your Google AdManager network

Active

True

Underneath this AdCreative template, the following AdCreative Template Variables are created:

Ad Creative Template Variable Name

Variable Type

Variable ID

Possible Values

Required

Help Text

Default Value

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