Documentation

Report type

In the ReportType
[no-highlight[

Report type. See the section Report type.

Required

Yes

]no-highlight]
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
[no-highlight[

Names of fields (columns) that will be in the report.

To see which fields you can specify, see the sections Allowed fields and Incompatible fields and dependencies.

Required

Yes

]no-highlight]
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 the section Allowed fields
CAMPAIGN_PERFORMANCE_REPORTStatistics for campaigns CampaignId
[no-highlight[

The campaign ID.

]no-highlight]
See the section Allowed fields
ADGROUP_PERFORMANCE_REPORTStatistics for ad groups AdGroupId
[no-highlight[

ID of the ad group.

]no-highlight]
See the section Allowed fields
AD_PERFORMANCE_REPORTStatistics for ads AdId
[no-highlight[

The ad ID.

]no-highlight]
AudienceTargetId
[no-highlight[

ID of the audience target. See the section Audience targets (AudienceTarget).

]no-highlight]
, Criteria
[no-highlight[

Name or text of the targeting criteria:

  • For targeting a keyword or synonym – the keyword text.

  • For autotargeting – the “---autotargeting” value.

  • For targeting a related keyword:

    • an empty value, if the report type is CUSTOM_REPORT.
    • the text of the related keyword, if the report type is SEARCH_QUERY_PERFORMANCE_REPORT.
  • For targeting an audience target – the name of the retargeting list, or the name of a mobile app category.

  • For showing a dynamic ad – the name of the dynamic text ad target, or the name of the filter.

  • For showing smart banners – the name of the filter.

]no-highlight]
, CriteriaId
[no-highlight[

ID of the targeting criteria:

  • For targeting a keyword or synonym – the keyword ID.

  • For autotargeting – the autotargeting ID.

  • For targeting a related keyword – a dash.

  • For targeting an audience target – the ID of the audience target.

  • For showing a dynamic ad – the ID of the dynamic text ad target, or the ID of the filter.

  • For showing smart banners – the ID of the filter.

]no-highlight]
, Criterion
[no-highlight[

The name or text of the targeting criteria set by the advertiser:

  • For targeting a keyword or synonym – the keyword text.

  • For displays for a related keyword – the keyword text, or the value “automatically added phrase” if the keyword couldn‘t be determined.

  • For autotargeting – the “---autotargeting” value.

  • For targeting an audience target – the name of the retargeting list, or the name of a mobile app category.

  • For showing a dynamic ad – the name of the dynamic text ad target, or the name of the filter.

  • For showing smart banners – the name of the filter.

We recommend using this field instead of Criteria.

]no-highlight]
, CriterionId
[no-highlight[

The ID of the targeting criteria set by the advertiser:

  • For targeting a keyword or synonym – the keyword ID.

  • For targeting a related keyword – the ID of the keyword, or a dash if the keyword couldn‘t be determined.

  • For autotargeting – the autotargeting ID.

  • For targeting an audience (using a retargeting list or interest in a mobile app category) – the ID of the audience target.

  • For a dynamic text ad target generated from site pages – the ID of the dynamic text ad target.

  • For a filter for dynamic ads generated from a feed, or a filter for smart banners – the filter ID.

We recommend using this field instead of CriteriaId.

]no-highlight]
, DynamicTextAdTargetId
[no-highlight[

The ID of the audience target for dynamic ads, or the ID of the filter for dynamic ads. See the section Ad target for dynamic ads (DynamicTextAdTarget — Webpage).

]no-highlight]
, ImpressionShare
[no-highlight[

The percentage of auctions won out of the total number of auctions that the ad materials participated in. Data is only available for smart banners.

]no-highlight]
, Keyword
[no-highlight[

The keyword text.

]no-highlight]
, Query
[no-highlight[

The search query that triggered the ad.

]no-highlight]
, RlAdjustmentId
[no-highlight[

ID of a retargeting list used for applying bid adjustments for website users.

]no-highlight]
, SmartBannerFilterId
[no-highlight[

The ID of the filter for smart banners.

]no-highlight]
CRITERIA_PERFORMANCE_REPORTStatistics for targeting criteriaAdGroupId
[no-highlight[

ID of the ad group.

]no-highlight]
, CriteriaId
[no-highlight[

ID of the targeting criteria:

  • For targeting a keyword or synonym – the keyword ID.

  • For autotargeting – the autotargeting ID.

  • For targeting a related keyword – a dash.

  • For targeting an audience target – the ID of the audience target.

  • For showing a dynamic ad – the ID of the dynamic text ad target, or the ID of the filter.

  • For showing smart banners – the ID of the filter.

]no-highlight]
, CriteriaType
[no-highlight[

The type of targeting criteria set by the advertiser:

  • KEYWORD — Keyword.

  • AUTOTARGETING — Autotargeting.

  • AUDIENCE_TARGET — Audience target.

  • DYNAMIC_TEXT_AD_TARGET — Dynamic text ad target or filter for dynamic ads.

  • SMART_BANNER_FILTER — Filter for smart banners.

]no-highlight]
AdFormat
[no-highlight[

Format of the ad impression:

  • IMAGE — With an image.

  • TEXT — A text ad.

  • VIDEO — With video.

  • SMART_MULTIPLE — Smart banner.

  • SMART_SINGLE — Smart ad.

]no-highlight]
, AdId
[no-highlight[

The ad ID.

]no-highlight]
, Placement
[no-highlight[

Name of the site where the ad is being displayed.

]no-highlight]
, Query
[no-highlight[

The search query that triggered the ad.

]no-highlight]
CUSTOM_REPORTStatistics with custom groupingsImpressionShare
[no-highlight[

The percentage of auctions won out of the total number of auctions that the ad materials participated in. Data is only available for smart banners.

]no-highlight]
, Query
[no-highlight[

The search query that triggered the ad.

]no-highlight]
SEARCH_QUERY_PERFORMANCE_REPORTStatistics for search queriesAdGroupId
[no-highlight[

ID of the ad group.

]no-highlight]
, Query
[no-highlight[

The search query that triggered the ad.

]no-highlight]
See the 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.