---
title: Apps Data Objects
framework: Apple Ads Platform API
role: collectionGroup
role_heading: API Collection
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/apps-reports-objects
---

# Apps Data Objects

Request, response, and metadata objects for Apps report endpoints.

## Overview

Overview Apps reports cover the five apps reporting entities: campaigns, ad groups, ads, keywords, and search terms. Each entity has its own endpoint, request and response pair, and metadata schema, but all five share the same row shape and request structure described below. The five Apps reporting entities each have a dedicated endpoint.  |   |   |   |   |   |  Shared Object Model Every Apps report request uses AppsReportingRequest as its body. Every Apps report request must include a campaignId filter. Brands report requests don’t have this requirement. Each response row follows the same three-part shape: metadata: entity attributes (name, status, identifiers) plus any groupBy dimension value (deviceClass, ageRange, gender, countryCode, adminArea, locality, storefront, or countryOrRegion, with entity-level restrictions) applied to that row. Entity-specific metadata schemas define the fields available for each entity, including AppsReportingCampaign, AppsReportingAdGroup, AppsReportingAd, ReportingKeyword, and ReportingSearchTerm. Ad metadata nests creative details in an AppsReportingCreative object rather than a flat creative ID. totalMetrics: aggregate AppsMetrics (or entity variant, for example, AppsAdGroupMetrics) values for the row over the full requested date range. granularMetrics: an array of pure metrics objects, one per period in the requested granularity, with no dimension fields of their own. Only present when granularity is specified in the request. Each endpoint’s response envelope, row, and summary objects follow a consistent per-entity naming pattern, for example AppsCampaignReportResponse, AppsCampaignReportRow, and AppsCampaignResultContainer for campaigns, with equivalent objects for ad groups, ads, keywords, and search terms. For a side-by-side comparison of Apps and Brands reporting differences (groupBy dimensions, options, creative metadata), see Managing Reports.

## Topics

- [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)
- [AppsAdReportRow](apple-ads-platform-api/appsadreportrow.md)
- [AppsAdReportSummary](apple-ads-platform-api/appsadreportsummary.md)
- [AppsAdResultContainer](apple-ads-platform-api/appsadresultcontainer.md)
- [AppsKeywordReportResponse](apple-ads-platform-api/appskeywordreportresponse.md)
- [AppsKeywordReportRow](apple-ads-platform-api/appskeywordreportrow.md)
- [AppsKeywordReportSummary](apple-ads-platform-api/appskeywordreportsummary.md)
- [AppsKeywordResultContainer](apple-ads-platform-api/appskeywordresultcontainer.md)
- [AppsSearchTermReportResponse](apple-ads-platform-api/appssearchtermreportresponse.md)
- [AppsSearchTermReportRow](apple-ads-platform-api/appssearchtermreportrow.md)
- [AppsSearchTermReportSummary](apple-ads-platform-api/appssearchtermreportsummary.md)
- [AppsSearchTermResultContainer](apple-ads-platform-api/appssearchtermresultcontainer.md)
- [AppsMetrics](apple-ads-platform-api/appsmetrics.md)
- [AppsCampaignMetrics](apple-ads-platform-api/appscampaignmetrics.md)
- [AppsAdGroupMetrics](apple-ads-platform-api/appsadgroupmetrics.md)
- [AppsOptions](apple-ads-platform-api/appsoptions.md)
- [AppsTargetingProjection](apple-ads-platform-api/appstargetingprojection.md)

## See Also

### Reports

- [Managing Reports](apple-ads-platform-api/reports.md)
- [App Store Reports Endpoints](apple-ads-platform-api/apps-reports-endpoints.md)
- [Brands Reports Endpoints](apple-ads-platform-api/brands-reports-endpoints.md)
- [Brands Data Objects](apple-ads-platform-api/brands-reports-objects.md)
- [Shared Objects](apple-ads-platform-api/reports-shared-objects.md)