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

# AppsAdReportResponse

The top-level response envelope for apps ad-level reports.

## Declaration

```data
object AppsAdReportResponse
```

## Properties

result: Wraps the array of ad report rows, each containing ad metadata and associated metrics. If no rows match the request, result is returned as an empty object. See AppsAdResultContainer for details. pagination: Allows paging through all matching ads. See ResponsePagination for details. error: Populated with an ErrorResponse when the request fails. See ErrorResponse for details.

## Discussion

Discussion Check for error before processing result. Note that ad-level reports don’t support HOURLY granularity. Example {   "result": {     "rows": [       {         "metadata": {           "id": 234567891,           "name": "AwayFinder Default Ad",           "adAccountId": 123456789,           "campaignId": 444555666,           "adGroupId": 555666777,           "status": "ENABLED",           "deleted": false         },         "totalMetrics": {           "localSpend": {             "amount": "150.00",             "currency": "USD"           },           "impressions": 10000,           "taps": 500,           "ttr": 0.05,           "cpt": {             "amount": "0.30",             "currency": "USD"           },           "tapInstalls": 120,           "totalInstalls": 145         },         "granularMetrics": [           {             "date": "2025-01-01",             "localSpend": {               "amount": "4.80",               "currency": "USD"             },             "impressions": 330,             "taps": 16,             "tapInstalls": 4           }         ]       }     ],     "summary": {       "grandTotal": {         "localSpend": {           "amount": "150.00",           "currency": "USD"         },         "impressions": 10000,         "taps": 500,         "tapInstalls": 120       }     }   },   "pagination": {     "offset": 0,     "pageSize": 20,     "totalCount": 1   } }

## 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)
- [AppsAdReportRow](apple-ads-platform-api/appsadreportrow.md)
- [AppsAdReportSummary](apple-ads-platform-api/appsadreportsummary.md)