Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • 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

Info

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.

The following features are currently supported:

  • Custom Creative Templates (as long as they are using the supported formats)

Create an Ad Creative Template in ADvendio

...

  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: You can use this field to further classify 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

...

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

 

 

(tick)

Image / Overlay

DestinationURL

Destination URL where the ad leads

string

 

1024

(tick)

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

 

(tick)

Image / Image URL / Overlay

TargetSize

The slot size

string

any 123x345 format

 

(tick)

Image / Image URL / Overlay

ImageURL

The URL where the actual asset resides. 

attachmentURL

 

1024

(tick)

Image URL

AlternativeText

Alternative text to be rendered along with the creative used mainly for accessibility. 

string

 

500

(error)

Image / Image URL

ImpressionURL

An impression tracking URL to ping when the creative is displayed.

string

 

1024

(error)

Image / Image URL

CustomParameters

A comma separated key=value list of parameters that will be supplied to the creative.

string

 

 

(error)

Overlay

Duration

Minimum suggested duration in seconds.

integer

 

 

(error)

Overlay

Orientation

A locked orientation for the creative to be displayed in.

picklist

UNKNOWN

FREE_ORIENTATION

PORTRAIT_ONLY

LANDSCAPE_ONLY

 

(error)

Overlay

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

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

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

...