---
title: Brands 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/brands-reports-objects
---

# Brands Data Objects

Explore the request, response, and metadata objects that Brands report endpoints use.

## Overview

Overview Brands reports cover the five business-brands 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 Brands reporting entities each have a dedicated endpoint.  |   |   |   |   |   |  Shared Object Model Every Brands report request uses BrandsReportingRequest as its body. Each response row follows the same three-part shape: metadata: entity attributes (name, status, identifiers) plus any groupBy dimension value (deviceClass, locationId, or supplyPlacement) applied to that row. Entity-specific metadata schemas define the fields available for each entity, including BrandsReportingCampaign, BrandsReportingAdGroup, BrandsReportingAd, BrandsReportingKeyword, and BrandsReportingSearchTerm. Ad metadata nests creative details in a BrandsReportingCreative object rather than a flat creative ID. totalMetrics: aggregate BrandsMetrics (or entity variant, for example, BrandsAdGroupMetrics) 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. Action-count fields (actions, firstActions, getDirections, tapURL, call, share, getTheApp, galleryEngagement) are objects keyed by attribution type (for example {"tap": 170}), not bare integers, in both totalMetrics and granularMetrics. Each endpoint’s response envelope, row, and summary objects follow a consistent per-entity naming pattern, for example BrandsCampaignReportResponse, BrandsCampaignReportRow, and BrandsCampaignResultContainer for campaigns, with equivalent objects for ad groups, ads, keywords, and search terms. For a side-by-side comparison of Brands and Apps reporting differences (groupBy dimensions, options, creative metadata), see Managing Reports.

## Topics

- [BrandsReportingRequest](apple-ads-platform-api/brandsreportingrequest.md)
- [BrandsReportingCampaign](apple-ads-platform-api/brandsreportingcampaign.md)
- [BrandsReportingAdGroup](apple-ads-platform-api/brandsreportingadgroup.md)
- [BrandsReportingAd](apple-ads-platform-api/brandsreportingad.md)
- [BrandsReportingCreative](apple-ads-platform-api/brandsreportingcreative.md)
- [BrandsReportingKeyword](apple-ads-platform-api/brandsreportingkeyword.md)
- [BrandsReportingSearchTerm](apple-ads-platform-api/brandsreportingsearchterm.md)
- [BrandsCampaignReportResponse](apple-ads-platform-api/brandscampaignreportresponse.md)
- [BrandsCampaignReportRow](apple-ads-platform-api/brandscampaignreportrow.md)
- [BrandsCampaignReportSummary](apple-ads-platform-api/brandscampaignreportsummary.md)
- [BrandsCampaignResultContainer](apple-ads-platform-api/brandscampaignresultcontainer.md)
- [BrandsAdGroupReportResponse](apple-ads-platform-api/brandsadgroupreportresponse.md)
- [BrandsAdGroupReportRow](apple-ads-platform-api/brandsadgroupreportrow.md)
- [BrandsAdGroupReportSummary](apple-ads-platform-api/brandsadgroupreportsummary.md)
- [BrandsAdGroupResultContainer](apple-ads-platform-api/brandsadgroupresultcontainer.md)
- [BrandsAdReportResponse](apple-ads-platform-api/brandsadreportresponse.md)
- [BrandsAdReportRow](apple-ads-platform-api/brandsadreportrow.md)
- [BrandsAdReportSummary](apple-ads-platform-api/brandsadreportsummary.md)
- [BrandsAdResultContainer](apple-ads-platform-api/brandsadresultcontainer.md)
- [BrandsKeywordReportResponse](apple-ads-platform-api/brandskeywordreportresponse.md)
- [BrandsKeywordReportRow](apple-ads-platform-api/brandskeywordreportrow.md)
- [BrandsKeywordReportSummary](apple-ads-platform-api/brandskeywordreportsummary.md)
- [BrandsKeywordResultContainer](apple-ads-platform-api/brandskeywordresultcontainer.md)
- [BrandsSearchTermReportResponse](apple-ads-platform-api/brandssearchtermreportresponse.md)
- [BrandsSearchTermReportRow](apple-ads-platform-api/brandssearchtermreportrow.md)
- [BrandsSearchTermReportSummary](apple-ads-platform-api/brandssearchtermreportsummary.md)
- [BrandsSearchTermResultContainer](apple-ads-platform-api/brandssearchtermresultcontainer.md)
- [BrandsMetrics](apple-ads-platform-api/brandsmetrics.md)
- [BrandsCampaignMetrics](apple-ads-platform-api/brandscampaignmetrics.md)
- [BrandsAdGroupMetrics](apple-ads-platform-api/brandsadgroupmetrics.md)
- [BrandsOptions](apple-ads-platform-api/brandsoptions.md)
- [BrandsTargetingProjection](apple-ads-platform-api/brandstargetingprojection.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)
- [Apps Data Objects](apple-ads-platform-api/apps-reports-objects.md)
- [Shared Objects](apple-ads-platform-api/reports-shared-objects.md)