Definition of Various Parameters Generated Across the Advertiser Attributes Snapshot Reports

Please refer to below tables for different parameters available for "advertiserAttributes" and "advertiserAttributesV2" insightType.

advertiserAttributes

ElementDescriptionType
accessGrantTimeStampDate timestamp for when access was granteddate-time
accountSpendLimitReachedValue for 3p advertisers:
  • 1 for reached/exceeded
  • 0 for within limit
Value for 1p advertisers:
  • N/A
string
advertiserIdID of the advertiserinteger
advertiserNameName of the advertiserstring
advertiserTypeType of advertiser. Possible values are: 1p,3pstring
apiAccessTypeRead or Write API access for given advertiserstring
reportDateSpecific date when report is pulleddate
sellerIdID of the seller for advertiser type 3pinteger

advertiserAttributesV2

ElementDescriptionType
accountSpendLimitReachedValue for 3p advertisers:
  • 1 for reached/exceeded
  • 0 for within limit
Value for 1p advertisers:
  • N/A
NOTE: As part of the seamless activation and management capabilities, an organization may be paused if the cumulative spend of its associated advertising accounts exceeds the organization's spend limit.
string
advertiserIdID of the advertiserinteger
advertiserNameName of the advertiserstring
advertiserTypeType of advertiser. Possible values are: 1p,3pstring
approvedBrandNamesList of approved brand names at an advertiser account level that are eligible for Sponsored Brands and Sponsored Videos campaignsList of string
organizationIdUnique identifier for Organization that contains multiple advertiser accountsinteger
organizationNameName of the Organization associated with the organizationIdstring
reportDateSpecific date when report is pulleddate
sellerIdID of the seller for advertiser type 3pinteger
sellerNameName of the seller for advertiser type 3pstring
advertiserAccessGranular permissions given to user for each resource groupList of objects. The advertiserAccess object contains information for following elements:
  • "resourceGroupName"
  • "permissionType"
  • "grantTimeStamp"
Please find more details about these elements in the respective tables below

NOTE:
Granular access details are provided in the "advertiserAccess" field, indicating the specific permissions a partner has for an advertiser account across key capabilities such as Campaign Management, Reporting, and Creative.

If the partner does not have access on the advertiser account for the supported resource group, the values will not be populated in the report.

resourceGroupName

Resource Group NameDescription
REPORTINGAccess to the Reporting resource group enables a technology provider to view the performance data of campaigns and identify trends for optimization.
CAMPAIGN_MANAGERAccess to the Campaign Manager resource group enables a technology provider to create, update, optimize campaigns, and access asset library.
CREATIVE_HUBAccess to the Creative Hub resource group enables a technology provider to upload assets, build, preview and submit creatives.

permissionType

Permission TypeDescription
Edit"Edit" permission on the resource group provides "Edit" permission on relevant APIs across Search and Display.
View Only"View Only" permission on the resource group provides "View Only" permission on relevant APIs across Search and Display

grantTimeStamp

Permission TypeDescription
grantTimeStampProvides timestamp details indicating when permissions were created or last updated for the associated resourceGroupName.