DisplayTopicsPerformance

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

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 DisplayTopicsPerformance report.

AccountDescriptiveName

String

Attribute

Account

Account for the DisplayTopicsPerformance report.

AccountTimeZone

String

Attribute

Time Zone

Time Zone for the DisplayTopicsPerformance report.

AdGroupId

Long

Attribute

Ad Group ID

Ad Group ID for the DisplayTopicsPerformance report.

AdGroupName

String

Attribute

Ad Group

Ad Group for the DisplayTopicsPerformance report.

AdGroupStatus

String

Attribute

Ad Group State

Ad Group State for the DisplayTopicsPerformance report.

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

BaseAdGroupId

Long

Attribute

Base Ad Group ID

Base Ad Group ID for the DisplayTopicsPerformance report.

BaseCampaignId

Long

Attribute

Base Campaign ID

Base Campaign ID for the DisplayTopicsPerformance report.

BiddingStrategyId

Long

Attribute

Bid Strategy ID

Bid Strategy ID for the DisplayTopicsPerformance report.

BiddingStrategyName

String

Attribute

Bid Strategy Name

Bid Strategy Name for the DisplayTopicsPerformance report.

BiddingStrategyType

String

Attribute

Bid Strategy Type

Bid Strategy Type for the DisplayTopicsPerformance 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.

BidModifier

Double

Attribute

Bid Adj

Bid Adj for the DisplayTopicsPerformance report.

CampaignId

Long

Attribute

Campaign ID

Campaign ID for the DisplayTopicsPerformance report.

CampaignName

String

Attribute

Campaign

Campaign for the DisplayTopicsPerformance report.

CampaignStatus

String

Attribute

Campaign State

Campaign State for the DisplayTopicsPerformance report.

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

CpcBid

Decimal

Attribute

Max CPC

Max CPC for the DisplayTopicsPerformance report.

CpcBidSource

String

Attribute

Max CPC Source

Max CPC Source for the DisplayTopicsPerformance report.

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

CpmBid

Decimal

Attribute

Max CPM

Max CPM for the DisplayTopicsPerformance report.

CpmBidSource

String

Attribute

Max CPM Source

Max CPM Source for the DisplayTopicsPerformance report.

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

Criteria

String

Attribute

Topic

Topic for the DisplayTopicsPerformance report.

CriteriaDestinationUrl

String

Attribute

Destination URL

Destination URL for the DisplayTopicsPerformance report.

CustomerDescriptiveName

String

Attribute

Client Name

Client Name for the DisplayTopicsPerformance report.

ExternalCustomerId

Long

Attribute

Customer ID

Customer ID for the DisplayTopicsPerformance report.

FinalAppUrls

String

Attribute

App Final URL

App Final URL for the DisplayTopicsPerformance report.

FinalMobileUrls

String

Attribute

Mobile Final URL

Mobile Final URL for the DisplayTopicsPerformance report.

FinalUrls

String

Attribute

Final URL

Final URL for the DisplayTopicsPerformance report.

Id

Long

Attribute

Criterion ID

Criterion ID for the DisplayTopicsPerformance report.

IsNegative

String

Attribute

Is Negative

Is Negative for the DisplayTopicsPerformance report.

The allowed values are TRUE, FALSE.

IsRestrict

String

Attribute

Is Restricting

Is Restricting for the DisplayTopicsPerformance report.

The allowed values are TRUE, FALSE.

Status

String

Attribute

Topic State

Topic State for the DisplayTopicsPerformance report.

The allowed values are ENABLED, REMOVED, PAUSED.

TrackingUrlTemplate

String

Attribute

Tracking Template

Tracking Template for the DisplayTopicsPerformance report.

UrlCustomParameters

String

Attribute

Custom Parameter

Custom Parameter for the DisplayTopicsPerformance report.

VerticalId

Long

Attribute

Vertical ID

Vertical ID for the DisplayTopicsPerformance report.

AdNetworkType1

String

Segment

Network

Network for the DisplayTopicsPerformance 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 DisplayTopicsPerformance report.

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

ClickType

String

Segment

Click Type

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

ConversionTrackerId

Long

Segment

Conversion Tracker Id

Conversion Tracker Id for the DisplayTopicsPerformance report.

ConversionTypeName

String

Segment

Conversion Name

Conversion Name for the DisplayTopicsPerformance report.

Date

Date

Segment

Day

Day for the DisplayTopicsPerformance report.

DayOfWeek

String

Segment

Day Of Week

Day Of Week for the DisplayTopicsPerformance report.

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

Device

String

Segment

Device

Device for the DisplayTopicsPerformance report.

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

ExternalConversionSource

String

Segment

Conversion Source

Conversion Source for the DisplayTopicsPerformance 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 DisplayTopicsPerformance report.

MonthOfYear

String

Segment

Month Of Year

Month Of Year for the DisplayTopicsPerformance report.

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

Quarter

String

Segment

Quarter

Quarter for the DisplayTopicsPerformance report.

Week

String

Segment

Week

Week for the DisplayTopicsPerformance report.

Year

