---
title: ReportingAdGroup
framework: Apple Ads
role: symbol
role_heading: Object
platforms: [search ads 2.0+]
path: apple_ads/reportingadgroup
---

# ReportingAdGroup

The response to a request to fetch ad group-level reports.

## Declaration

```data
object ReportingAdGroup
```

## Properties

adGroupDisplayStatus: The state of the operation. See AdGroupDisplayStatus for enum descriptions. adGroupId: The identifier for the ad group. You can use the EQUALS, IN, and STARTSWITH Selector Condition operators with Get Ad Group-Level Reports. adGroupName: The name of the ad group. This is unique within the campaign. Reports don’t include deleted ad groups. You can use the EQUALS, IN, and STARTSWITH Selector Condition operators with Get Ad Group-Level Reports. adGroupServingStateReasons: A list of reasons that displays when an ad group isn’t running. See AdGroupServingStateReasons for enum descriptions. adGroupServingStatus: The status of whether the ad group is serving. See AdGroupServingStatus for value descriptions. adGroupStatus: The status of the ad group. See AdGroupStatus for value descriptions. You can use the EQUALS Selector Condition operator with Get Ad Group-Level Reports. automatedKeywordsOptIn: The parameter for enabling and disabling Search Match. If true, the system automatically adds optimized keywords in addition to those you explicitly add to the ad group. See the Enable and Disable Search Match section of Ad Groups. You can use the EQUALS Selector Condition operator with Get Ad Group-Level Reports. automatedKeywordsRequired: A read-only field validating an automated ad group. Defaults to false. An automated ad group must exist for Maximize Conversions campaigns to run. biddingStrategy: The bid strategy for the campaign. See Campaigns. campaignId: The unique identifier for the campaign. You can use the EQUALS, IN, and STARTSWITH Selector Condition operators with Get Ad Group-Level Reports. cpaGoal: The cost-per-acquisition goal. defaultBidAmount: The default maximum cost per tap or impression bid for the ad group. deleted: The indicator of whether the ad group is soft-deleted. This includes keywords that belong to an ad group. You can use the EQUALS and IN Selector Condition operators with the Get Ad Group-Level Reports. endTime: The scheduled end date and time for the ad group. modificationTime: The date and time of the most recent modification of the object. orgId: The identifier of the organization that owns the campaign. Your orgId is the same as your account in Apple Ads. startTime: The scheduled start date and time for the ad group.

## Topics

### Dictionaries

- [ReportingAdGroup.CpaGoal](apple_ads/reportingadgroup/cpagoal-data.dictionary.md)

## See Also

### Reports Request and Response Objects

- [ReportingRequest](apple_ads/reportingrequest.md)
- [ReportingResponseBody](apple_ads/reportingresponsebody.md)
- [ReportingResponse](apple_ads/reportingresponse.md)
- [ReportingDataResponse](apple_ads/reportingdataresponse.md)
- [GrandTotalsRow](apple_ads/grandtotalsrow.md)
- [SpendRow](apple_ads/spendrow.md)
- [ExtendedSpendRow](apple_ads/extendedspendrow.md)
- [Row](apple_ads/row.md)
- [ReportingCampaign](apple_ads/reportingcampaign.md)
- [ReportingKeyword](apple_ads/reportingkeyword.md)
- [ReportingSearchTerm](apple_ads/reportingsearchterm.md)
- [ReportingAd](apple_ads/reportingad.md)
- [CampaignAppDetail](apple_ads/campaignappdetail.md)
- [InsightsObject](apple_ads/insightsobject.md)
- [KeywordInsights](apple_ads/keywordinsights.md)