Report type
In the ReportType parameter, specify the type of report. The report type affects which fields are available and how the data is grouped.
For example, if you set the SEARCH_QUERY_PERFORMANCE_REPORT type, the report data will be grouped by AdGroupId and Query. Note that when you group data by certain fields, those fields aren't added automatically to the report. The report contains only the fields that are listed in the FieldNames parameter.
The most general report type is CUSTOM_REPORT. It doesn't add any groupings.
The table lists the report types.
| Report type | Description | Adds data grouping | Fields not allowed |
|---|---|---|---|
| ACCOUNT_PERFORMANCE_REPORT | Statistics for the advertiser's account | – | See the section Allowed fields |
| CAMPAIGN_PERFORMANCE_REPORT | Statistics for campaigns | CampaignId | See the section Allowed fields |
| ADGROUP_PERFORMANCE_REPORT | Statistics for ad groups | AdGroupId | See the section Allowed fields |
| AD_PERFORMANCE_REPORT | Statistics for ads | AdId | AudienceTargetId, Criteria, CriteriaId, Criterion, CriterionId, DynamicTextAdTargetId, Keyword, Query, RlAdjustmentId, and SmartAdTargetId |
| CRITERIA_PERFORMANCE_REPORT | Statistics for targeting criteria | AdGroupId, CriteriaId, CriteriaType | AdFormat, AdId, Placement, Query |
| CUSTOM_REPORT | Statistics with custom groupings | – | Query |
| REACH_AND_FREQUENCY_PERFORMANCE_REPORT | Statistics for display campaigns. The report only contains data for campaigns with the “Display campaign” type and ignores any other campaign types. | In the report request, set the FieldNames value to CampaignId | See the section Allowed fields |
| SEARCH_QUERY_PERFORMANCE_REPORT | Statistics for search queries | AdGroupId, Query | See the section Allowed fields |
| Report type | Description | Adds data grouping | Fields not allowed |
|---|---|---|---|
| ACCOUNT_PERFORMANCE_REPORT | Statistics for the advertiser's account | – | See the section Allowed fields |
| CAMPAIGN_PERFORMANCE_REPORT | Statistics for campaigns | CampaignId | See the section Allowed fields |
| ADGROUP_PERFORMANCE_REPORT | Statistics for ad groups | AdGroupId | See the section Allowed fields |
| AD_PERFORMANCE_REPORT | Statistics for ads | AdId | AudienceTargetId, Criteria, CriteriaId, Criterion, CriterionId, DynamicTextAdTargetId, Keyword, Query, RlAdjustmentId, and SmartAdTargetId |
| CRITERIA_PERFORMANCE_REPORT | Statistics for targeting criteria | AdGroupId, CriteriaId, CriteriaType | AdFormat, AdId, Placement, Query |
| CUSTOM_REPORT | Statistics with custom groupings | – | Query |
| REACH_AND_FREQUENCY_PERFORMANCE_REPORT | Statistics for display campaigns. The report only contains data for campaigns with the “Display campaign” type and ignores any other campaign types. | In the report request, set the FieldNames value to CampaignId | See the section Allowed fields |
| SEARCH_QUERY_PERFORMANCE_REPORT | Statistics for search queries | AdGroupId, Query | See the section Allowed fields |