BrandsReportingAd

Ad metadata for brands report rows.

Declaration

object BrandsReportingAd

Properties

Name	Type	Description
`id`	int64	The ad’s unique identifier.
`name`	string	The ad name as configured at report time.
`deleted`	boolean	Whether the ad has been soft-deleted.
`status`	`BrandsReportingAd.Status`	Possible values: `ENABLED`, `PAUSED`.
`systemStatus`	`BrandsReportingAd.SystemStatus`	Possible values: `RUNNING`, `NOT_RUNNING`.
`systemStatusReasons`	[`AdSystemStatusReason`]	System-applied reasons contributing to the current `systemStatus`.
`systemStatusLimitingReasons`	[string]	Status-limiting reasons applied based on advertiser and system factors.
`adAccountId`	int64	The ad account this ad belongs to.
`campaignId`	int64	The campaign this ad belongs to.
`adGroupId`	int64	The ad group this ad belongs to.
`creationTime`	date-time	Timestamp when the ad was created (ISO 8601).
`modificationTime`	date-time	Timestamp of the ad’s last modification (ISO 8601).
`displayStatus`	string	System-computed, rolled-up delivery state combining ad, ad group, and campaign conditions.
`creative`	`BrandsReportingCreative`	See BrandsReportingCreative for details.
`deviceClass`	string	Device class groupBy dimension value.
`locationId`	string	Location ID groupBy dimension value.
`supplyPlacement`	string	Supply placement groupBy dimension value.

Discussion

The BrandsReportingAd object is the ad metadata embedded in brands ad report rows. It provides the full organizational context (adAccountId, campaignId, adGroupId) and the ad’s operational state (status, systemStatus, displayStatus) as captured at report time.

The creative field embeds a BrandsReportingCreative summary with the creative type and validity status. The system populates the brands-specific dimension fields (deviceClass, locationId, supplyPlacement) when the report’s groupBy specification includes those dimensions.

Example

{
  "id": 555666777,
  "name": "AwayFinder - Brands Ad",
  "deleted": false,
  "status": "ENABLED",
  "systemStatus": "RUNNING",
  "systemStatusReasons": [],
  "systemStatusLimitingReasons": [],
  "adAccountId": 123456789,
  "campaignId": 987654321,
  "adGroupId": 246813579,
  "creationTime": "2025-01-10T08:00:00.000",
  "modificationTime": "2025-01-15T09:30:00.000",
  "displayStatus": "RUNNING",
  "creative": {
    "id": 135792468,
    "creativeType": "LOCAL_ADS_SEARCH_CREATIVE",
    "systemStatus": "VALID"
  },
  "deviceClass": "IPHONE",
  "locationId": "1",
  "supplyPlacement": "MAPS_SEARCH_RESULTS"
}

BrandsReportingAd

Declaration

Properties

Discussion

Example

Topics

Type Aliases

See Also