DisplayKeywordPerformance

The Display Keyword Performance report includes all display network statistics aggregated at the keyword level, one row per keyword.

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.

Columns

Name

Type

Behavior

DisplayName

Description

AccountCurrencyCode

String

Attribute

Currency

Currency for the DisplayKeywordPerformance report.

AccountDescriptiveName

String

Attribute

Account

Account for the DisplayKeywordPerformance report.

AccountTimeZone

String

Attribute

Time Zone

Time Zone for the DisplayKeywordPerformance report.

AdGroupId

Long

Attribute

Ad Group ID

Ad Group ID for the DisplayKeywordPerformance report.

AdGroupName

String

Attribute

Ad Group

Ad Group for the DisplayKeywordPerformance report.

AdGroupStatus

String

Attribute

Ad Group State

Ad Group State for the DisplayKeywordPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

BaseAdGroupId

Long

Attribute

Base Ad Group ID

Base Ad Group ID for the DisplayKeywordPerformance report.

BaseCampaignId

Long

Attribute

Base Campaign ID

Base Campaign ID for the DisplayKeywordPerformance report.

BiddingStrategyId

Long

Attribute

Bid Strategy ID

Bid Strategy ID for the DisplayKeywordPerformance report.

BiddingStrategyName

String

Attribute

Bid Strategy Name

Bid Strategy Name for the DisplayKeywordPerformance report.

BiddingStrategyType

String

Attribute

Bid Strategy Type

Bid Strategy Type for the DisplayKeywordPerformance report.

The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.

CampaignId

Long

Attribute

Campaign ID

Campaign ID for the DisplayKeywordPerformance report.

CampaignName

String

Attribute

Campaign

Campaign for the DisplayKeywordPerformance report.

CampaignStatus

String

Attribute

Campaign State

Campaign State for the DisplayKeywordPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CpcBid

Decimal

Attribute

Max CPC

Max CPC for the DisplayKeywordPerformance report.

CpcBidSource

String

Attribute

Max CPC Source

Max CPC Source for the DisplayKeywordPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

CpmBid

Decimal

Attribute

Max CPM

Max CPM for the DisplayKeywordPerformance report.

CpmBidSource

String

Attribute

Max CPM Source

Max CPM Source for the DisplayKeywordPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

CpvBid

Decimal

Attribute

Max CPV

Max CPV for the DisplayKeywordPerformance report.

CpvBidSource

String

Attribute

Max CPV Source

Max CPV Source for the DisplayKeywordPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

Criteria

String

Attribute

Keyword

Keyword for the DisplayKeywordPerformance report.

CriteriaDestinationUrl

String

Attribute

Destination URL

Destination URL for the DisplayKeywordPerformance report.

CustomerDescriptiveName

String

Attribute

Client Name

Client Name for the DisplayKeywordPerformance report.

ExternalCustomerId

Long

Attribute

Customer ID

Customer ID for the DisplayKeywordPerformance report.

FinalAppUrls

String

Attribute

App Final URL

App Final URL for the DisplayKeywordPerformance report.

FinalMobileUrls

String

Attribute

Mobile Final URL

Mobile Final URL for the DisplayKeywordPerformance report.

FinalUrls

String

Attribute

Final URL

Final URL for the DisplayKeywordPerformance report.

Id

Long

Attribute

Keyword ID

Keyword ID for the DisplayKeywordPerformance report.

IsNegative

String

Attribute

Is Negative

Is Negative for the DisplayKeywordPerformance report.

The allowed values are TRUE, FALSE.

IsRestrict

String

Attribute

Is Restricting

Is Restricting for the DisplayKeywordPerformance report.

The allowed values are TRUE, FALSE.

Status

String

Attribute

Keyword State

Keyword State for the DisplayKeywordPerformance report.

The allowed values are ENABLED, REMOVED, PAUSED.

TrackingUrlTemplate

String

Attribute

Tracking Template

Tracking Template for the DisplayKeywordPerformance report.

UrlCustomParameters

String

Attribute

Custom Parameter

Custom Parameter for the DisplayKeywordPerformance report.

AdNetworkType1

String

Segment

Network

Network for the DisplayKeywordPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2

String

Segment

Network (with Search Partners)

Network (with Search Partners) for the DisplayKeywordPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType

String

Segment

Click Type

Click Type for the DisplayKeywordPerformance 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.

ConversionCategoryName

String

Segment

Conversion Category

Conversion Category for the DisplayKeywordPerformance report.

ConversionTrackerId

Long

Segment

Conversion Tracker Id

Conversion Tracker Id for the DisplayKeywordPerformance report.

ConversionTypeName

String

Segment

Conversion Name

Conversion Name for the DisplayKeywordPerformance report.

Date

Date

Segment

Day

Day for the DisplayKeywordPerformance report.

DayOfWeek

String

Segment

Day Of Week

Day Of Week for the DisplayKeywordPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device

String

Segment

Device

Device for the DisplayKeywordPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource

String

Segment

Conversion Source

Conversion Source for the DisplayKeywordPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month

String

Segment

Month

Month for the DisplayKeywordPerformance report.

MonthOfYear

String

Segment

Month Of Year

Month Of Year for the DisplayKeywordPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter

String

Segment

Quarter

Quarter for the DisplayKeywordPerformance report.

