PRODUCT
Follow

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

Single Expandable 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 matser ad
adStatus String (AdStatus Enum) Mandatory, Unchangeable Status of the ad
enabled Boolean Unchangeable Indicates whther the ad is enabled or disabled (For serving purposes)
adFormat String (AdFormat Enum) Optional 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 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) calculted 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 representaion 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 iif 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 (FeedTransactionStatus Enum)   Staus 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
additionalAssets Array of Object (AdditionalAsset Class) Optional List of additional assets used by the ad
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
adTranscodingStatus String (AdTranscodingStatus Enum) Unchangeable Indicates the status of the auto-transcoding process of the ad
performAutoVideoTranscoding Boolean Optional Whether to perform auto transcoding on the ad's video assets
variables Array of Object (Variable Class) Optional List of ad variables
downloadMode String (DownloadMode Enum) Mandatory Control whether to wait to full ad load before starting video
banner Object (AdAsset Class) Mandatory Ad's banner
videoStartMethod String (VideoStartMethod Enum) Mandatory Controls the trigger that start the video
minFlashVersion Double Read-only Minimum flash version required to play the ad
allowHTML5DynamicExpansion Boolean Optional Indicates if the ad supports dynamic expansion of panel
adSmartVersionSchema Object (AdSmartVersionSchema Class) Mandatory (when ad supports panels) Dynamic element of the mass vesioned 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  
hides String of Object (PanelHide Enum) Optional List of items to hide

JSON Example

{
"type":"SingleExpandableBannerAd",
"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":<Auto Generated ID>,
"lastUpdatedBy":<Auto Generated ID>,
"lastUpdatedByName":"<Auto Generated ID>",
"lastUpdatedByAccount":<Auto Generated ID>,
"lastUpdatedByAccountName":"<Auto Generated ID>",
"lastUpdateOn":1439991474898,
"name":"<Auto Generated ID>",
"masterAdId":<Auto Generated ID>,
"changed":false,
"adStatus":"PUBLISHED",
"enabled":true,
"adFormat":"SINGLE_EXPANDABLE_BANNER_AD",
"adFormatId":<Auto Generated ID>,
"adFormatName":"Single Expandable Banner",
"accountId":<Auto Generated ID>,
"accountName":"<Auto Generated ID>",
"placementId":null,
"placementName":null,
"siteId":<Auto Generated ID>,
"siteName":<Auto Generated ID>,
"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":"Clickthrough",
"id":<Auto Generated ID>,
"clientRefId":<Auto Generated ID>,
"relationsBag":<Auto Generated ID>,
"uiPermissions":<Auto Generated ID>,
"version":<Auto Generated ID>,
"url":""
},
"adURLs":null,
"pricingSize":59126,
"overallSize":59126,
"initialSize":39566,
"width":500,
"height":250,
"dimensions":"500x250",
"templateScriptName":"<Auto Generated ID>",
"urlTokens":null,
"minAudioVersion":0.0,
"fourthPartyTag":"",
"adChoicesStatus":false,
"adChoicesLocation":null,
"qaStatus":"NOT_SUBMITTED",
"numberOfPlacementAds":<Auto Generated ID>,
"overallNumberOfPlacementAds":<Auto Generated ID>,
"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":<Auto Generated ID>,
"relationsBag":<Auto Generated ID>,
"uiPermissions":<Auto Generated ID>,
"version":<Auto Generated ID>,
"assetId":<Auto Generated ID>,
"assetName":"<Auto Generated ID>",
"source":true,
"assetStatus":null,
"folderId":<Auto Generated ID>,
"size":39566,
"duration":0,
"bitRate":0,
"width":300,
"height":250,
"mimeType":"image/jpeg",
"mediaType":"IMAGE",
"thumbnailUrl":"<Auto Generated ID>"
},
"defaultImageClickthrough":{
"type":"Clickthrough",
"id":<Auto Generated ID>,
"clientRefId":<Auto Generated ID>,
"relationsBag":null,
"uiPermissions":null,
"version":null,
"url":""
},
"additionalAssets":null,
"customInteractions":[
{
"type":"<Auto Generated ID>",
"id":<Auto Generated ID>,
"clientRefId":<Auto Generated ID>,
"relationsBag":null,
"uiPermissions":null,
"version":null,
"assetId":<Auto Generated ID>,
"name":"<Auto Generated ID>",
"reportingName":"",
"assetName":<Auto Generated ID>,
"closeAdParts":false,
"redirectURL":"",
"includeInInteractionRate":true
}
],
"performAutoVideoTranscoding":false,
"adTranscodingStatus":"TRANSCODING_NOT_REQUIRED",
"variables":null,
"downloadMode":"POLITE",
"banner":{
"type":"AdAsset",
"id":<Auto Generated ID>,
"clientRefId":<Auto Generated ID>,
"relationsBag":<Auto Generated ID>,
"uiPermissions":null,
"version":null,
"assetId":<Auto Generated ID>,
"assetName":"<Auto Generated ID>",
"source":true,
"assetStatus":null,
"folderId":<Auto Generated ID>,
"size":19560,
"duration":0,
"bitRate":0,
"width":0,
"height":0,
"mimeType":"application/x-shockwave-flash",
"mediaType":"FLASH",
"thumbnailUrl":"<Auto Generated ID>"
},
"videoStartMethod":"USER_START",
"minFlashVersion":9.0,
"panels":[
{
"type":"Panel",
"id":<Auto Generated ID>,
"clientRefId":<Auto Generated ID>,
"relationsBag":null,
"uiPermissions":null,
"version":null,
"assetId":<Auto Generated ID>,
"assetName":"<Auto Generated ID>",
"source":false,
"assetStatus":"FAILED_INGEST",
"folderId":<Auto Generated ID>,
"size":19560,
"duration":0,
"bitRate":0,
"width":0,
"height":0,
"mimeType":"application/x-shockwave-flash",
"mediaType":"FLASH",
"thumbnailUrl":"<Auto Generated ID>",
"name":"Panel",
"defaultPanel":true,
"positionX":200.0,
"positionY":0.0,
"positionType":"BANNER_RELATIVE",
"autoExpand":true,
"delayedExpansion":true,
"retraction":"NEVER",
"transparent":true,
"autoGeneratedPanel":true
}
],
"panelsSettings":{
"type":"ExtendedPanelsSettings",
"panelFrequency":"UNLIMITED",
"panelFrequencyTimes":1,
"multiplePanels":true,
"autoExpandDefaultPanel":true,
"preloadPanels":false,
"delayExpansion":true,
"componentPositionX":200,
"componentPositionY":0,
"componentCollapsedSizeX":300,
"componentCollapsedSizeY":253,
"expandedPanelWidth":0,
"expandedPanelHeight":0,
"panelPixelOffsetsX":0,
"panelPixelOffsetsY":0
},
"mxpVersion":<Auto Generated ID>,
"osVersion":<Auto Generated ID>,
"asVersion":<Auto Generated ID>,
"flashIDE":<Auto Generated ID>,
"hides":<Auto Generated ID>
}
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk