Hide

Report Types

This page lists and describes the fields in available reports.

All reports
Account Performance
Ad Customizers Feed Item
Ad Extensions Performance
Ad Group Performance
Ad Performance
Age Range Performance
Audience Performance
Automatic Placements Performance
Bid Goal Performance
Budget Performance
Call Metrics Call Details
Campaign Ad Schedule Target
Campaign Location Target
Campaign Negative Keywords Performance
Campaign Negative Locations
Campaign Negative Placements Performance
Campaign Performance
Campaign Platform Target
Campaign Shared Set
Click Performance
Creative Conversion
Criteria Performance
Destination URL
Display Keyword Performance
Display Topics Performance
Gender Performance
Geo Performance
Keywordless Category
Keywordless Query
Keywords Performance
Label
Paid and Organic Query
Placeholder
Placeholder Feed Item
Placement Performance
Product Partition
Search Query Performance
Shared Set
Shared Set Criteria
Shopping Performance
URL Performance
User Ad Distance

Field attributes

The first column in the tables below contains the field names to use when constructing a report request.

The second column contains the data type of the field, a description of the field, and the attributes below.

Display Name
The human-readable name of this field, returned in a CSV header row.
XML Attribute
The XML attribute in the generated report that corresponds to this field (only applicable if a report definition's download format is XML).
Filterable
Indicates whether the field can be used in report request predicates.
Supports Zero Impressions
Indicates whether the field supports (True) or implicitly excludes (False) zero impressions.
Behavior
  • Attribute The field contains settings or other fixed data. The values returned will always reflect the current state of the account, ignoring the timespan of the report. The field is generally compatible with zero-impression reports.
  • Metric The field contains numerical performance data. The values returned reflect the performance over the timespan of the report.
  • Segment The field contains dimension data that is used to group metrics. Including the field in a report may split a single row into multiple rows. The values returned and number of segmented rows reflect the performance over the timespan of the report. The field is likely to be incompatible with zero-impression reports. See the field description and the Support Zero Impressions attribute to verify.

Report types

Reports
ACCOUNT_PERFORMANCE_REPORT

The Account Performance report includes all statistics aggregated by default at the account level, one row per account. If other segment fields are used, you may get more than one row per account. See segmentation for more information.

AD_CUSTOMIZERS_FEED_ITEM_REPORT

The Ad Customizers Feed Item report provides statistics for feed items used in Ad Customizers. Statistics are aggregated at the feed item level, one row per feed item. If other segment fields are used, you may get more than one row per feed item. See segmentation for more information.

AD_EXTENSIONS_PERFORMANCE_REPORT

The Ad Extensions Performance report includes all statistics aggregated at the ad extension level, one row per ad extension, and it is filtered in the UI by the type of extension. This report will only return legacy campaign extensions. For upgraded extensions, use the Placeholder Feed Item report - they will not be reflected in this report. If other segment fields are used, you may get more than one row per ad extension. See segmentation for more information.

ADGROUP_PERFORMANCE_REPORT

The Ad Group Performance report includes all statistics aggregated by default at the ad group level, one row per ad group. If other segment fields are used, you may get more than one row per ad group. See segmentation for more information.

AGE_RANGE_PERFORMANCE_REPORT

The Age Range Performance report includes all display network statistics aggregated by age range. It also includes automatic audience performance. If other segment fields are used, you may get more than one row per age range. See segmentation for more information. This is a multiple attribution report.

AUDIENCE_PERFORMANCE_REPORT

The Audience Performance report includes performance data from interests and remarketing lists for display ads, and remarketing lists for search ads (RLSA), aggregated at the audience level—one row per audience. If other segment fields are used, you may get more than one row per topic. See segmentation for more information. This is a multiple attribution report.

AUTOMATIC_PLACEMENTS_PERFORMANCE_REPORT

The Automatic Placements Performance report includes all statistics aggregated at the placement level, one row per placement. If other segment fields are used, you may get more than one row per placement. See segmentation for more information. This is a single attribution report.

BID_GOAL_PERFORMANCE_REPORT

The Bid Goal Performance report includes statistics for your shared bid strategies. Non-shared strategies will not appear in this report's output.

BUDGET_PERFORMANCE_REPORT

The Budget Performance report includes all statistics aggregated by default at the budget level, one row per budget. If other segment fields are used, you may get more than one row per budget. See segmentation for more information.

CALL_METRICS_CALL_DETAILS_REPORT

The Call Metrics Call Details report includes call details for your call extension including call duration and the caller's area code.

CAMPAIGN_AD_SCHEDULE_TARGET_REPORT

The Campaign Ad Schedule Target report summarizes the performance of campaigns by AdSchedule criteria.

CAMPAIGN_LOCATION_TARGET_REPORT

The Campaign Location Target Report summarizes the performance of campaigns by location-based CampaignCriterion.

CAMPAIGN_NEGATIVE_KEYWORDS_PERFORMANCE_REPORT

Although negative keywords do not hold statistics, you can use this structured report to efficiently retrieve attributes of keyword-based NegativeCampaignCriterion objects.

CAMPAIGN_NEGATIVE_LOCATIONS_REPORT

Although negative locations do not hold statistics, you can use this structured report to efficiently retrieve attributes of location-based NegativeCampaignCriterion objects.

CAMPAIGN_NEGATIVE_PLACEMENTS_PERFORMANCE_REPORT

Although negative placements do not hold statistics, you can use this structured report to efficiently retrieve attributes of placement-based NegativeCampaignCriterion objects.

CAMPAIGN_PERFORMANCE_REPORT

The Campaigns Performance report includes all statistics aggregated by default at the campaign level, one row per campaign. If other segment fields are used, you may get more than one row per campaign. See segmentation for more information.

CAMPAIGN_PLATFORM_TARGET_REPORT

The Campaign Platform Target Report summarizes the performance of campaigns by platform-based CampaignCriterion.

CAMPAIGN_SHARED_SET_REPORT

The Campaign Shared Set report includes all relationships between SharedSets and campaigns.

CLICK_PERFORMANCE_REPORT

The Click Performance report includes stats aggregated at each click level, and includes both valid and invalid clicks. The KeywordId field will return any criteria that triggered the click, not just keywords.

CREATIVE_CONVERSION_REPORT

Free clicks are interactions that take place before a clickthrough for video ads, display ads, product extensions and location extensions, interactions like a "Video play" or a "Get directions". Visit this help page to learn more about free clicks.

This report is called "Free clicks" in the AdWords web interface.

CRITERIA_PERFORMANCE_REPORT

The Criteria Performance report includes statistics aggregated at the ad group criteria level, one row per ad group and criteria combination. If other segment fields are used, you may get more than one row per criteria. See segmentation for more information. This is a single attribution report.

DESTINATION_URL_REPORT

The Destination URL report includes all statistics aggregated at the destination URL level, one row per destination URL (specified on the keyword or the ad). If other segment fields are used, you may get more than one row per placement. See segmentation for more information.

DISPLAY_KEYWORD_PERFORMANCE_REPORT

The Display Keyword Performance report includes all display network statistics aggregated at the keyword level, one row per keyword. If other segment fields are used, you may get more than one row per keyword. See segmentation for more information. This is a multiple attribution report.

DISPLAY_TOPICS_PERFORMANCE_REPORT

The Display Topics Performance report includes all display network statistics aggregated at the topic level, one row per topic. If other segment fields are used, you may get more than one row per topic. See segmentation for more information. This is a multiple attribution report.

GENDER_PERFORMANCE_REPORT

The Gender Performance report includes all statistics aggregated by gender. It also includes automatic audience performance. If other segment fields are used, you may get more than one row per gender. See segmentation for more information. This is a multi attribution report.

GEO_PERFORMANCE_REPORT

The Geo Performance report includes all statistics aggregated at the country/territory level, one row per country/territory. If other segment fields are used, you may get more than one row per country/territory. See segmentation for more information.

KEYWORDLESS_CATEGORY_REPORT

The Keywordless Category Performance report includes keywordless ads (dynamic search ads) statistics aggregated by category.

KEYWORDLESS_QUERY_REPORT

The Keywordless Query report includes keywordless ads (dynamic search ads) statistics based on search terms.

KEYWORDS_PERFORMANCE_REPORT

The Keywords Performance report includes all statistics aggregated at the keyword level, one row per keyword. If other segment fields are used, you may get more than one row per keyword. See segmentation for more information. This is a single attribution report. If a keyword triggers an ad on Display Network, the ID is represented as ID 3000000.

LABEL_REPORT

The Label report is a structure report that lists all labels for your account.

PLACEHOLDER_FEED_ITEM_REPORT

The Placeholder Feed Item report includes all statistics at the feed-item level (e.g., a single sitelink). If other segment fields are used, you may get more than one row per feed item. See segmentation for more information.

PLACEHOLDER_REPORT

The Placeholder Report provides statistics for feed-based ad extensions, one row per placeholder type. If other segment fields are used, you may get more than one row per placeholder type. See segmentation for more information.

PLACEMENT_PERFORMANCE_REPORT

The Placements Performance report includes all statistics aggregated at the placement level, one row per placement. If other segment fields are used, you may get more than one row per placement. See segmentation for more information. This is a multiple attribution report.

PRODUCT_PARTITION_REPORT

The Product Partition report provides shopping campaign statistics aggregated at the product partition (Id field) level. If other segment fields are used, you may get more than one row per product partition. For product-level results, see the Shopping Performance Report.

SEARCH_QUERY_PERFORMANCE_REPORT

The Search Terms report includes all statistics aggregated at the search terms level, one row per combination of search terms. If other segment fields are used, you may get more than one row per combination of search terms. See segmentation for more information.

SHARED_SET_CRITERIA_REPORT

The Shared Set Criteria report includes criteria for each SharedSet.

SHARED_SET_REPORT

The Shared Set report includes all SharedSets that can be shareable across campaigns.

SHOPPING_PERFORMANCE_REPORT

The Shopping Performance report provides shopping campaign statistics aggregated at the product (OfferId field) level. Product dimension values from Merchant Center such as brand, category, custom attributes, product condition and product type will reflect the state of each dimension as of the date and time when AdWords recorded the corresponding event.

URL_PERFORMANCE_REPORT

The URL Performance report includes all statistics aggregated at the URL and criterion level, one row per combination of:

  • URL where your ads have been displayed (Url)
  • Targeting criterion (CriteriaParameters)
If other segment fields are used, you may get more than one row per combination of URL and placement criterion. See segmentation for more information. This is a single attribution report.

USER_AD_DISTANCE_REPORT

The User Ad Distance Report provides statistics aggregated by the user's distance from your location extensions. Each DistanceBucket shows all impressions that fall within its distance. As a result, an impression will contribute to the stats for all DistanceBuckets that include the user's distance.

Additional resources

For more information about performance reports, visit these resources:

Send feedback about...

AdWords API