Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Challenge

...

  • Which creative types and features are already supported?

  • Which steps are needed to set up and configure the creative upload feature for Xandr

  • Can ADvendio handle custom templates and custom macros? And how to configure this?

...

Solution

In order to 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 Template are available. This helps you for example to make sure to only use video creatives for your video Campaign Items and similar.

...

ADvendio Object

Xandr

Ad Creative

The actual creative that will be uploaded to an advertiser in Xandr and will later be assigned to a line item

Campaign Item

represents the Line Item in Xandr

Creative Assignments

ADvendio assigns Creatives to Line Items in Xandr based on the Creative Assignment object in ADvendio.

Ad Creative Template

The Xandr Creative Template to use

Ad Creative Template Variable

The fixed settings and fields required for Xandr Creatives, more information can be found in 7.2.21.1 Creation of Ad Creative Templates and Variables

Ad Creative Template Variable

Xandr Custom Macros from your template

...

You can now import templates from your Xandr 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 Xandr Connection record in ADvendio and select ‘transfer to ADvendio’

...

Once the import is done, you receive ready-to-use templates, which contain all the required technical information for ADvendio. You can then proceed to customize them to your needs further, for example by adding additional help texts to the variables (see mapping section below).

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!

...

additional help texts to the variables (see mapping section below).

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!

...

Problems during the import

After the import process from the AdServer finished, you will receive a result email. This will also provide you 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’

...

Manual Creation of Ad Creative Templates in ADvendio

...

ADvendio Variable ID

Field to target

Relevant Variable Type

Possible Values

Required

Relevant for Creative Formats

File

The actual image file to upload

attachment

 

(tick)
You either need to provide a file or a MediaURLSecure, in order for the upload to work

Images

MediaURLSecure

The URL to an externally stored file

attachmentURL

(tick)
You either need to provide a file or a MediaURLSecure, in order for the upload to work

All formats

*not required for code based formats

MediaURL

If required, you can set a different, ‘non-secure’ URL to the externally stored file.

attachmentURL

(error)

All formats

*not required for code based formats

IframeHTMLContent

Stores the HTML code for iframe HTML type creatives

string

(tick)

Iframe HTML formats

RawHTMLContent

string

(tick)

HTML Code related formats

RawJSContent

string

(tick)

JS related formats

DestinationURL

Click URL where the ad leads

string

 

(tick)

All formats

*not required for code based formats

Width

the creative width

integer

(tick)

All formats

Height

the creative height

integer

(tick)

All formats

API Name of a Custom Macro

The Custom Macro

depending on the macro

Depends on the macro

All formats

Allow AuditAllowAudit

If true, the creative will be submitted for auditing. If false, the creative will not be submitted. Unaudited creatives can only run on a network's managed inventory.

booleanstring

  • true

  • false

⚠️ If nothing is selected is set to “false” by default.

(error)(tick)

Banner - Image

AuditStatus

The audit status of the creative.

valuesstring

  • no_audit

  • pending

  • rejected

  • audited

⚠️ If nothing is selected is set to “no_audit” by default.

(error)(tick)

Banner - Image

Status

The status of the creative describing if the creative is ready to serve.

boolean

  • true

  • false

⚠️ If nothing is selected is set to “false” by default.

(error)(tick)

Banner - Image

...

Xandr Creative Template Example in ADvendio

...

Natives in Xandr can contain a huge variety of different fields and settings. In order to To prepare those from ADvendio, you will first need to create specific Ad Creative Templates.

...

Image Assets & Attachments

You are able to can provide multiple images and icons for your native creatives in Xandr.

...

Info

Important to note:

  1. Our current character limit for the Tags and Code fields in Xandr Creative Upload may be lower than what Xandr allows (please keep this in mind when trying to use formats which contain HTML code.

...

Note

Warning: Currently, Zip File upload is not supported.

Creative Assignment Dates for GAM and Xandr

Google Ad Manager GAM and Xandr have introduced a new feature with their 2.169 release to address the issue of setting dates for ad assignments. The new feature, support the feature "Assignment Dates in Creative Uploads, " that allows advertisers and campaign managers to choose select specific dates when they upload for uploading their ads. This gives them feature provides greater control over their advertising campaigns and better ensures that their ads are displayed at the right time. For more info, please refer to this articleADD LINK.