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

# AppsReportingCampaign

Campaign metadata for apps report rows.

## Declaration

```data
object AppsReportingCampaign
```

## Properties

id: The campaign’s unique identifier. promotedObject: See PromotedObject for details. promotedObjectType: Always APPSTORE_APP for Apple Ads campaigns. promotedObjectId: The Adam ID of the promoted App Store app. 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: The targeting field contains an AppsTargetingProjection snapshot of the campaign’s supply placement and App Store countries or regions targeted at the time of the report. See AppsTargetingProjection 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. countryOrRegion: Country or region groupBy dimension value. deviceClass: Device class groupBy dimension value. gender: Gender groupBy dimension value. ageRange: Age range groupBy dimension value. locality: Locality groupBy dimension value. countryCode: Country code groupBy dimension value. adminArea: Administrative area groupBy dimension value.

## Discussion

Discussion The AppsReportingCampaign object is the campaign metadata embedded in apps campaign report rows. It captures the campaign’s identity, operational status, budget, bid strategy, and targeting projection at report time. The groupBy dimensions specified in the report request determine the values of the dimension fields (countryOrRegion, deviceClass, gender, ageRange, etc.). Example {   "id": 555666777,   "promotedObject": {     "name": "AwayFinder"   },   "promotedObjectType": "APPSTORE_APP",   "promotedObjectId": "123456789",   "name": "AwayFinder - Search Results",   "status": "ENABLED",   "deleted": false,   "displayStatus": "RUNNING",   "modificationTime": "2025-01-10T08:00:00.000",   "creationTime": "2024-11-01T08:00:00.000",   "adAccountId": 987654321,   "systemStatus": "RUNNING",   "systemStatusReasons": [],   "billingEvent": "TAPS",   "systemStatusLimitingReasons": [],   "targeting": {     "supplyPlacement": {       "include": ["APPSTORE_SEARCH_RESULTS"]     },     "lifetimeStorefronts": {       "include": ["US"]     },     "countryOrRegion": {       "include": ["US"]     }   },   "dailyBudget": {     "value": {       "amount": "100.00",       "currency": "USD"     }   },   "startTime": "2024-11-01T08: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",   "countryOrRegion": "US",   "deviceClass": "IPHONE",   "gender": "F",   "ageRange": "25-34",   "locality": "San Francisco",   "countryCode": "US",   "adminArea": "CA" }

## Topics

### Type Aliases

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

## See Also

- [AppsReportingRequest](apple-ads-platform-api/appsreportingrequest.md)
- [AppsReportingAdGroup](apple-ads-platform-api/appsreportingadgroup.md)
- [AppsReportingAd](apple-ads-platform-api/appsreportingad.md)
- [AppsReportingCreative](apple-ads-platform-api/appsreportingcreative.md)
- [AppsCampaignReportResponse](apple-ads-platform-api/appscampaignreportresponse.md)
- [AppsCampaignReportRow](apple-ads-platform-api/appscampaignreportrow.md)
- [AppsCampaignReportSummary](apple-ads-platform-api/appscampaignreportsummary.md)
- [AppsCampaignResultContainer](apple-ads-platform-api/appscampaignresultcontainer.md)
- [AppsAdGroupReportResponse](apple-ads-platform-api/appsadgroupreportresponse.md)
- [AppsAdGroupReportRow](apple-ads-platform-api/appsadgroupreportrow.md)
- [AppsAdGroupReportSummary](apple-ads-platform-api/appsadgroupreportsummary.md)
- [AppsAdGroupResultContainer](apple-ads-platform-api/appsadgroupresultcontainer.md)
- [AppsAdReportResponse](apple-ads-platform-api/appsadreportresponse.md)
- [AppsAdReportRow](apple-ads-platform-api/appsadreportrow.md)
- [AppsAdReportSummary](apple-ads-platform-api/appsadreportsummary.md)