StatsRecord (AdWords API Developer's Guide)

Note: JavaScript must be enabled for you to properly view versions. It seems JavaScript is either disabled or is not supported by your browser, which causes all versions of text to be simultaneously displayed. Enable JavaScript in your browser options, then try again.

Skip to main content Skip to main menu

Introduction
Release Notes
Web Services
Sandbox
API Reference

Close all submenus

Open all submenus
- AccountService
  - AccountInfo
    - Address
    - EmailPromotions
      Preferences
- AdGroupService
  - AdGroup
- AdService
  - Business
  - CommerceAd sandbox
  - ImageAd
    - Image
  - LocalBusinessAd
  - MobileAd
  - TextAd
  - VideoAd
    - Video
- CampaignService
  - Campaign
    - AdSchedule
      - SchedulingInterval
    - BudgetOptimizerSettings
    - ConversionOptimizer Settings +V12
    - GeoTarget
      - CityTargets +V10
      - CountryTargets +V10
      - MetroTargets +V10
      - RegionTargets +V10
      - ProximityTargets +V10
        
        Circle +v10
    - LanguageTarget
    - NetworkTarget
  - ConversionOptimizer Eligibility +V12
- CriterionService
  - Keyword
  - Website
- InfoService
  - ClientUsageRecord
- KeywordToolService
- ReportService
  - DefinedReportJob +V11
  - AccountReportJob −V11
  - AdImageReportJob −V11
  - AdGroupReportJob −V11
  - AdTextReportJob −V11
  - CampaignReportJob −V11
  - CustomReportJob −V11
  - KeywordReportJob −V11
  - UrlReportJob −V11
- SiteSuggestionService +V10
  - DemographicsTarget +V10
  - Language GeoTargeting +V10
  - SiteSuggestion +V10
- TrafficEstimatorService
  - CampaignEstimate
    - AdGroupEstimate
      - KeywordEstimate
  - CampaignRequest
    - AdGroupRequest
      - KeywordRequest
- General Data Types
  - StatsRecord
- Exception Types
  - ApiError
  - ApiException
International Codes
Report Rules +V11
- Account +V11
- Account Structure +V11
- Ad +V11
- Ad Group +V11
- Campaign +V11
- Placement +V11
- Placement / Keyword +V11
- Reach and Frequency +V11
- Url +V11
Error Codes
API Rate Sheet
Index

AdWords API Resources

Developer Forum

AdWords API Blog

StatsRecord

A data transfer object that contains activity statistics for some entity (a Campaign, AdGroup, or Criterion such as an Keyword or Website) over a period of time.

StatsRecords are returned by certain requests on the CampaignService, AdGroupService, and CriterionService.

The data reported includes the number of clicks collected by the entity, the number of impressions shown on behalf of the entity, the total cost incurred by the entity, the number of clicks collected that were eligible for conversion and the number of clicks that were reported to have been converted.

Fields

averagePosition
clicks
conversionRate
conversions
cost
id
impressions

Field name	Field type	Field description
`averagePosition`	`double`	The average position of impressions that were shown for this record's entity. Average position is not reported for campaigns, but can be obtained using the `ReportService`.
`clicks`	`long`	The number of clicks collected by this record's entity.
`conversionRate`	`double`	The ratio of conversions over convertible clicks for this record's entity.
`conversions`	`long`	The number of clicks that were actually converted for this record's entity.
`cost`	`long`	The total cost incurred (in micro-units of currency) by this record's entity.
`id`	`long`	The Id of this record's entity.
`impressions`	`long`	The number of impressions shown on behalf of this record's entity.