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.
Parameter |
Description |
Type |
Required |
Notes |
---|---|---|---|---|
type |
Type of entity. |
String |
Required |
AdvancedCompanion |
companionId |
ID of the asset to be used. |
Long |
Required |
|
companionResourceType |
Method by which |
String |
Required |
|
companionName |
Name of the companion ad. |
String |
Required |
|
width |
Width of the companion ad. |
Long |
Read-only |
|
height |
Height of the companion ad. |
Long |
Read-only |
|
size |
Size (in KB) of the companion ad. |
Long |
Read-only |
|
clickthrough |
Clickthrough URL to navigate to when clicking on companion ad. |
String |
Optional |
|
alternateText |
Text to be shown in case companion ad failed to load. |
String |
Optional |
|
placementId |
ID of the placement to which the ad is attached. |
Long |
Required |
|
campaignId |
ID of the campaign to which the ad is assigned. |
Long |
Required |
|
companionFormat |
Ad format of the companion ad. |
String |
Required |
|
id |
ID of the ad. |
Long |
Read-only |
|
relationsBag |
Internal. |
Read-only |
This object enables you to view the parent object of an object, for example, the account ID and name of an advertiser. This saves time because you do not need to call another call to get these details.
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 |
---|---|---|---|---|
parents |
This is an object of the entities that are related to this object, and depends on the object type.For example, a campaign will include "account", "advertiser", and "brand" data. An advertiser will only include the "account". |
Read-only |
||
children |
Includes the count of the related entities. |
Read-only |
||
creativeAccountContact |
Internal. |
Boolean |
Read-only |
Name |
Description |
Type |
Required |
Notes |
---|---|---|---|---|
account |
Parent account of current entity (if applicable). |
Object |
Read-Only |
Example: { "id": 1072241834, "name": "testing account", "internal": false } |
advertiser |
Parent advertiser of current entity (if applicable). |
Object |
Read-Only |
Example: { "id": 1073741822, "name": "AAA" } |
brand |
Parent brand of current entity (if applicable). |
Object |
Read-Only |
Example: { "id": 1073741833, "name": "BBB" } |
campaign |
Parent campaign of current entity (if applicable). |
Object |
Read-Only |
Example: { "id": 1073741831, "name": "ccc" } |
site |
Parent site of current entity (if applicable). |
Object |
Read-Only |
Example: { "id": 1073741853, "name": "ddd" } |
Name |
Description |
Type |
Required |
Notes |
---|---|---|---|---|
advertisers |
Contains the count of child advertisers (if applicable). |
Object |
Read-Only |
|
brands |
Contains the count of child brands (if applicable). |
Object |
Read-Only |
|
campaigns |
Contains the count of child campaigns (if applicable). |
Object |
Read-Only |
|
users |
Contains the count of child users (if applicable). |
Object |
Read-Only |
Comments