Versions Compared

Key

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

Table of Contents

...

...

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

 

(tick)

Image / Overlay

Overlay

Custom Code Creative (with 2.170 release)

DestinationURL

Destination URL where the ad leads

string

 

1024

(tick)

Image /

Image URL / Overlay

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

  • CLICK_TO_WEB

  • CLICK_TO_APP

  • CLICK_TO_CALL

 

(tick)

Image /

Image URL / Overlay

Overlay

Custom Code Creative (with 2.170 release)

TargetSize

The slot size

string

any 123x345 format

 

(tick)

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

(error)

CampaignManager360

ImageURL

The URL where the actual asset resides. 

attachmentURL

 

1024

(tick)

Image URL

RedirectURL

Contains the redirect URL of the creative Asset; Usually the Tag received from CampaignManager360

RedirectURL

(tick)

CampaignManager360

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 /

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

  • “NO_OVERRIDE;

  • SSL_COMPATIBLE;

  • NOT_SSL_COMPATIBLE“

(tick)

Third-Party

Custom Code Creative (with 2.170 release)

HTMLSnippet

Use this to paste the HTML code of your Third Party Creatives

long text

“<!DOCTYPE html> <html lang=\“en\“><head>     <meta charset=\“UTF-8\“>     <meta name=\“viewport\” content=\“width=device-width, initial-scale=1.0\“>     <title>Your Page Title</title> </head><body>     <h1>Hello, World!</h1>     <p>This is a simple HTML snippet. </p></body></html>”

(tick)

Third-Party

Custom Code Creative (with 2.170 release)

MacroName

MacroName

string

“%%CLICK_URL_UNESC%%”

(tick)

Custom Code Creative(with 2.170 release)

IsInterstitial

IsInterstitial

string

  • TRUE

  • FALSE

(error)

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

(tick)

Upload the image file you want to use for your ad

Goal URL

string

DestinationURLTrue

(tick)

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

(tick)

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:

  • “120x600;

  • 300x250;

  • 728x90;

  • 1x1”

True

(tick)

Please select the size that your Creative uses, in most cases this is equal to the size of your image.

Alternative Text

string

AlternativeTextFalse

(error)

Enter an alt text for your ad, which will be shown if the image could not be displayed.

...