Submit a request
 
PRODUCT
Privacy Policy |  AAS Advertising Policy | Terms of Use
Cookie Preference
✖

Amazon Ad Server will be sunset in Q4 2024, please visit this page (AAS offboarding information) for offboarding support resources and sunset FAQs. Details shared on that page represent the most up to date information in the Help Center, if you find disparate information in other resources please default to the information in the AAS offboarding information page accordingly.

Please note that on October 1, 2024, the ability to create new campaigns, placements, and tag managers will be disabled.

Follow
Last Update:
  viewable by end users
  editable by agents

Related Entities

Endpoints Using the Brand Object

Object Definition

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

type

Type of entity.

String

Required

Value: Brand

id

ID of brand.

Long

Read-only

Auto-generated, read-only value.

relationsBag

Internal.

relationsBag Object

Internal

version

Internal.

String

Internal

createdBy

ID of the user that created the brand.

Long

Read-only

createdByName

Name of the user that created the entity.

String

Read-only

createdByAccount

ID of the account that created the entity.

Long

Read-only

createdByAccountName

Name of the account that created the entity.

String

Read-only

createdOn

Date of creation (date epoch).

Long

Read-only

lastUpdatedBy

ID of the user that was last to update the entity.

Long

Read-only

lastUpdatedByName

Name of the user that was last to update the entity

String

Read-only

lastUpdatedByAccount

ID of the account that was last to update the entity

Long

Read-only

lastUpdatedByAccountName

Parent advertiser analytics settings

String

Read-only

lastUpdateOn

Date of last update (date epoch).

Long

Read-only

name

Name of brand.

String

Required

advertiserId

ID of advertiser.

Integer

Required

vertical

Advertising niche for the brand.

String

Required
View values

  • Apparel

  • Auto

  • B2B

  • Career

  • Consumer Packaged Goods

  • Corporate

  • Electronics

  • Entertainment

  • Financial

  • Gambling

  • Government/Utilities

  • Health/Beauty

  • Insurance

  • Medical

  • News/Media

  • Other

  • Restaurant

  • Retail

  • Services

  • Sports

  • Tech/Internet

  • Telecom

  • Travel

status

Brand status.

String

Read-only
View values

  • Live

  • Idle

  • New

  • Published

  • PendingIO

  • Enabled

adminSettings

Object container for joined setting of admin entities.

adminSettings Object

Optional with default values

customFields

Custom field values on entity level, each field must have metadata definition on parent account.

customFields Object

Optional

accessLevel

Internal

Internal

Internal
View values

  • Basic

  • Full

  • Limited

Object JSON Example

Example
{
        "result": {
                "type": "Brand",
                "id": 1083756700,
                "relationsBag": {
                        "parents": {
                                "account": {
                                        "id": 312,
                                        "name": "Analytics Training",
                                        "internal": false
                                },
                                "advertiser": {
                                        "id": 37721,
                                        "name": "#[2_LL_advp911"
                                },
                                "brand": null,
                                "campaign": null,
                                "site": null
                        },
                        "children": {
                                "advertisers": {
                                        "count": 0
                                },
                                "brands": {
                                        "count": 0
                                },
                                "campaigns": {
                                        "count": 0
                                },
                                "users": {
                                        "count": 0
                                }
                        },
                        "creativeAccountContact": false
                },
                "version": 1536845374212866048,
                "createdBy": 1073741800,
                "createdByName": "User",
                "createdByAccount": 1073741800,
                "createdByAccountName": "Account",
                "createdOn": 1536844470767,
                "lastUpdatedBy": 1073741800,
                "lastUpdatedByName": "User",
                "lastUpdatedByAccount": 1073741800,
                "lastUpdatedByAccountName": "Account",
                "lastUpdateOn": 1536845374209,
                "name": "Brand-1",
                "advertiserId": 37721,
                "vertical": "Gaming",
                "status": "Enabled",
                "adminSettings": {
                        "type": "AdminSettings",
                        "regionalSettings": {
                                "type": "RegionalSettings",
                                "defaultTimeZone": "GMT_Plus_02",
                                "market": null
                        },
                        "defaultContacts": {
                                "type": "DefaultContacts",
                                "relationsBag": null,
                                "sizmekContacts": [{
                                        "type": "DefaultSizmekContact",
                                        "id": 41016402804700,
                                        "clientRefId": "4f23194a-87e2-5fed-0c57-f25e6e8c7c24",
                                        "relationsBag": null,
                                        "contactId": 1073741800,
                                        "name": "FirstSizmekUser",
                                        "campaignRole": "ClientServicesManager"
                                },
                                {
                                        "type": "DefaultSizmekContact",
                                        "id": 41016402804700,
                                        "clientRefId": "783e6026-793b-4469-3259-fc3394475b4f",
                                        "relationsBag": null,
                                        "contactId": 1073741800,
                                        "name": "FirstSizmekUser",
                                        "campaignRole": "SalesManager"
                                }],
                                "campaignManagerContacts": [],
                                "creativeManagerContacts": [],
                                "creativeAccounts": [],
                                "siteContacts": []
                        },
                        "thirdPartyTracking": null,
                        "servingSettings": {
                                "type": "ServingSettings",
                                "collectBelowTheFold": false,
                                "dfCollectionID": null,
                                "pathLength": null,
                                "visibilityMinimumSurface": 0,
                                "visibilityMinimumDuration": 0,
                                "agencyVisibilityMinimumDuration": 0,
                                "agencyVisibilityMinimumSurface": 0,
                                "adChoicesCertificationProgramID": 0,
                                "adChoicesClickthroughURL": "",
                                "disableCookie": false,
                                "saveAdCookie": true,
                                "retargetingCookieWindow": 0,
                                "deviceIntelligenceTypeId": 0
                        },
                        "campaignSettings": {
                                "type": "CampaignSettings",
                                "hardStopMethod": "KEEP_SERVING_AS_USUAL",
                                "creativeManagerAccess": true,
                                "traffickingMode": "AdvancedMode",
                                "targetAudiencePriorityPolicy": "Server"
                        },
                        "privacy": {
                                "type": "Privacy",
                                "adMarker": {
                                        "includeInAllAds": false,
                                        "regulationProgram": "IAB_EU",
                                        "markerClickthroughURL": null
                                },
                                "disableCookies": false
                        },
                        "video": {
                                "type": "Video",
                                "autoTranscode": true
                        }
                },
                "customFields": null,
                "accessLevel": "Full"
        }
}
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments