AdWords API
Feedback on this document

Report Types

This page lists and describes the fields in available reports. For general information about performance reports, see the AdWords Help Center.

For specific general information about reports, visit Reporting basics and Reporting concepts guides

Available Reports
  1. Account Performance
  2. Account Reach Frequency
  3. Ad Performance
  4. Ad Extensions Performance
  5. Ad Group Performance
  6. Ad Group Reach Frequency
  7. Age Range Performance v201309
  8. Audience Performance
  9. Automatic Placements Performance
  10. Budget Performance
  11. Call Metrics Call Details
  12. Campaign Performance
  13. Campaign Ad Schedule Target
  14. Campaign Location Target
  15. Campaign Negative Keywords Performance
  16. Campaign Negative Locations
  17. Campaign Negative Placements Performance
  18. Campaign Platform Target
  19. Campaign Reach Frequency
  20. Campaign Shared Set
  21. Click Performance
  22. Creative Conversion
  23. Criteria
  24. Destination URL
  25. Display Keyword Performance
  26. Display Topics Performance
  27. Gender Performance v201309
  28. Geo Performance
  29. Keywordless Category
  30. Keywordless Query
  31. Keywords Performance
  32. Managed Placements Performance
  33. Placeholder Feed Item
  34. Placement Performance
  35. Search Query Performance
  36. Shared Set Criteria
  37. Shared Set
  38. URL Performance

Name
The field name to be used in a <fields> element when requesting reports.
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).
Type
The data type of this field in the generated report.
Behavior
The behavior of this field in the generated report. The three possible values are:
  • 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 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 incompatible with zero-impression reports, see the Notes column for more information.
Notes
Additional information about the field, including formats, enum values, and special behaviors. This column will also indicate when the report data will differ from the specified Data Type.

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. This report does not support zero impression rows.

ReportType: ACCOUNT_PERFORMANCE_REPORT

Back to top

Account Reach Frequency Report

The Account Reach Frequency report includes all stats aggregated at the account level, one row per account. This report can also be segmented by date and frequency using ReachFrequencyDate and ReachFrequency respectively. See segmentation for more information. This report does not support zero impression rows. Visit this help center page to learn more about measuring reach and frequency.

ReportType: ACCOUNT_REACH_FREQUENCY_REPORT

Back to top

The Ad Performance report includes all statistics aggregated at the ad level, one row per ad. If other segment fields are used, you may get more than one row per ad. See segmentation for more information. This is a single attribution report when KeywordId is requested. The KeywordId field will return any criteria that triggered the ad, not just keywords.

ReportType: AD_PERFORMANCE_REPORT

Back to top

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.

ReportType: AD_EXTENSIONS_PERFORMANCE_REPORT

Back to top

Ad Group 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.

ReportType: ADGROUP_PERFORMANCE_REPORT

Back to top

Ad Group Reach Frequency Report

The Ad Group Reach Frequency report includes all stats aggregated at the ad group level, one row per ad group. This report can also be segmented by date and frequency using ReachFrequencyDate and ReachFrequency respectively. See segmentation for more information. This report does not support zero impression rows. Visit this help center page to learn more about measuring reach and frequency.

ReportType: ADGROUP_REACH_FREQUENCY_REPORT

Back to top

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.

ReportType: AGE_RANGE_PERFORMANCE_REPORT

Back to top

Audience Performance Report

The Audience Performance report includes all display network statistics aggregated at the audience (i.e. Interests and Remarketing) 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.

ReportType: AUDIENCE_PERFORMANCE_REPORT

Back to top

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.

ReportType: AUTOMATIC_PLACEMENTS_PERFORMANCE_REPORT

Back to top

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.

ReportType: BUDGET_PERFORMANCE_REPORT

Back to top

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.

ReportType: CALL_METRICS_CALL_DETAILS_REPORT

Note: This is a beta feature.

Back to top

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.

ReportType: CAMPAIGN_PERFORMANCE_REPORT

Back to top

Campaign Ad Schedule Target Report

ReportType: CAMPAIGN_AD_SCHEDULE_TARGET_REPORT

Back to top

Campaign Location Target Report

ReportType: CAMPAIGN_LOCATION_TARGET_REPORT

Back to top

Campaign Negative Keywords Performance Report

Although negative keywords do not hold statistics, a report called Campaign Negative Keywords Performance report is available in the API to retrieve a structured report.

ReportType: CAMPAIGN_NEGATIVE_KEYWORDS_PERFORMANCE_REPORT

Back to top

Campaign Negative Locations Report

Although negative locations do not hold statistics, a report called Campaign Negative Locations is available in the API to retrieve a structured report.

ReportType: CAMPAIGN_NEGATIVE_LOCATIONS_REPORT

Back to top

Campaign Negative Placements Performance Report

Although negative placements do not hold statistics, a report called Campaign Negative Placements Performance report is available in the API to retrieve this structured report.

ReportType: CAMPAIGN_NEGATIVE_PLACEMENTS_PERFORMANCE_REPORT

Back to top

Campaign Platform Target Report

ReportType: CAMPAIGN_PLATFORM_TARGET_REPORT

Back to top

Campaign Reach Frequency Report

The Campaign Reach Frequency report includes all stats aggregated at the ad group level, one row per campaign. This report can also be segmented by date and frequency using ReachFrequencyDate and ReachFrequency respectively. See segmentation for more information. This report does not support zero impression rows. Visit this help center page to learn more about measuring reach and frequency.

ReportType: CAMPAIGN_REACH_FREQUENCY_REPORT

Back to top

Campaign Shared Set Report

The Campaign Shared Set report include all relations between SharedSet and campaigns.

ReportType: CAMPAIGN_SHARED_SET_REPORT

Note: This is a beta feature.

Back to top

Click Performance Report

The Click Performance report includes stats aggregated at each click level. The KeywordId field will return any criteria that triggered the click, not just keywords. This report can be run on a single day.

ReportType: CLICK_PERFORMANCE_REPORT

Back to top

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.

ReportType: CREATIVE_CONVERSION_REPORT

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

Back to top

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. The KeywordId field will return any criteria that triggered the ad, not just keywords with the exception of keyword ID 3000000.

Note : The Display Network tab in the AdWords reports in the User Interface (UI) is multiple attribution. There might be a different number from this report due to how the impressions are counted between single vs multiple attribution.

ReportType: CRITERIA_PERFORMANCE_REPORT

Back to top

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.

ReportType: DESTINATION_URL_REPORT

Back to top

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.

ReportType: DISPLAY_KEYWORD_PERFORMANCE_REPORT

Back to top

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.

ReportType: DISPLAY_TOPICS_PERFORMANCE_REPORT

Back to top

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.

ReportType: GENDER_PERFORMANCE_REPORT

Back to top

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 placement. See segmentation for more information. This is a single attribution report.

ReportType: GEO_PERFORMANCE_REPORT

Back to top

Keywordless Category Report

The Keywordless Category Performance report includes keywordless ads (dynamic search ads) statistics aggregated by category. This report does not return zero impression rows.

ReportType: KEYWORDLESS_CATEGORY_REPORT

Back to top

Keywordless Query Report

The Keywordless Query Performance report includes keywordless ads (dynamic search ads) statistics based on search terms. This report does not return zero impression rows.

ReportType: KEYWORDLESS_QUERY_REPORT

Back to top

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.

ReportType: KEYWORDS_PERFORMANCE_REPORT

Back to top

Managed Placements Performance Report

ReportType: MANAGED_PLACEMENTS_PERFORMANCE_REPORT

Note: This report is deprecated.

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.

The stats in the row for sitelink X show all clicks and costs when X was shown. This includes headline clicks on X, as well as clicks on other sitelinks and other ad extensions (e.g., a call extension) when X was also shown. Also included are the costs accrued by all clicks.

To see the clicks/costs/etc. for just sitelink X, use segment "IsSelfAction", and look at the "This extension" rows. To see a breakdown by type of click (e.g., headline vs. sitelink), use segment "ClickType".

ReportType: PLACEHOLDER_FEED_ITEM_REPORT

Back to top

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.

ReportType: PLACEMENT_PERFORMANCE_REPORT

Back to top

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 per combination of search terms. See segmentation for more information.

Note: If the string for this attribute is longer than 128 char bytes, the returned result will NOT be a single aggregated row.

ReportType: SEARCH_QUERY_PERFORMANCE_REPORT

Back to top

Shared Set Criteria Report

The Shared Set Criteria report include criteria for each SharedSet.

ReportType: SHARED_SET_CRITERIA_REPORT

Note: This is a beta feature.

Back to top

Shared Set Report

The Shared Set report include all SharedSet that can be sharable across campaigns.

ReportType: SHARED_SET_REPORT

Note: This is a beta feature.

Back to top

URL Performance Report

The URL Performance report includes all statistics aggregated at the URL level, one row per URL where your ads have been displayed. This is similar to the placements performance report, except that this breaks it down by URLs your ads have been displayed at rather than the manual placements or automatic placements (criteria). If other segment fields are used, you may get more than one row per URL. See segmentation for more information. This is a single attribution report.

ReportType: URL_PERFORMANCE_REPORT

Back to top

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.