<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "article",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/brands-reports-objects",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Brands Data Objects"
}
-->

# Brands Data Objects

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

## 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.

|Entity     |Endpoint                                                                                                   |
|-----------|-----------------------------------------------------------------------------------------------------------|
|Campaign   |<doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-brand-campaign-reports>   |
|Ad Group   |<doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-brand-ad-group-reports>   |
|Ad         |<doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-brand-ad-reports>         |
|Keyword    |<doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-brand-keyword-reports>    |
|Search Term|<doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Get-brand-search-term-reports>|

### Shared Object Model

Every Brands report request uses [`BrandsReportingRequest`](/documentation/Apple-Ads-Platform-API/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`](/documentation/Apple-Ads-Platform-API/BrandsReportingCampaign), [`BrandsReportingAdGroup`](/documentation/Apple-Ads-Platform-API/BrandsReportingAdGroup), [`BrandsReportingAd`](/documentation/Apple-Ads-Platform-API/BrandsReportingAd), [`BrandsReportingKeyword`](/documentation/Apple-Ads-Platform-API/BrandsReportingKeyword), and [`BrandsReportingSearchTerm`](/documentation/Apple-Ads-Platform-API/BrandsReportingSearchTerm). Ad metadata nests creative details in a [`BrandsReportingCreative`](/documentation/Apple-Ads-Platform-API/BrandsReportingCreative) object rather than a flat creative ID.
- `totalMetrics`: aggregate [`BrandsMetrics`](/documentation/Apple-Ads-Platform-API/BrandsMetrics) (or entity variant, for example, [`BrandsAdGroupMetrics`](/documentation/Apple-Ads-Platform-API/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`](/documentation/Apple-Ads-Platform-API/BrandsCampaignReportResponse), [`BrandsCampaignReportRow`](/documentation/Apple-Ads-Platform-API/BrandsCampaignReportRow), and [`BrandsCampaignResultContainer`](/documentation/Apple-Ads-Platform-API/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](/documentation/Apple-Ads-Platform-API/reports).

## Topics

[`BrandsReportingRequest`](/documentation/Apple-Ads-Platform-API/BrandsReportingRequest)

[`BrandsReportingCampaign`](/documentation/Apple-Ads-Platform-API/BrandsReportingCampaign)

[`BrandsReportingAdGroup`](/documentation/Apple-Ads-Platform-API/BrandsReportingAdGroup)

[`BrandsReportingAd`](/documentation/Apple-Ads-Platform-API/BrandsReportingAd)

[`BrandsReportingCreative`](/documentation/Apple-Ads-Platform-API/BrandsReportingCreative)

[`BrandsReportingKeyword`](/documentation/Apple-Ads-Platform-API/BrandsReportingKeyword)

[`BrandsReportingSearchTerm`](/documentation/Apple-Ads-Platform-API/BrandsReportingSearchTerm)

[`BrandsCampaignReportResponse`](/documentation/Apple-Ads-Platform-API/BrandsCampaignReportResponse)

[`BrandsCampaignReportRow`](/documentation/Apple-Ads-Platform-API/BrandsCampaignReportRow)

[`BrandsCampaignReportSummary`](/documentation/Apple-Ads-Platform-API/BrandsCampaignReportSummary)

[`BrandsCampaignResultContainer`](/documentation/Apple-Ads-Platform-API/BrandsCampaignResultContainer)

[`BrandsAdGroupReportResponse`](/documentation/Apple-Ads-Platform-API/BrandsAdGroupReportResponse)

[`BrandsAdGroupReportRow`](/documentation/Apple-Ads-Platform-API/BrandsAdGroupReportRow)

[`BrandsAdGroupReportSummary`](/documentation/Apple-Ads-Platform-API/BrandsAdGroupReportSummary)

[`BrandsAdGroupResultContainer`](/documentation/Apple-Ads-Platform-API/BrandsAdGroupResultContainer)

[`BrandsAdReportResponse`](/documentation/Apple-Ads-Platform-API/BrandsAdReportResponse)

[`BrandsAdReportRow`](/documentation/Apple-Ads-Platform-API/BrandsAdReportRow)

[`BrandsAdReportSummary`](/documentation/Apple-Ads-Platform-API/BrandsAdReportSummary)

[`BrandsAdResultContainer`](/documentation/Apple-Ads-Platform-API/BrandsAdResultContainer)

[`BrandsKeywordReportResponse`](/documentation/Apple-Ads-Platform-API/BrandsKeywordReportResponse)

[`BrandsKeywordReportRow`](/documentation/Apple-Ads-Platform-API/BrandsKeywordReportRow)

[`BrandsKeywordReportSummary`](/documentation/Apple-Ads-Platform-API/BrandsKeywordReportSummary)

[`BrandsKeywordResultContainer`](/documentation/Apple-Ads-Platform-API/BrandsKeywordResultContainer)

[`BrandsSearchTermReportResponse`](/documentation/Apple-Ads-Platform-API/BrandsSearchTermReportResponse)

[`BrandsSearchTermReportRow`](/documentation/Apple-Ads-Platform-API/BrandsSearchTermReportRow)

[`BrandsSearchTermReportSummary`](/documentation/Apple-Ads-Platform-API/BrandsSearchTermReportSummary)

[`BrandsSearchTermResultContainer`](/documentation/Apple-Ads-Platform-API/BrandsSearchTermResultContainer)

[`BrandsMetrics`](/documentation/Apple-Ads-Platform-API/BrandsMetrics)

[`BrandsCampaignMetrics`](/documentation/Apple-Ads-Platform-API/BrandsCampaignMetrics)

[`BrandsAdGroupMetrics`](/documentation/Apple-Ads-Platform-API/BrandsAdGroupMetrics)

[`BrandsOptions`](/documentation/Apple-Ads-Platform-API/BrandsOptions)

[`BrandsTargetingProjection`](/documentation/Apple-Ads-Platform-API/BrandsTargetingProjection)


---

Copyright &copy; 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)