Integer

Segment

Year

Year for the DisplayTopicsPerformance report.

ActiveViewCpm

Decimal

Metric

Active View Avg CPM

Active View Avg CPM for the DisplayTopicsPerformance report.

ActiveViewCtr

Double

Metric

Active View Viewable CTR

Active View Viewable CTR for the DisplayTopicsPerformance report.

ActiveViewImpressions

Long

Metric

Active View Viewable Impressions

Active View Viewable Impressions for the DisplayTopicsPerformance report.

ActiveViewMeasurability

Double

Metric

Active View Measurable Impr Per Impr

Active View Measurable Impr Per Impr for the DisplayTopicsPerformance report.

ActiveViewMeasurableCost

Decimal

Metric

Active View Measurable Cost

Active View Measurable Cost for the DisplayTopicsPerformance report.

ActiveViewMeasurableImpressions

Long

Metric

Active View Measurable Impr

Active View Measurable Impr for the DisplayTopicsPerformance report.

ActiveViewViewability

Double

Metric

Active View Viewable Impr Per Measurable Impr

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

AllConversionRate

Double

Metric

All Conv Rate

All Conv Rate for the DisplayTopicsPerformance report.

AllConversions

Double

Metric

All Conv

All Conv for the DisplayTopicsPerformance report.

AllConversionValue

Double

Metric

All Conv Value

All Conv Value for the DisplayTopicsPerformance report.

AverageCost

Decimal

Metric

Avg Cost

Avg Cost for the DisplayTopicsPerformance report.

AverageCpc

Decimal

Metric

Avg CPC

Avg CPC for the DisplayTopicsPerformance report.

AverageCpe

Double

Metric

Avg CPE

Avg CPE for the DisplayTopicsPerformance report.

AverageCpm

Decimal

Metric

Avg CPM

Avg CPM for the DisplayTopicsPerformance report.

AverageCpv

Double

Metric

Avg CPV

Avg CPV for the DisplayTopicsPerformance report.

Clicks

Long

Metric

Clicks

Clicks for the DisplayTopicsPerformance report.

ConversionRate

Double

Metric

Conv Rate

Conv Rate for the DisplayTopicsPerformance report.

Conversions

Double

Metric

Conversions

Conversions for the DisplayTopicsPerformance report.

ConversionValue

Double

Metric

Total Conv Value

Total Conv Value for the DisplayTopicsPerformance report.

Cost

Decimal

Metric

Cost

Cost for the DisplayTopicsPerformance report.

CostPerAllConversion

Decimal

Metric

Cost Per All Conv

Cost Per All Conv for the DisplayTopicsPerformance report.

CostPerConversion

Decimal

Metric

Cost Per Conv

Cost Per Conv for the DisplayTopicsPerformance report.

CrossDeviceConversions

Double

Metric

Cross-device Conv

Cross-device Conv for the DisplayTopicsPerformance report.

Ctr

Double

Metric

CTR

CTR for the DisplayTopicsPerformance report.

EngagementRate

Double

Metric

Engagement Rate

Engagement Rate for the DisplayTopicsPerformance report.

Engagements

Long

Metric

Engagements

Engagements for the DisplayTopicsPerformance report.

GmailForwards

Long

Metric

Gmail Forwards

Gmail Forwards for the DisplayTopicsPerformance report.

GmailSaves

Long

Metric

Gmail Saves

Gmail Saves for the DisplayTopicsPerformance report.

GmailSecondaryClicks

Long

Metric

Gmail Clicks To Website

Gmail Clicks To Website for the DisplayTopicsPerformance report.

Impressions

Long

Metric

Impressions

Impressions for the DisplayTopicsPerformance report.

InteractionRate

Double

Metric

Interaction Rate

Interaction Rate for the DisplayTopicsPerformance report.

Interactions

Long

Metric

Interactions

Interactions for the DisplayTopicsPerformance report.

InteractionTypes

String

Metric

Interaction Types

Interaction Types for the DisplayTopicsPerformance report.

ValuePerAllConversion

Double

Metric

Value Per All Conv

Value Per All Conv for the DisplayTopicsPerformance report.

ValuePerConversion

Double

Metric

Value Per Conv

Value Per Conv for the DisplayTopicsPerformance report.

VideoQuartile100Rate

Double

Metric

Video Played To 100Percent

Video Played To 100Percent for the DisplayTopicsPerformance report.

VideoQuartile25Rate

Double

Metric

Video Played To 25Percent

Video Played To 25Percent for the DisplayTopicsPerformance report.

VideoQuartile50Rate

Double

Metric

Video Played To 50Percent

Video Played To 50Percent for the DisplayTopicsPerformance report.

VideoQuartile75Rate

Double

Metric

Video Played To 75Percent

Video Played To 75Percent for the DisplayTopicsPerformance report.

VideoViewRate

Double

Metric

View Rate

View Rate for the DisplayTopicsPerformance report.

VideoViews

Long

Metric

Views

Views for the DisplayTopicsPerformance report.

ViewThroughConversions

Long

Metric

View-through Conv

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