Note
Note: The Required column includes the following values:
-
Required: The field must be included in the POST call.
-
Read-only: The field is received in the GET call and required in the PUT call. It is not required in the POST call. You cannot edit this field.
-
Optional: If the field was received in the GET call, include it in the PUT call. This field is editable.
-
Internal: (For Amazon Ad Server (AAS) internal use) If the field was received in the GET call, include it in the PUT call.
Name |
description |
Type |
Required |
notes |
---|---|---|---|---|
allowHTML5DynamicExpansion |
Enables the system to automatically detect the direction in which HTML5 expandable ads should expand during serving. |
Boolean |
Required |
Required in a programmatic environment, where the location of the ad that will be displayed is not known in advance. |
analyticsData |
Contains a set of analytics metrics. Appears in a box on the placements page. |
Read-only |
||
actualStartDate |
First impression date (Date epoch). |
Long |
Read-only |
|
controlOverDelivery |
Internal. |
Internal |
Internal |
|
supportMobileApplications |
Internal. |
Internal |
Internal |
|
bandwidth |
Internal. |
Internal |
Internal |
|
hardStop |
Internal. |
Internal |
Internal |
|
attached |
Determines whether placement is attached to an ad. |
Boolean |
Read-only |
|
placementAttachmentData |
Object that describes the placement's attachment. |
Read-only |
||
placementAdCount |
Number of ads attached to placement. |
Integer |
Read-only |
|
placementMV |
Determines whether placement is mass version. |
Boolean |
Required |
True when a placement is attached to a DCO ad. |
createdBy |
ID of the user who created the placement. |
Long |
Read-only |
|
createdByName |
Name of the user who created the placement. |
Long |
Read-only |
|
createdByAccount |
ID of the account of the user who created the placement. |
Long |
Read-only |
|
createdByAccountName |
Name of the account of the user who created the placement. |
String |
Read-only |
|
createdOn |
Date and time on which the placement was created (Date epoch). |
Long |
Read-only |
|
campaignName |
Placement campaign name. |
String |
Read-only |
Searchable field for placement. |
lastUpdatedBy |
ID of the user who last updated the placement. |
Long |
Read-only |
|
lastUpdatedByName |
Name of the user who last updated the placement. |
String |
Read-only |
|
lastUpdatedByAccount |
ID of the account of the user who last updated the placement. |
Long |
Read-only |
|
lastUpdatedByAccountName |
Name of the account of the user who last updated the placement. |
String |
Read-only |
|
lastUpdateOn |
Date and time on which the placement was last updated (Date epoch). |
Long |
Read-only |
|
relationsBag |
Internal. |
Internal |
||
bannerSize |
Height and width of banner size. |
Required |
||
campaignId |
Placement's campaign ID. |
Long |
Required |
Searchable field for placement. |
cookieSyncType |
Internal. |
Internal |
Internal |
|
customFields |
Custom fields display custom metadata that can be used, for example, as a token on click-throughs and 3rd party events, or in AASreporting. |
Optional |
||
disableCookies |
Disable or enable cookies for placement. |
Boolean |
Required |
|
placementDGData |
Internal. |
Internal |
Internal |
|
id |
ID of the placement. |
Long |
Read-only |
|
mobileApplicationAdEnabler |
Type of mobile support. |
String |
Required |
|
name |
Name of the placement. |
String |
Required |
|
lastPublished |
Last time placement was published. |
Long |
Read-only |
Stored in Epoch time. |
packageId |
Placement package ID. |
Long |
Optional |
Searchable field for placement. |
packageName |
Name of package for this placement. AAS creates a default package if none exists for the placement. |
String |
Read-only |
Searchable field for placement. |
placementType |
Type of placement. |
String |
Required |
Value: IN_BANNER |
publisherTargetingIds |
Media targeting audience assigned to placement. |
Long |
Optional |
|
sectionId |
ID of Site section where the placement will serve. |
Long |
Optional |
|
sectionName |
Name of Site section where the placement will serve. |
String |
Optional |
|
servingAndCostData |
Serving and cost data for placement. |
Required |
||
siteId |
Placement site ID. |
Long |
Required |
Searchable field for placement and placement package. |
status |
Placement status. |
String |
Read-only |
Searchable field for placement. |
tagBuilderParams |
Parameters to build tag for placement. |
Optional |
||
type |
Type of entity. |
String |
Required |
Value: In-Banner Placement |
Comments