PRODUCT
Follow

This article contains the complete list of fields for Enhanced Standard Banner ads and a sample JSON for this ad type.

Enhanced Standard Banner Ad Fields

Field

Data Type

Limitations

Description

type String (AdType Enum) Mandatory Object type data
id Long Mandatory, Unchangeable ID of the ad
createdBy Long Unchangeable ID of the user who created the ad
createdByName String Unchangeable Name of the user who created the ad
createdByAccount Long Unchangeable ID of the account of the user who created the ad
createdByAccountName String Unchangeable Name of the account of the user who created the ad
createdOn Long Unchangeable Date & time on which the ad was created (Date epoch)
lastUpdatedBy Long Read-only ID of the user who last updated the ad
lastUpdatedByName String Read-only Name of the user who last updated the ad
lastUpdatedByAccount Long Read-only ID of the account of the user who last updated the ad
lastUpdatedByAccountName String Read-only Name of the account of the user who last updated the ad
lastUpdatedOn Long Read-only Date & time on which the ad was last updated (Date epoch)
name String Mandatory Name of the ad
masterAdId Long Unchangeable In case of a placement ad, ID of the master ad it originated from, empty otherwise
changed Boolean Unchangeable In case of a placement ad, Indicates whether the ad was changed since was created from its master ad
adStatus String (AdStatus Enum) Mandatory, Unchangeable The status of the ad
enabled Boolean Unchangeable Indicates whether the ad is enabled or disabled (For serving purposes)
adFormat String (AdFormat Enum) Optional The base ad format of the ad - in case of CAF
adFormatId Long Mandatory, Unchangeable ID of the ad format (AdFormat Enum)
adFormatName String Read-only Name of the ad format, for example 'HTML5 Expandable Ad'
accountId Long Mandatory, Unchangeable ID of the account of the user who created the ad
accountName String Read-only/td> Name of the account of the user who created the ad
placementId Long Unchangeable ID of the placement the ad is attached to - placement ad only
placementName String Read-only Name of the placement the ad is attached to - placement ad only
siteId Long Unchangeable ID of the site of the placement the ad is attached to - placement ad only
siteName String Read-only Name of the site of the placement the ad is attached to - placement ad only
adAssignmentData Object (AdAssignmentData Class) Unchangeable Assignment data of the ad, for example campaign or brand
mainClickthrough Object (MainClickthrough Class) Optional Main click-through that will be fired when clicking on the ad
adURLs Array of Objects (ThirdPartyURL Class) Optional List of all ad 3rd party tracking URLs
pricingSize Long Read-only Size of the ad (in KB) calculated for billing purposes
overallSize Long Read-only Size of the ad (in KB) including all of its assets
initialSize Long Read-only Size of the ad (in KB) calculated by the asset that is loaded initially
width Long Read-only Width of the ad
height Long Read-only Height of the ad
dimensions String Read-only String representation of the dimensions as width X height
templateScriptName String (TemplateScriptName Enum) Maps to the correct base AdConfig.js file
urlTokens String  Read-only  
minAudioVersion Double    
fourthPartyTag String    
adChoicesStatus Boolean Optional Controls if the ad choices icon is shown
adChoicesLocation String (AdChoicesLocation Enum) Optional Controls the relative location of the ad choices icon on the ad
qaStatus String (AdQAStatus Enum) Optional Indicates the status of the ad qa review process
numberOfPlcementAds Integer Read-only Number of placements ad the master ad has (Only the ones visible to the user)
overallNumberOfPlacdementAds Integer Read-only Number of placements ad the master ad has (All)
servingMethod String (ServingMethod Enum) Read-only Describes the type of serving method used to display the ad
analyticsData Object (AdAnalyticsData Class) Provides ad analytics statistics on the ad
analyticsSettings      
customFields Object (CustomFields Class) Optional Custom fields values on entity level; each field must have a metadata definition on parent account.
massVersioning Boolean Optional Indicates if the ad is a mass versioned ad
usedAsTemplate Boolean Unchangeable Indicates if this ad is used as part of an ad template
unSavedTemplateAd Boolean Unchangeable Indicates if the ad was created from HTML5 factory from an ad template but was not actually saved yet
adTemplateId Long Unchangeable ID of the ad template the originated from 
feedEnabled Boolean   Indicates if the smart version ad supports feed
feedStatus String (APIFeedTransactionStatus Enum) Status of the mass versioning feed
defaultImage Object (AdAsset Class) Mandatory Ad's default image
defaultImageClickthrough Object (Clickthrough Class) Optional URL navigated to when click on the default image
banner Object (AdAsset Class) Optional The ad's banner
minFlashVersion Double Read-only Minimum flash version required to play the ad
mxpVersion String Read-only  
osVersion String Read-only  
asVersion String Read-only Minimum ActionScript version required to play the ad
flashIDE String Read-only  
variables Array of Object (Variable Class) Optional List of ad variables
playOnlyUponTrigger boolean Mandatory Play rich banner only upon trigger from preload banner
downloadMode String (DownloadMode Enum) Mandatory Control whether to wait to full ad load before starting video
customInteractions Array of Object (AdCustomInteraction Base Class)
Derived Classes:
AdTimerInteraction,
AdClickthroughInteraction,
AdUserActionInteraction, AdAutomaticEventInteraction)
Optional List of custom interaction defined on the ad and its assets
preloadBanner Object (AdAsset Class) Optional Ad's preload banner

