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

# BrandsReportingCampaign

Campaign metadata for Apple Maps report rows.

## Declaration

```data
object BrandsReportingCampaign
```

## Properties

id: The campaign’s unique identifier. promotedObject: See PromotedObject for details. promotedObjectType: Possible values: BUSINESS_BRAND. promotedObjectId: The brand ID of the promoted Maps business. name: The campaign name as configured at report time. status: Possible values: ENABLED, PAUSED. deleted: Whether the campaign has been soft-deleted. displayStatus: System-computed, rolled-up delivery state combining status and systemStatus into a single label. See CampaignDisplayStatus. modificationTime: Timestamp of the campaign’s last modification (ISO 8601). creationTime: Timestamp when the campaign was created (ISO 8601). adAccountId: The ad account this campaign belongs to. systemStatus: Possible values: RUNNING, NOT_RUNNING. systemStatusReasons: System-applied reasons contributing to the current systemStatus. See CampaignSystemStatusReason for possible values. billingEvent: Possible values: TAPS, IMPRESSIONS. systemStatusLimitingReasons: System-applied reasons limiting delivery below maximum potential. See CampaignSystemLimitedStatusReason for possible values. targeting: See BrandsTargetingProjection for details. dailyBudget: See ReportingMoney for details. startTime: Campaign start time. endTime: Campaign end time. lifetimeBudget: Lifetime budget for the campaign. See ReportingMoney for details. bidStrategy: See ReportingBidStrategy for details. adChannelType: The advertising channel type for this campaign. Possible values: SEARCH, DISPLAY. deviceClass: Device class groupBy dimension value. locationId: Location ID groupBy dimension value. supplyPlacement: Supply placement groupBy dimension value.

## Discussion

Discussion The BrandsReportingCampaign object is the campaign metadata embedded in brands campaign report rows. It captures the campaign’s full configuration at report time: identity, budget (dailyBudget), bid strategy, billing event, and the BrandsTargetingProjection snapshot of active supply placement and location targeting. The promotedObjectType field is always BUSINESS_BRAND for Maps-based campaigns. The system populates the brands dimension fields (deviceClass, locationId, supplyPlacement) based on the groupBy dimensions in the report request. Example {   "id": 555666777,   "promotedObject": {     "name": "AwayFinder Downtown"   },   "promotedObjectType": "BUSINESS_BRAND",   "promotedObjectId": "123456789",   "name": "AwayFinder Apple Maps Campaign",   "status": "ENABLED",   "deleted": false,   "displayStatus": "RUNNING",   "modificationTime": "2025-01-10T08:00:00.000",   "creationTime": "2025-01-05T08:00:00.000",   "adAccountId": 987654321,   "systemStatus": "RUNNING",   "systemStatusReasons": [],   "billingEvent": "IMPRESSIONS",   "systemStatusLimitingReasons": [],   "targeting": {     "supplyPlacement": {       "include": ["MAPS_SEARCH_RESULTS", "MAPS_SEARCH_HOME"]     },     "lifetimeStorefronts": {       "include": ["US", "CA"]     },     "supplySource": {       "include": ["MAPS"]     },     "promotedLocationGroup": {       "include": ["555666777"]     },     "promotedLocation": {       "include": ["123456789"]     }   },   "dailyBudget": {     "value": {       "amount": "50.00",       "currency": "USD"     }   },   "startTime": "2025-01-10T08:00:00.000",   "endTime": "2025-12-31T08:00:00.000",   "lifetimeBudget": {     "value": {       "amount": "5000.00",       "currency": "USD"     }   },   "bidStrategy": {     "bidStrategyType": "MANUAL_CPT",     "bid": {       "amount": "1.50",       "currency": "USD"     }   },   "adChannelType": "SEARCH",   "deviceClass": "IPHONE",   "locationId": "123456789",   "supplyPlacement": "MAPS_SEARCH_RESULTS" }

## Topics

### Type Aliases

- [BrandsReportingCampaign.AdChannelType](apple-ads-platform-api/brandsreportingcampaign/adchanneltype-data.typealias.md)
- [BrandsReportingCampaign.BillingEvent](apple-ads-platform-api/brandsreportingcampaign/billingevent-data.typealias.md)
- [BrandsReportingCampaign.Status](apple-ads-platform-api/brandsreportingcampaign/status-data.typealias.md)
- [BrandsReportingCampaign.SystemStatus](apple-ads-platform-api/brandsreportingcampaign/systemstatus-data.typealias.md)

## See Also

- [BrandsReportingRequest](apple-ads-platform-api/brandsreportingrequest.md)
- [BrandsReportingAdGroup](apple-ads-platform-api/brandsreportingadgroup.md)
- [BrandsReportingAd](apple-ads-platform-api/brandsreportingad.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)