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