...
Example for a Xandr Creative Template in ADvendio
So to use the Google Xandr Creative Upload a simple example for a template can look like this:
...
The Basic Setup
For the basic settings, the name will be used from the name you give in ADvendio and to to use theyou will only need a variable, which represents the landing page URL, as the Creative Name is a default field in ADvendio.
ADvendio Variable ID | Field to target | Relevant Variable Type | Possible Values | Required |
|---|---|---|---|---|
URLLinkAttribute | The landing page URL for the native | string |
|
|
FallbackURLLinkAttribute | string |
|
Composition / Data Assets
To actually define the native, Xandr offers a variety of elements, like the Title, a body text, Call to actions and similar. We summarized those as Data Assets. For each of this Xandr fields that is relevant for you, you can create a ad creative template variable in ADvendio. None of these is required for the submit to Xandr to work.
ADvendio Variable ID | Field to target | Relevant Variable Type | Possible Values | Required | DataAssetTitle | The landing page URL for |||||
|---|---|---|---|---|---|---|---|---|---|---|
DataAssetTitle | The title of the native | string / integer / text field | ||||||||
DataAssetDescription | The main body text of the native | string / integer / text field |
|
| DataAssetDescription | string |
| DataAssetSponsoredBy | DataAssetCallToAction | DataAssetDisplayURL |
DataAssetPrice | DataAssetSalePrice | DataAssetRating | DataAssetLikes | DataAssetDownloads | DataAssetPhone | DataAssetAddress | DataAssetAdditionalDescription | DataAssetCustomTitle1 … DataAssetCustomTitle5DataAssetSponsoredBy | Sponsored By field in Xandr | string / integer / text field |
DataAssetCallToAction | Call to Action field in Xandr | string / integer / text field | ||||||||
DataAssetDisplayURL | Display URL field in Xandr | string / integer / text field | ||||||||
DataAssetPrice | Price Field in Xandr | string / integer / text field | ||||||||
DataAssetSalePrice | Sales Price field in Xandr | string / integer / text field | ||||||||
DataAssetRating | Rating field in Xandr | string / integer / text field | ||||||||
DataAssetLikes | Likes field in Xandr | string / integer / text field | ||||||||
DataAssetDownloads | Downloads field n Xandr | string / integer / text field | ||||||||
DataAssetPhone | Phone field in Xandr | string / integer / text field | ||||||||
DataAssetAddress | Address field in Xandr | string / integer / text field | ||||||||
DataAssetAdditionalDescription | Additional Description field in Xandr | string / integer / text field | ||||||||
DataAssetCustomTitle1 … DataAssetCustomTitle5 | string / integer / text field | |||||||||
DataAssetCustomBody1 ... DataAssetCustomBody5 | string / integer / text field | |||||||||
DataAssetCustomCallToAction1 … DataAssetCustomCallToAction5 | string / integer / text field | |||||||||
DataAssetCustomSocialURL1 … DataAssetCustomSocialURL5 | string / integer / text field | |||||||||
DataAssetCustomDisplayURL1 … DataAssetCustomDisplayURL5 | string / integer / text field |
Image Assets & Attachments
You are able to provide multiple images and icon icons for your native creatives in Xandr.
Image Type | ADvendio Variable ID | Field to target | Possible values | Relevant Variable Type | Required |
|---|---|---|---|---|---|
Main Image | ImageFileMain | The |
image file to attach as main image for a native | string |
If you want to use an image, either attaching a file or a secure URL to an externally stored image is required | |||||
ThirdPartyImageURLMain | An optional URL to an externally stored image file without secure protocol, setting this is optional and the asset is not necessarily visible in the Xandr UI | string |
| ||
ThirdPartyImageURLSecureMain | A URL to an externally stored image file to use as main image | string |
If you want to use an image, either attaching a file or a secure URL to an externally stored image is required | ||
ThirdPartyImageWidthMain | The width of the image, is using an externally stored image | integer |
If using a URL to an externally stored image, providing size information is required | ||
ThirdPartyImageHeightMain | The height of the image, is using an externally stored image | integer |
If using a URL to an externally stored image, providing size information is required | ||
ResizeEnabledMain | Optional setting to automatically | true, false | picklist |
| |
CropEnabledMain | true, false | picklist |
| ||
AspectRatioUpperBoundMain | number between 0 and 50 | integer |
| ||
AspectRatioLowerBoundMain | number between 0 and 50 | integer |
| ||
MaxScaleFactorMain | number between 1.00 and 9.99 | integer |
| ||
Icon Image | ImageFileIcon | The image file to attach as main icon for a native | string |
If you want to use an image, either attaching a file or a secure URL to an externally stored image is required | |
ThirdPartyImageURLIcon | An optional URL to an externally stored image file without secure protocol, setting this is optional and the asset is not necessarily visible in the Xandr UI | string |
| ||
ThirdPartyImageURLSecureIcon | A URL to an externally stored image file to use as main icon | string |
If you want to use an image, either attaching a file or a secure URL to an externally stored image is required | ||
ThirdPartyImageWidthIcon | The width of the image, is using an externally stored image | integer |
If using a URL to an externally stored image, providing size information is required | ||
ThirdPartyImageHeightIcon | The height of the image, is using an externally stored image | integer |
If using a URL to an externally stored image, providing size information is required | ||
ResizeEnabledIcon | Optional setting to automatically | true, false | picklist |
| |
CropEnabledIcon | true, false | picklist |
| ||
AspectRatioUpperBoundIcon | number between 0 and 50 | integer |
| ||
AspectRatioLowerBoundIcon | number between 0 and 50 | integer |
| ||
MaxScaleFactorIcon | number between 1.00 and 9.99 | integer |
| ||
Custom Image 1 - 5 | ImageFileCustom1 … ImageFileCustom5 | Similar to the above examples, you can provide the files for the custom images 1-5 | |||
Custom Icon 1 - 5 | IconFileCustom1 … IconFileCustom5 | Similar to the above examples, you can provide the files for the custom icons 1-5 |
| Note |
|---|
Known Issue Information: Currently we’re experiencing problems when using URLs to externally stored images in Xandr natives. The Xandr API requires to also set additional image size information with the URL. This is later not visible in the Xandr UI. We’re trying to clarify the background at the moment and provide a solution for our customers, so that you don’t have to manually type in the information every time in ADvendio. A patch is expected to arrive in December |
...