---
title: BrandsReportingAd
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/brandsreportingad
---

# BrandsReportingAd

Ad metadata for brands report rows.

## Declaration

```data
object BrandsReportingAd
```

## Properties

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

## Discussion

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" }

## Topics

### Type Aliases

- [BrandsReportingAd.Status](apple-ads-platform-api/brandsreportingad/status-data.typealias.md)
- [BrandsReportingAd.SystemStatus](apple-ads-platform-api/brandsreportingad/systemstatus-data.typealias.md)

## See Also

- [BrandsReportingRequest](apple-ads-platform-api/brandsreportingrequest.md)
- [BrandsReportingCampaign](apple-ads-platform-api/brandsreportingcampaign.md)
- [BrandsReportingAdGroup](apple-ads-platform-api/brandsreportingadgroup.md)
- [BrandsReportingCreative](apple-ads-platform-api/brandsreportingcreative.md)
- [BrandsReportingKeyword](apple-ads-platform-api/brandsreportingkeyword.md)
- [BrandsReportingSearchTerm](apple-ads-platform-api/brandsreportingsearchterm.md)
- [BrandsCampaignReportResponse](apple-ads-platform-api/brandscampaignreportresponse.md)
- [BrandsCampaignReportRow](apple-ads-platform-api/brandscampaignreportrow.md)
- [BrandsCampaignReportSummary](apple-ads-platform-api/brandscampaignreportsummary.md)
- [BrandsCampaignResultContainer](apple-ads-platform-api/brandscampaignresultcontainer.md)
- [BrandsAdGroupReportResponse](apple-ads-platform-api/brandsadgroupreportresponse.md)
- [BrandsAdGroupReportRow](apple-ads-platform-api/brandsadgroupreportrow.md)
- [BrandsAdGroupReportSummary](apple-ads-platform-api/brandsadgroupreportsummary.md)
- [BrandsAdGroupResultContainer](apple-ads-platform-api/brandsadgroupresultcontainer.md)
- [BrandsAdReportResponse](apple-ads-platform-api/brandsadreportresponse.md)