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

# AppsReportingAd

Ad metadata for apps report rows.

## Declaration

```data
object AppsReportingAd
```

## 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 AppsReportingCreative for details. countryOrRegion: Country or region groupBy dimension value, populated when countryOrRegion is specified in the request’s groupBy. deviceClass: Device class groupBy dimension value, populated when deviceClass is specified in the request’s groupBy.

## Discussion

Discussion The AppsReportingAd object is the ad metadata embedded in apps ad report rows. It captures the configuration and status of the ad at report time, providing the full organizational context (adAccountId, campaignId, adGroupId) alongside the ad’s operational state (status, systemStatus, displayStatus). The creative field embeds an AppsReportingCreative summary capturing the creative type and system status, without needing a separate lookup. Example {   "id": 555666777,   "name": "AwayFinder - Search Ad",   "deleted": false,   "status": "ENABLED",   "systemStatus": "RUNNING",   "systemStatusReasons": [],   "systemStatusLimitingReasons": [],   "adAccountId": 123456789,   "campaignId": 234567890,   "adGroupId": 345678901,   "creationTime": "2025-01-10T08:00:00.000",   "modificationTime": "2025-02-01T12:30:00.000",   "displayStatus": "RUNNING",   "creative": {     "id": 456789012,     "creativeType": "DEFAULT_PRODUCT_PAGE",     "systemStatus": "VALID"   },   "countryOrRegion": "US",   "deviceClass": "IPHONE" }

## Topics

### Type Aliases

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

## See Also

- [AppsReportingRequest](apple-ads-platform-api/appsreportingrequest.md)
- [AppsReportingCampaign](apple-ads-platform-api/appsreportingcampaign.md)
- [AppsReportingAdGroup](apple-ads-platform-api/appsreportingadgroup.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)