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

# AppsAdGroupReportResponse

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

## Declaration

```data
object AppsAdGroupReportResponse
```

## Properties

result: Wraps the array of report rows. If no rows match the request, result is returned as an empty object. See AppsAdGroupResultContainer for details. pagination: Pagination metadata to support paging through large result sets. See ResponsePagination for details. error: Populated with an ErrorResponse when the request fails or partially fails. See ErrorResponse for details.

## Discussion

Discussion Check for the presence of error before processing result to handle failure cases cleanly. Example {   "result": {     "rows": [       {         "totalMetrics": {           "date": "2025-01-10",           "localSpend": {             "amount": "412.75",             "currency": "USD"           },           "impressions": 305000,           "taps": 5100,           "ttr": 0.0167,           "totalInstalls": 640,           "totalAvgCPI": {             "amount": "0.64",             "currency": "USD"           }         },         "granularMetrics": [],         "metadata": {           "id": 555666777,           "campaignId": 987654321,           "adAccountId": 123456789,           "name": "AwayFinder - Apps Ad Group",           "status": "ENABLED",           "deleted": false,           "creationTime": "2025-01-10T08:00:00.000",           "modificationTime": "2025-01-10T08:00:00.000"         }       }     ],     "summary": {       "grandTotal": {         "date": "2025-01-10",         "localSpend": {           "amount": "412.75",           "currency": "USD"         },         "impressions": 305000,         "taps": 5100,         "ttr": 0.0167,         "totalInstalls": 640,         "totalAvgCPI": {           "amount": "0.64",           "currency": "USD"         }       }     }   },   "pagination": {     "pageSize": 20,     "offset": 0,     "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)
- [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)