ClickPerformance
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
Table Specific Information
Select
Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.
To use the nondefault fields, explicitly select them in your query.
Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.
Note that this table only supports queries for a specific day within the past 90 days. You will need to set the StartDate and EndDate to the same value in the WHERE clause.
Columns
Name
Type
Behavior
DisplayName
Description
AccountDescriptiveName
String
Attribute
Account
Account for the ClickPerformance report.
AdFormat
String
Attribute
Ad Type
Ad Type for the ClickPerformance report.
The allowed values are UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.
AdGroupId
Long
Attribute
Ad Group ID
Ad Group ID for the ClickPerformance report.
AdGroupName
String
Attribute
Ad Group
Ad Group for the ClickPerformance report.
AdGroupStatus
String
Attribute
Ad Group State
Ad Group State for the ClickPerformance report.
The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
AdNetworkType1
String
Attribute
Network
Network for the ClickPerformance report.
The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2
String
Attribute
Network (with Search Partners)
Network (with Search Partners) for the ClickPerformance report.
The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdVariationControlTrialArmId
Long
Attribute
Ad Variation Control Trial Arm ID
Ad Variation Control Trial Arm ID for the ClickPerformance report.
AdVariationTreatmentTrialArmId
Long
Attribute
Ad Variation Treatment Trial Arm ID
Ad Variation Treatment Trial Arm ID for the ClickPerformance report.
AdVariationTrialId
Long
Attribute
Ad Variation Trial ID
Ad Variation Trial ID for the ClickPerformance report.
AoiCityCriteriaId
Integer
Attribute
City (Location Of Interest)
City (Location Of Interest) for the ClickPerformance report.
AoiCountryCriteriaId
Integer
Attribute
Country Per Territory (Location Of Interest)
Country Per Territory (Location Of Interest) for the ClickPerformance report.
AoiMetroCriteriaId
Integer
Attribute
Metro Area (Location Of Interest)
Metro Area (Location Of Interest) for the ClickPerformance report.
AoiMostSpecificTargetId
Long
Attribute
Most Specific Location Target (Location Of Interest)
Most Specific Location Target (Location Of Interest) for the ClickPerformance report.
AoiRegionCriteriaId
Integer
Attribute
Region (Location Of Interest)
Region (Location Of Interest) for the ClickPerformance report.
CampaignId
Long
Attribute
Campaign ID
Campaign ID for the ClickPerformance report.
CampaignLocationTargetId
Long
Attribute
Campaign Location Target
Campaign Location Target for the ClickPerformance report.
CampaignName
String
Attribute
Campaign
Campaign for the ClickPerformance report.
CampaignStatus
String
Attribute
Campaign State
Campaign State for the ClickPerformance report.
The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
Clicks
Long
Attribute
Clicks
Clicks for the ClickPerformance report.
ClickType
String
Attribute
Click Type
Click Type for the ClickPerformance report.
The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
CreativeId
Long
Attribute
Ad ID
Ad ID for the ClickPerformance report.
CriteriaId
Long
Attribute
Keyword ID
Keyword ID for the ClickPerformance report.
CriteriaParameters
String
Attribute
Keyword Per Placement
Keyword Per Placement for the ClickPerformance report.
Date
Date
Attribute
Day
Day for the ClickPerformance report.
Device
String
Attribute
Device
Device for the ClickPerformance report.
The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalCustomerId
Long
Attribute
Customer ID
Customer ID for the ClickPerformance report.
GclId
String
Attribute
Google Click ID
Google Click ID for the ClickPerformance report.
KeywordMatchType
String
Attribute
Match Type
Match Type for the ClickPerformance report.
The allowed values are UNKNOWN, EXACT, PHRASE, BROAD.
LopCityCriteriaId
Integer
Attribute
City (Physical Location)
City (Physical Location) for the ClickPerformance report.
LopCountryCriteriaId
Integer
Attribute
Country Per Territory (Physical Location)
Country Per Territory (Physical Location) for the ClickPerformance report.
LopMetroCriteriaId
Integer
Attribute
Metro Area (Physical Location)
Metro Area (Physical Location) for the ClickPerformance report.
LopMostSpecificTargetId
Long
Attribute
Most Specific Location Target (Physical Location)
Most Specific Location Target (Physical Location) for the ClickPerformance report.
LopRegionCriteriaId
Integer
Attribute
Region (Physical Location)
Region (Physical Location) for the ClickPerformance report.
MonthOfYear
String
Attribute
Month Of Year
Month Of Year for the ClickPerformance report.
The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Page
Integer
Attribute
Page
Page for the ClickPerformance report.
Slot
String
Attribute
Top Vs Other
Top Vs Other for the ClickPerformance report.
The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
UserListId
Long
Attribute
User List ID
User List ID for the ClickPerformance report.
Pseudo-Columns
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name
Type
Description
StartDate
String
Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate
String
End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
Last updated