JSON Example

{
"type":"EnhancedStandardBannerAd",
"id":<Auto Generated ID>,
"clientRefId":null,
"version":<Auto Generated ID>,
"createdBy":<Auto Generated ID>,
"createdByName":"<Auto Generated ID>",
"createdByAccount":<Auto Generated ID>,
"createdByAccountName":"<Auto Generated ID>",
"createdOn":1438156578632,
"lastUpdatedBy":<Auto Generated ID>,
"lastUpdatedByName":"<Auto Generated ID>",
"lastUpdatedByAccount":<Auto Generated ID>,
"lastUpdatedByAccountName":"<Auto Generated ID>",
"lastUpdateOn":1438156881651,
"name":"Test Enhanced Standard Banner",
"masterAdId":<Auto Generated ID>,
"changed":false,
"adStatus":"ASSIGNED",
"enabled":true,
"adFormat":"ENHANCED_STANDARD_BANNER_AD",
"adFormatId":25,
"adFormatName":"Enhanced Standard Banner",
"accountId":<Auto Generated ID>,
"accountName":"NXT_Alpha (don't rename)",
"placementId":null,
"placementName":null,
"siteId":null,
"siteName":null,
"adAssignmentData":{
"type":"AdAssignmentData",
"accountId":<Auto Generated ID>,
"accountName":"<Auto Generated ID>",
"advertiserId":<Auto Generated ID>,
"advertiserName":"<Auto Generated ID>",
"brandId":<Auto Generated ID>,
"brandName":"<Auto Generated ID>",
"campaignId":<Auto Generated ID>,
"campaignName":"<Auto Generated ID>"
},
"mainClickthrough":{
"type":"MainClickthrough",
"id":<Auto Generated ID>,
"clientRefId":null,
"relationsBag":null,
"uiPermissions":null,
"version":null,
"url":"<Auto Generated ID>",
"targetWindowType":"NEW",
"showAddressBar":true,
"showMenuBar":true,
"closeAllAdParts":false
},
"adURLs":null,
"pricingSize":70882,
"overallSize":70882,
"initialSize":70882,
"width":300,
"height":250,
"dimensions":"300x250",
"templateScriptName":"Banner",
"urlTokens":null,
"minAudioVersion":0.0,
"fourthPartyTag":"",
"adChoicesStatus":false,
"adChoicesLocation":"TOP_RIGHT",
"qaStatus":"NOT_SUBMITTED",
"numberOfPlacementAds":0,
"overallNumberOfPlacementAds":0,
"servingMethod":null,
"analyticsData":null,
"analyticsSettings":null,
"customFields":null,
"massVersioning":false,
"usedAsTemplate":false,
"unSavedTemplateAd":false,
"adTemplateId":null,
"feedEnabled":null,
"feedStatus":null,
"defaultImage":{
"type":"AdAsset",
"id":<Auto Generated ID>,
"clientRefId":null,
"relationsBag":null,
"uiPermissions":null,
"version":null,
"assetId":<Auto Generated ID>,
"assetName":"<Auto Generated ID>",
"source":true,
"assetStatus":null,
"folderId":<Auto Generated ID>,
"size":5316,
"duration":0,
"bitRate":0,
"width":300,
"height":250,
"mimeType":"image/jpeg",
"mediaType":"IMAGE",
"thumbnailUrl":"<Auto Generated ID>"
},
"defaultImageClickthrough":{
"type":"MainClickthrough",
"id":<Auto Generated ID>,
"clientRefId":null,
"relationsBag":null,
"uiPermissions":null,
"version":null,
"url":"<Auto Generated ID>",
"targetWindowType":"NEW",
"showAddressBar":true,
"showMenuBar":true,
"closeAllAdParts":false
},
"banner":null,
"minFlashVersion":<Auto Generated ID>,
"mxpVersion":null,
"osVersion":null,
"asVersion":null,
"flashIDE":null,
"variables":null,
"playOnlyUponTrigger":false,
"downloadMode":"POLITE",
"customInteractions":[
{
"type":"AdClickthroughInteraction",
"id":<Auto Generated ID>,
"clientRefId":null,
"relationsBag":null,
"uiPermissions":null,
"version":null,
"assetId":<Auto Generated ID>,
"name":"default",
"reportingName":"default",
"assetName":null,
"closeAdParts":false,
"redirectURL":""
},
{
"type":"AdClickthroughInteraction",
"id":<Auto Generated ID>,
"clientRefId":null,
"relationsBag":null,
"uiPermissions":null,
"version":null,
"assetId":<Auto Generated ID>,
"name":"view trailer",
"reportingName":"view trailer",
"assetName":null,
"closeAdParts":false,
"redirectURL":""
}
],
"preloadBanner":{
"type":"AdAsset",
"id":<Auto Generated ID>,
"clientRefId":null,
"relationsBag":null,
"uiPermissions":null,
"version":null,
"assetId":<Auto Generated ID>,
"assetName":"<Auto Generated ID>",
"source":true,
"assetStatus":null,
"folderId":<Auto Generated ID>,
"size":65566,
"duration":0,
"bitRate":0,
"width":300,
"height":250,
"mimeType":"application/x-shockwave-flash",
"mediaType":"FLASH",
"thumbnailUrl":"<Auto Generated ID>"
}
}
 
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk