The AdWords API is no longer available. Use the Google Ads API instead.

Click Performance Report

The Click Performance report includes stats aggregated at each click level, and includes both valid and invalid clicks.

For non-Search campaigns, the Clicks field represents the number of valid and invalid interactions instead of clicks.

The following fields have special behavior on this report:

  • The CriteriaId and CriteriaParameters fields will return the criterion that triggered the impression for each GclId (based on the single attribution model) and may be of any criteria type, not just keywords. Discovery campaigns are not supported when this report has Criteria fields added.
  • The ClickType field will reflect each area of the ad that the user clicked for each GclId. This differs from other reports, where the ClickType shows every area of the ad that was shown to the user for each impression.
  • The Date field indicates the time of the impression, not the time of the click.

Note: This report can be run only for a single day and only for dates up to 90 days before the time of the request.

 Attribute

 Segment

 Metric

Download this table in CSV format

CLICK_PERFORMANCE_REPORT

AccountDescriptiveName

The descriptive name of the Customer account.

TypeString
Display NameAccount
XML Attributeaccount
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AdFormat

The underlying media format of the ad. Values can be one of the formats on the Template Ads page, or a MediaType enum.

TypeAdFormat
Display NameAd type
XML AttributeadType
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AdGroupId

The ID of the AdGroup.

TypeLong
Display NameAd group ID
XML AttributeadGroupID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AdGroupName

The name of the AdGroup.

TypeString
Display NameAd group
XML AttributeadGroup
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AdGroupStatus

Status of the ad group.

TypeAdGroupStatus
Display NameAd group state
XML AttributeadGroupState
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AdNetworkType1

First level network type.

TypeAdNetworkType1
Display NameNetwork
XML Attributenetwork
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AdNetworkType2

Second level network type (includes search partners).

TypeAdNetworkType2
Display NameNetwork (with search partners)
XML AttributenetworkWithSearchPartners
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AdVariationControlTrialArmId

If the impression was part of an ad variation and in the control arm, this represents the ad variation control arm ID.

TypeLong
Display NameAd Variation Control Trial Arm ID
XML AttributeadVariationControlTrialArmID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AdVariationTreatmentTrialArmId

If the impression was part of an ad variation and in the treatment arm, this represents the ad variation treatment arm ID.

TypeLong
Display NameAd Variation Treatment Trial Arm ID
XML AttributeadVariationTreatmentTrialArmID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AdVariationTrialId

If the impression was part of an ad variation, this represents the ad variation trial ID.

TypeLong
Display NameAd Variation Trial ID
XML AttributeadVariationTrialID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AoiCityCriteriaId

ID of the city of the Location criterion matching the location of interest associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

TypeInteger
Display NameCity (Location of interest)
XML AttributecityLocationOfInterest
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AoiCountryCriteriaId

ID of the country of the Location criterion matching the location of interest associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

TypeInteger
Display NameCountry/Territory (Location of interest)
XML AttributecountryTerritoryLocationOfInterest
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AoiMetroCriteriaId

ID of the metro area of the Location criterion matching the location of interest associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

TypeInteger
Display NameMetro area (Location of interest)
XML AttributemetroAreaLocationOfInterest
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AoiMostSpecificTargetId

The most specific location target (Location of interest).

TypeLong
Display NameMost specific location target (Location of interest)
XML AttributemostSpecificLocationTargetLocationOfInterest
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AoiRegionCriteriaId

ID of the region of the Location criterion matching the location of interest associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

TypeInteger
Display NameRegion (Location of interest)
XML AttributeregionLocationOfInterest
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

CampaignId

The ID of the Campaign.

TypeLong
Display NameCampaign ID
XML AttributecampaignID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

CampaignLocationTargetId

Location ID of the matching campaign criterion.

TypeLong
Display NameCampaign location target
XML AttributecampaignLocationTarget
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

CampaignName

The name of the Campaign.

TypeString
Display NameCampaign
XML Attributecampaign
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

CampaignStatus

The status of the Campaign.

TypeCampaignStatus
Display NameCampaign state
XML AttributecampaignState
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

Clicks

The number of clicks.

TypeLong
Display NameClicks
XML Attributeclicks
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

ClickType

Indicates the click type for metric fields such as Impressions. Since ads that serve can be attributed to multiple click types, metric fields may be double-counted and thus totals may not be accurate, especially for Display network campaigns.

TypeClickType
Display NameClick type
XML AttributeclickType
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

CreativeId

ID of the ad.

TypeLong
Display NameAd ID
XML AttributeadID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

CriteriaId

The Criterion ID.

TypeLong
Display NameKeyword ID
XML AttributekeywordID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

CriteriaParameters

Descriptive string for the Criterion. For more information on the format of criteria types in reports, see the Criteria prefixes section of the reporting guide.

TypeString
Display NameKeyword / Placement
XML AttributekeywordPlacement
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

Date

The date formatted as yyyy-MM-dd.

TypeDate
Display NameDay
XML Attributeday
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

Device

Device type where the impression was shown.

TypeDeviceType
Display NameDevice
XML Attributedevice
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

ExternalCustomerId

The Customer ID.

TypeLong
Display NameCustomer ID
XML AttributecustomerID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

GclId

The Google Click ID.

TypeString
Display NameGoogle Click ID
XML AttributegoogleClickID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

KeywordMatchType

The match type for the Keyword.

TypeKeywordMatchType
Display NameMatch type
XML AttributematchType
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

LopCityCriteriaId

ID of the city of the Location criterion matching the physical location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

TypeInteger
Display NameCity (Physical location)
XML AttributecityPhysicalLocation
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

LopCountryCriteriaId

ID of the country of the Location criterion matching the physical location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

TypeInteger
Display NameCountry/Territory (Physical location)
XML AttributecountryTerritoryPhysicalLocation
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

LopMetroCriteriaId

ID of the metro area of the Location criterion matching the physical location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

TypeInteger
Display NameMetro area (Physical location)
XML AttributemetroAreaPhysicalLocation
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

LopMostSpecificTargetId

The most specific location target (Physical location).

TypeLong
Display NameMost specific location target (Physical location)
XML AttributemostSpecificLocationTargetPhysicalLocation
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

LopRegionCriteriaId

ID of the region of the Location criterion matching the physical location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

TypeInteger
Display NameRegion (Physical location)
XML AttributeregionPhysicalLocation
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

MonthOfYear

The name of the month of the year, e.g., "December".

TypeMonthOfYear
Display NameMonth of Year
XML AttributemonthOfYear
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

Page

Page number in search results where the ad was shown.

TypeInteger
Display NamePage
XML Attributepage
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsFalse

Slot

The position of the Ad.

TypeSlot
Display NameTop vs. Other
XML AttributetopVsOther
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

UserListId

The ID of the UserList (audience).

TypeLong
Display NameUser List ID
XML AttributeuserListID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse