# Apps Data Objects Request, response, and metadata objects for Apps report endpoints. ## 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. |Entity |Endpoint | |-----------|---------------------------------------------------------------------------------------------------------| |Campaign | | |Ad Group | | |Ad | | |Keyword | | |Search Term|| ### Shared Object Model Every Apps report request uses [`AppsReportingRequest`](/documentation/Apple-Ads-Platform-API/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`](/documentation/Apple-Ads-Platform-API/AppsReportingCampaign), [`AppsReportingAdGroup`](/documentation/Apple-Ads-Platform-API/AppsReportingAdGroup), [`AppsReportingAd`](/documentation/Apple-Ads-Platform-API/AppsReportingAd), [`ReportingKeyword`](/documentation/Apple-Ads-Platform-API/ReportingKeyword), and [`ReportingSearchTerm`](/documentation/Apple-Ads-Platform-API/ReportingSearchTerm). Ad metadata nests creative details in an [`AppsReportingCreative`](/documentation/Apple-Ads-Platform-API/AppsReportingCreative) object rather than a flat creative ID. - `totalMetrics`: aggregate [`AppsMetrics`](/documentation/Apple-Ads-Platform-API/AppsMetrics) (or entity variant, for example, [`AppsAdGroupMetrics`](/documentation/Apple-Ads-Platform-API/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`](/documentation/Apple-Ads-Platform-API/AppsCampaignReportResponse), [`AppsCampaignReportRow`](/documentation/Apple-Ads-Platform-API/AppsCampaignReportRow), and [`AppsCampaignResultContainer`](/documentation/Apple-Ads-Platform-API/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](/documentation/Apple-Ads-Platform-API/reports). ## Topics [`AppsReportingRequest`](/documentation/Apple-Ads-Platform-API/AppsReportingRequest) [`AppsReportingCampaign`](/documentation/Apple-Ads-Platform-API/AppsReportingCampaign) [`AppsReportingAdGroup`](/documentation/Apple-Ads-Platform-API/AppsReportingAdGroup) [`AppsReportingAd`](/documentation/Apple-Ads-Platform-API/AppsReportingAd) [`AppsReportingCreative`](/documentation/Apple-Ads-Platform-API/AppsReportingCreative) [`AppsCampaignReportResponse`](/documentation/Apple-Ads-Platform-API/AppsCampaignReportResponse) [`AppsCampaignReportRow`](/documentation/Apple-Ads-Platform-API/AppsCampaignReportRow) [`AppsCampaignReportSummary`](/documentation/Apple-Ads-Platform-API/AppsCampaignReportSummary) [`AppsCampaignResultContainer`](/documentation/Apple-Ads-Platform-API/AppsCampaignResultContainer) [`AppsAdGroupReportResponse`](/documentation/Apple-Ads-Platform-API/AppsAdGroupReportResponse) [`AppsAdGroupReportRow`](/documentation/Apple-Ads-Platform-API/AppsAdGroupReportRow) [`AppsAdGroupReportSummary`](/documentation/Apple-Ads-Platform-API/AppsAdGroupReportSummary) [`AppsAdGroupResultContainer`](/documentation/Apple-Ads-Platform-API/AppsAdGroupResultContainer) [`AppsAdReportResponse`](/documentation/Apple-Ads-Platform-API/AppsAdReportResponse) [`AppsAdReportRow`](/documentation/Apple-Ads-Platform-API/AppsAdReportRow) [`AppsAdReportSummary`](/documentation/Apple-Ads-Platform-API/AppsAdReportSummary) [`AppsAdResultContainer`](/documentation/Apple-Ads-Platform-API/AppsAdResultContainer) [`AppsKeywordReportResponse`](/documentation/Apple-Ads-Platform-API/AppsKeywordReportResponse) [`AppsKeywordReportRow`](/documentation/Apple-Ads-Platform-API/AppsKeywordReportRow) [`AppsKeywordReportSummary`](/documentation/Apple-Ads-Platform-API/AppsKeywordReportSummary) [`AppsKeywordResultContainer`](/documentation/Apple-Ads-Platform-API/AppsKeywordResultContainer) [`AppsSearchTermReportResponse`](/documentation/Apple-Ads-Platform-API/AppsSearchTermReportResponse) [`AppsSearchTermReportRow`](/documentation/Apple-Ads-Platform-API/AppsSearchTermReportRow) [`AppsSearchTermReportSummary`](/documentation/Apple-Ads-Platform-API/AppsSearchTermReportSummary) [`AppsSearchTermResultContainer`](/documentation/Apple-Ads-Platform-API/AppsSearchTermResultContainer) [`AppsMetrics`](/documentation/Apple-Ads-Platform-API/AppsMetrics) [`AppsCampaignMetrics`](/documentation/Apple-Ads-Platform-API/AppsCampaignMetrics) [`AppsAdGroupMetrics`](/documentation/Apple-Ads-Platform-API/AppsAdGroupMetrics) [`AppsOptions`](/documentation/Apple-Ads-Platform-API/AppsOptions) [`AppsTargetingProjection`](/documentation/Apple-Ads-Platform-API/AppsTargetingProjection) --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)