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 grouping data by fields does not automatically add these fields 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 typeDescriptionAdds data groupingFields not allowed
ACCOUNT_PERFORMANCE_REPORTStatistics for the advertiser's accountSee section Allowed fields
CAMPAIGN_PERFORMANCE_REPORTStatistics for campaignsCampaignIdSee section Allowed fields
ADGROUP_PERFORMANCE_REPORTStatistics for ad groupsAdGroupIdSee section Allowed fields
AD_PERFORMANCE_REPORTStatistics for adsAdIdAudienceTargetId, Criteria, CriteriaId, Criterion, CriterionId, DynamicTextAdTargetId, ImpressionShare, Keyword, Query, RlAdjustmentId, SmartBannerFilterId
CRITERIA_PERFORMANCE_REPORTStatistics for targeting criteriaAdGroupId, CriteriaId, CriteriaTypeAdFormat, AdId, Placement, Query
CUSTOM_REPORTStatistics with custom groupingsImpressionShare, Query

Statistics for display campaigns.

The report only contains data for campaigns with the “Display campaign” type, and ignores all other types of campaigns.

In the report request, set the FieldNames value to CampaignIdSee section Allowed fields
SEARCH_QUERY_PERFORMANCE_REPORTStatistics for search queriesAdGroupId, QuerySee section Allowed fields
Note. All the report types use single attribution: each impression and click is attributed to only one targeting criteria, region, user age, etc.