Week

String

Segment

Week

Week for the DisplayKeywordPerformance report.

Year

Integer

Segment

Year

Year for the DisplayKeywordPerformance report.

ActiveViewCpm

Decimal

Metric

Active View Avg CPM

Active View Avg CPM for the DisplayKeywordPerformance report.

ActiveViewCtr

Double

Metric

Active View Viewable CTR

Active View Viewable CTR for the DisplayKeywordPerformance report.

ActiveViewImpressions

Long

Metric

Active View Viewable Impressions

Active View Viewable Impressions for the DisplayKeywordPerformance report.

ActiveViewMeasurability

Double

Metric

Active View Measurable Impr Per Impr

Active View Measurable Impr Per Impr for the DisplayKeywordPerformance report.

ActiveViewMeasurableCost

Decimal

Metric

Active View Measurable Cost

Active View Measurable Cost for the DisplayKeywordPerformance report.

ActiveViewMeasurableImpressions

Long

Metric

Active View Measurable Impr

Active View Measurable Impr for the DisplayKeywordPerformance report.

ActiveViewViewability

Double

Metric

Active View Viewable Impr Per Measurable Impr

Active View Viewable Impr Per Measurable Impr for the DisplayKeywordPerformance report.

AllConversionRate

Double

Metric

All Conv Rate

All Conv Rate for the DisplayKeywordPerformance report.

AllConversions

Double

Metric

All Conv

All Conv for the DisplayKeywordPerformance report.

AllConversionValue

Double

Metric

All Conv Value

All Conv Value for the DisplayKeywordPerformance report.

AverageCost

Decimal

Metric

Avg Cost

Avg Cost for the DisplayKeywordPerformance report.

AverageCpc

Decimal

Metric

Avg CPC

Avg CPC for the DisplayKeywordPerformance report.

AverageCpe

Double

Metric

Avg CPE

Avg CPE for the DisplayKeywordPerformance report.

AverageCpm

Decimal

Metric

Avg CPM

Avg CPM for the DisplayKeywordPerformance report.

AverageCpv

Double

Metric

Avg CPV

Avg CPV for the DisplayKeywordPerformance report.

Clicks

Long

Metric

Clicks

Clicks for the DisplayKeywordPerformance report.

ConversionRate

Double

Metric

Conv Rate

Conv Rate for the DisplayKeywordPerformance report.

Conversions

Double

Metric

Conversions

Conversions for the DisplayKeywordPerformance report.

ConversionValue

Double

Metric

Total Conv Value

Total Conv Value for the DisplayKeywordPerformance report.

Cost

Decimal

Metric

Cost

Cost for the DisplayKeywordPerformance report.

CostPerAllConversion

Decimal

Metric

Cost Per All Conv

Cost Per All Conv for the DisplayKeywordPerformance report.

CostPerConversion

Decimal

Metric

Cost Per Conv

Cost Per Conv for the DisplayKeywordPerformance report.

CrossDeviceConversions

Double

Metric

Cross-device Conv

Cross-device Conv for the DisplayKeywordPerformance report.

Ctr

Double

Metric

CTR

CTR for the DisplayKeywordPerformance report.

EngagementRate

Double

Metric

Engagement Rate

Engagement Rate for the DisplayKeywordPerformance report.

Engagements

Long

Metric

Engagements

Engagements for the DisplayKeywordPerformance report.

GmailForwards

Long

Metric

Gmail Forwards

Gmail Forwards for the DisplayKeywordPerformance report.

GmailSaves

Long

Metric

Gmail Saves

Gmail Saves for the DisplayKeywordPerformance report.

GmailSecondaryClicks

Long

Metric

Gmail Clicks To Website

Gmail Clicks To Website for the DisplayKeywordPerformance report.

Impressions

Long

Metric

Impressions

Impressions for the DisplayKeywordPerformance report.

InteractionRate

Double

Metric

Interaction Rate

Interaction Rate for the DisplayKeywordPerformance report.

Interactions

Long

Metric

Interactions

Interactions for the DisplayKeywordPerformance report.

InteractionTypes

String

Metric

Interaction Types

Interaction Types for the DisplayKeywordPerformance report.

ValuePerAllConversion

Double

Metric

Value Per All Conv

Value Per All Conv for the DisplayKeywordPerformance report.

ValuePerConversion

Double

Metric

Value Per Conv

Value Per Conv for the DisplayKeywordPerformance report.

VideoQuartile100Rate

Double

Metric

Video Played To 100Percent

Video Played To 100Percent for the DisplayKeywordPerformance report.

VideoQuartile25Rate

Double

Metric

Video Played To 25Percent

Video Played To 25Percent for the DisplayKeywordPerformance report.

VideoQuartile50Rate

Double

Metric

Video Played To 50Percent

Video Played To 50Percent for the DisplayKeywordPerformance report.

VideoQuartile75Rate

Double

Metric

Video Played To 75Percent

Video Played To 75Percent for the DisplayKeywordPerformance report.

VideoViewRate

Double

Metric

View Rate

View Rate for the DisplayKeywordPerformance report.

VideoViews

Long

Metric

Views

Views for the DisplayKeywordPerformance report.

ViewThroughConversions

Long

Metric

View-through Conv

View-through Conv for the DisplayKeywordPerformance 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