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

# AppsAdReportRow

A single row in an Apps ad-level report, containing ad metadata, total metrics, and optional granular time-series metrics.

## Declaration

```data
object AppsAdReportRow
```

## Properties

totalMetrics: See AppsMetrics for details. granularMetrics: Time-series metrics broken down by the requested granularity (for example, DAILY, WEEKLY). Present only when a granularity is specified in the request. When it isn’t, this field is absent and all data appears in totalMetrics instead. metadata: See AppsReportingAd for details.

## Discussion

Discussion The metadata field captures ad identifiers and configuration at report time. The totalMetrics field contains the aggregated performance figures across the full reporting period. Example {   "metadata": {     "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",     "storefront": "US"   },   "totalMetrics": {     "localSpend": {       "amount": "482.50",       "currency": "USD"     },     "impressions": 41230,     "taps": 980,     "ttr": 0.0238,     "cpt": {       "amount": "0.49",       "currency": "USD"     },     "cpm": {       "amount": "11.71",       "currency": "USD"     },     "tapInstalls": 312,     "tapInstallCPI": {       "amount": "1.55",       "currency": "USD"     },     "totalNewDownloads": 298,     "totalRedownloads": 41,     "viewInstalls": 27,     "totalInstalls": 339,     "tapNewDownloads": 285,     "tapRedownloads": 27,     "viewNewDownloads": 13,     "viewRedownloads": 14,     "totalAvgCPI": {       "amount": "1.42",       "currency": "USD"     },     "totalInstallRate": 0.346,     "tapInstallRate": 0.318,     "tapPreOrdersPlaced": 5,     "viewPreOrdersPlaced": 1,     "totalPreOrdersPlaced": 6   },   "granularMetrics": [     {       "date": "2025-02-01",       "localSpend": {         "amount": "17.25",         "currency": "USD"       },       "impressions": 1450,       "taps": 34,       "ttr": 0.0234,       "cpt": {         "amount": "0.51",         "currency": "USD"       },       "cpm": {         "amount": "11.90",         "currency": "USD"       },       "tapInstalls": 11,       "tapInstallCPI": {         "amount": "1.57",         "currency": "USD"       },       "totalNewDownloads": 10,       "totalRedownloads": 2,       "viewInstalls": 1,       "totalInstalls": 12,       "tapNewDownloads": 10,       "tapRedownloads": 1,       "viewNewDownloads": 0,       "viewRedownloads": 1,       "totalAvgCPI": {         "amount": "1.44",         "currency": "USD"       },       "totalInstallRate": 0.353,       "tapInstallRate": 0.324,       "tapPreOrdersPlaced": 0,       "viewPreOrdersPlaced": 0,       "totalPreOrdersPlaced": 0     }   ] }

## See Also

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