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

Ad Performance Report

The Ad Performance report includes all statistics aggregated at the ad level, one row per ad. If other segment fields are used, you may get more than one row per ad. See segmentation for more information. This is a single attribution report when CriterionId or IsNegative is requested. The CriterionId field will return any criteria that triggered the ad, not just keywords. Discovery campaigns are not supported when this report has Criteria fields added.

 Attribute

Id

 Segment

 Metric

Ctr

Download this table in CSV format

AD_PERFORMANCE_REPORT

AbsoluteTopImpressionPercentage

The percent of your ad impressions that are shown as the very first ad above the organic search results. See this Help Center article for details. A percentage can be returned as a real number ranging from 0.0 to 1.0. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameImpr. (Abs. Top) %
XML AttributeimprAbsTop
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AccentColor

The accent color for the responsive display ad.

TypeString
Display NameAccent color (responsive)
XML AttributeaccentColorResponsive
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

AccountCurrencyCode

The currency of the Customer account.

TypeString
Display NameCurrency
XML Attributecurrency
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

AccountDescriptiveName

The descriptive name of the Customer account.

TypeString
Display NameAccount
XML Attributeaccount
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

AccountTimeZone

Name of the timezone selected for the Customer account. For example: "(GMT-05:00) Eastern Time". This field does not reflect the current state of daylight saving time for the timezone.

TypeString
Display NameTime zone
XML AttributetimeZone
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ActiveViewCpm

Average cost of viewable impressions (ActiveViewImpressions). Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameActive View avg. CPM
XML AttributeactiveViewAvgCPM
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ActiveViewCtr

How often people clicked your ad after it became viewable. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameActive View viewable CTR
XML AttributeactiveViewViewableCTR
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ActiveViewImpressions

How often your ad has become viewable on a Display Network site.

TypeLong
Display NameActive View viewable impressions
XML AttributeactiveViewViewableImpressions
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ActiveViewMeasurability

The ratio of impressions that could be measured by Active View over the number of served impressions. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameActive View measurable impr. / impr.
XML AttributeactiveViewMeasurableImprImpr
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ActiveViewMeasurableCost

The cost of the impressions you received that were measurable by Active View. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameActive View measurable cost
XML AttributeactiveViewMeasurableCost
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ActiveViewMeasurableImpressions

The number of times your ads are appearing on placements in positions where they can be seen.

TypeLong
Display NameActive View measurable impr.
XML AttributeactiveViewMeasurableImpr
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ActiveViewViewability

The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameActive View viewable impr. / measurable impr.
XML AttributeactiveViewViewableImprMeasurableImpr
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AdGroupId

The ID of the AdGroup.

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

AdGroupName

The name of the AdGroup.

TypeString
Display NameAd group
XML AttributeadGroup
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

AdGroupStatus

Status of the ad group.

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

AdNetworkType1

First level network type.

TypeAdNetworkType1
Display NameNetwork
XML Attributenetwork
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

AdNetworkType2

Second level network type (includes search partners).

TypeAdNetworkType2
Display NameNetwork (with search partners)
XML AttributenetworkWithSearchPartners
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

AdStrengthInfo

The strength information of the ad.

TypeAdStrengthInfo
Display NameAd strength
XML AttributeadStrength
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

AdType

The type of the Ad. If the ad's type is not supported in the report request's API version, this field will have the value "unknown".

TypeType
Display NameAd type
XML AttributeadType
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

AllConversionRate

AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAll conv. rate
XML AttributeallConvRate
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AllConversions

Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAll conv.
XML AttributeallConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AllConversionValue

The total value of all of your conversions, including those that are estimated. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAll conv. value
XML AttributeallConvValue
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AllowFlexibleColor

Whether the responsive display ad colors must be strictly used.

TypeEnum
Display NameAllow flexible color (responsive)
XML AttributeallowFlexibleColorResponsive
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Automated

Indicates if this ad is automatically created by Google Ads.

TypeEnum
Display NameAuto-applied ad suggestion
XML AttributeautoAppliedAdSuggestion
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

AverageCost

The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameAvg. Cost
XML AttributeavgCost
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AverageCpc

The total cost of all clicks divided by the total number of clicks received. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameAvg. CPC
XML AttributeavgCPC
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AverageCpe

The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAvg. CPE
XML AttributeavgCPE
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AverageCpm

Average Cost-per-thousand impressions (CPM). Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameAvg. CPM
XML AttributeavgCPM
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AverageCpv

The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAvg. CPV
XML AttributeavgCPV
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AveragePageviews

Average number of pages viewed per session. Imported from Google Analytics. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NamePages / session
XML AttributepagesSession
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AveragePosition

Your ad's position relative to those of other advertisers. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAvg. position
XML AttributeavgPosition
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AverageTimeOnSite

Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAvg. session duration (seconds)
XML AttributeavgSessionDurationSeconds
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

BaseAdGroupId

The ID of base ad group of trial ad groups. For regular ad groups, this is equal to AdGroupId. For campaign-level user lists, this will always be 0.

TypeLong
Display NameBase Ad group ID
XML AttributebaseAdGroupID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

BaseCampaignId

The ID of base campaign of trial campaigns. For regular campaigns, this is equal to CampaignId.

TypeLong
Display NameBase Campaign ID
XML AttributebaseCampaignID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

BounceRate

Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". Imported from Google Analytics. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameBounce rate
XML AttributebounceRate
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

BusinessName

The business name in a reponsive display ad.

TypeString
Display NameBusiness name
XML AttributebusinessName
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

CallOnlyPhoneNumber

The phone number of call-only ad.

TypeString
Display NameCall-only ad phone number
XML AttributecallOnlyAdPhoneNumber
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

CallToActionText

The call-to-action text for the responsive display ad.

TypeString
Display NameCall to action text (responsive)
XML AttributecallToActionTextResponsive
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

CampaignId

The ID of the Campaign.

TypeLong
Display NameCampaign ID
XML AttributecampaignID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

CampaignName

The name of the Campaign.

TypeString
Display NameCampaign
XML Attributecampaign
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

CampaignStatus

The status of the Campaign.

TypeCampaignStatus
Display NameCampaign state
XML AttributecampaignState
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ClickAssistedConversions

The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.

TypeLong
Display NameClick Assisted Conv.
XML AttributeclickAssistedConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ClickAssistedConversionsOverLastClickConversions

The total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameClick Assisted Conv. / Last Click Conv.
XML AttributeclickAssistedConvLastClickConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ClickAssistedConversionValue

The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameClick Assisted Conv. Value
XML AttributeclickAssistedConvValue
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Clicks

The number of clicks.

TypeLong
Display NameClicks
XML Attributeclicks
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

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
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

CombinedApprovalStatus

Approval status that combines review state and status.

TypePolicyApprovalStatus
Display NameApproval status
XML AttributeapprovalStatus
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ConversionAdjustment

Whether the conversion was adjusted or the conversion is original one.

TypeEnum
Display NameConversion adjustment
XML AttributeconversionAdjustment
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

ConversionAdjustmentLagBucket

The number of days between the impression and the conversion or between the impression and adjustments to the conversion.

TypeConversionAdjustmentLagBucket
Display NameDays to conversion or adjustment
XML AttributedaysToConversionOrAdjustment
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ConversionCategoryName

A category that describes the action the user will take to complete a conversion. Prevents zero-conversion rows from being returned. Values: "Download", "Lead", "Purchase/Sale", "Signup", "View of a key page", and "Other".

TypeString
Display NameConversion category
XML AttributeconversionCategory
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ConversionLagBucket

Days between click and conversion.

TypeConversionLagBucket
Display NameDays to conversion
XML AttributedaysToConversion
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ConversionRate

The number of conversions divided by total clicks that can be tracked to conversions. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameConv. rate
XML AttributeconvRate
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Conversions

The number of conversions for all conversion actions that you have opted into optimization. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameConversions
XML Attributeconversions
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ConversionTrackerId

ID of the conversion tracker.

TypeLong
Display NameConversion Tracker Id
XML AttributeconversionTrackerId
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ConversionTypeName

The name of the conversion type. Prevents zero-conversion rows from being returned.

TypeString
Display NameConversion name
XML AttributeconversionName
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ConversionValue

The sum of conversion values for all conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameTotal conv. value
XML AttributetotalConvValue
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Cost

The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameCost
XML Attributecost
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

CostPerAllConversion

Total cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameCost / all conv.
XML AttributecostAllConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

CostPerConversion

The Cost attributable to conversion-tracked clicks divided by the number of conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameCost / conv.
XML AttributecostConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

CostPerCurrentModelAttributedConversion

Shows how your historic CostPerConversion data would look under the attribution model you've currently selected. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameCost / conv. (current model)
XML AttributecostConvCurrentModel
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

CreativeDestinationUrl

Destination URL of the ad.

TypeString
Display NameDestination URL
XML AttributedestinationURL
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

CreativeFinalAppUrls

List of final app URLs of the ad. List entries will start with one of: a) "android-app:" (for Android apps) or b) "os-app:" (for iOS apps). List elements are returned in JSON list format.

TypeList
Display NameApp final URL
XML AttributeappFinalURL
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

CreativeFinalMobileUrls

List of final mobile URLs of the ad. List elements are returned in JSON list format.

TypeList
Display NameMobile final URL
XML AttributemobileFinalURL
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

CreativeFinalUrls

List of final URLs of the ad. List elements are returned in JSON list format.

TypeList
Display NameFinal URL
XML AttributefinalURL
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

CreativeFinalUrlSuffix

The URL template for appending params to final URL of an ad.

TypeString
Display NameFinal URL suffix
XML AttributefinalURLSuffix
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

CreativeTrackingUrlTemplate

Tracking template of the ad.

TypeString
Display NameTracking template
XML AttributetrackingTemplate
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

CreativeUrlCustomParameters

List of custom parameters of the ad. CustomParameters elements are returned in JSON map format.

TypeCustomParameters
Display NameCustom parameter
XML AttributecustomParameter
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

CriterionId

The Criterion ID.

TypeLong
Display NameKeyword ID
XML AttributekeywordID
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

CriterionType

The type of criterion.

TypeApiCriterionType
Display NameCriteria Type
XML AttributecriteriaType
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

CrossDeviceConversions

Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in your AllConversions column. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameCross-device conv.
XML AttributecrossDeviceConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Ctr

The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameCTR
XML Attributectr
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

CurrentModelAttributedConversions

Shows how your historic Conversions data would look under the attribution model you've currently selected. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameConversions (current model)
XML AttributeconversionsCurrentModel
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

CurrentModelAttributedConversionValue

Shows how your historic ConversionValue data would look under the attribution model you've currently selected. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameConv. value (current model)
XML AttributeconvValueCurrentModel
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

CustomerDescriptiveName

The descriptive name of the Customer.

TypeString
Display NameClient name
XML AttributeclientName
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Date

The date formatted as yyyy-MM-dd.

TypeDate
Display NameDay
XML Attributeday
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

DayOfWeek

The name of the day of the week, e.g., "Monday".

TypeDayOfWeek
Display NameDay of week
XML AttributedayOfWeek
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

Description

The descriptive text of an expanded text ad or responsive display ad.

TypeString
Display NameDescription
XML Attributedescription
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Description1

Line 1 description of the Ad.

TypeString
Display NameDescription line 1
XML AttributedescriptionLine1
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Description2

Line 2 description of the Ad.

TypeString
Display NameDescription line 2
XML AttributedescriptionLine2
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Device

Device type where the impression was shown.

TypeDeviceType
Display NameDevice
XML Attributedevice
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

DevicePreference

Platform ID of the device preference. You can look up the corresponding name and other information in the Platforms reference.

TypeLong
Display NameDevice preference
XML AttributedevicePreference
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

DisplayUrl

Display URL of the Ad.

TypeString
Display NameDisplay URL
XML AttributedisplayURL
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

EngagementRate

How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameEngagement rate
XML AttributeengagementRate
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Engagements

The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.

TypeLong
Display NameEngagements
XML Attributeengagements
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

EnhancedDisplayCreativeLandscapeLogoImageMediaId

The ID of the landscape logo image.

TypeLong
Display NameLandscape logo ID (responsive)
XML AttributelandscapeLogoIDResponsive
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

EnhancedDisplayCreativeLogoImageMediaId

The ID of the logo image used in the ResponsiveDisplayAd.

TypeLong
Display NameLogo ID (responsive)
XML AttributelogoIDResponsive
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

EnhancedDisplayCreativeMarketingImageMediaId

"The ID of the marketing image used in the ResponsiveDisplayAd."

TypeLong
Display NameImage ID (responsive)
XML AttributeimageIDResponsive
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

EnhancedDisplayCreativeMarketingImageSquareMediaId

The ID of the square marketing image.

TypeLong
Display NameSquare image ID (responsive)
XML AttributesquareImageIDResponsive
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ExpandedDynamicSearchCreativeDescription2

The description 2 of the expanded dynamic search ad.

TypeString
Display NameExpanded Dynamic Search Ad Description 2
XML AttributeexpandedDynamicSearchAdDescription2
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ExpandedTextAdDescription2

The description 2 of the expanded text ad.

TypeString
Display NameExpanded Text Ad Description 2
XML AttributeexpandedTextAdDescription2
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ExpandedTextAdHeadlinePart3

The headline part 3 of the expanded text ad.

TypeString
Display NameExpanded Text Ad Headline 3
XML AttributeexpandedTextAdHeadline3
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ExternalConversionSource

The source of conversion such as website, import from calls.

TypeExternalConversionSource
Display NameConversion source
XML AttributeconversionSource
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ExternalCustomerId

The Customer ID.

TypeLong
Display NameCustomer ID
XML AttributecustomerID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

FormatSetting

The format setting of the responsive display ad.

TypeDisplayAdFormatSetting
Display NameAd format preference (responsive)
XML AttributeadFormatPreferenceResponsive
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

GmailCreativeHeaderImageMediaId

The ID of the header image in the GmailAd.

TypeLong
Display NameGmail ad header image media id
XML AttributegmailAdHeaderImageMediaId
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

GmailCreativeLogoImageMediaId

The ID of the logo image in the GmailAd teaser.

TypeLong
Display NameGmail ad logo image media id
XML AttributegmailAdLogoImageMediaId
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

GmailCreativeMarketingImageMediaId

The ID of the marketing image in the GmailAd.

TypeLong
Display NameGmail ad marketing image media id
XML AttributegmailAdMarketingImageMediaId
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

GmailForwards

The number of times your ad was forwarded to someone else as a message.

TypeLong
Display NameGmail forwards
XML AttributegmailForwards
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

GmailSaves

The number of times someone has saved your Gmail ad to their inbox as a message.

TypeLong
Display NameGmail saves
XML AttributegmailSaves
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

GmailSecondaryClicks

The number of clicks to your landing page on the expanded state of Gmail ads.

TypeLong
Display NameGmail clicks to website
XML AttributegmailClicksToWebsite
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

GmailTeaserBusinessName

The business name in the GmailAd teaser.

TypeString
Display NameGmail ad business name
XML AttributegmailAdBusinessName
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

GmailTeaserDescription

The description in the GmailAd teaser.

TypeString
Display NameGmail ad description
XML AttributegmailAdDescription
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

GmailTeaserHeadline

The headline in the GmailAd teaser.

TypeString
Display NameGmail ad headline
XML AttributegmailAdHeadline
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Headline

The ad headline for a TextAd. For other ad types such as TemplateAds, this field will contain a string representation of the key attributes of the ad.

TypeString
Display NameAd
XML Attributead
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

HeadlinePart1

The first part of an expanded text ad headline.

TypeString
Display NameHeadline 1
XML Attributeheadline1
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

HeadlinePart2

The second part of an expanded text ad headline.

TypeString
Display NameHeadline 2
XML Attributeheadline2
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Id

ID of the main object of this row.

TypeLong
Display NameAd ID
XML AttributeadID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ImageAdUrl

Prefix this value with "https://tpc.googlesyndication.com/pageadimg/imgad?id=" to get the full URL.

TypeString
Display NameImage Ad URL
XML AttributeimageAdURL
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

ImageCreativeImageHeight

The height of the image ad. For other ad types, this will have no values.

TypeInteger
Display NameImage Height
XML AttributeimageHeight
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ImageCreativeImageWidth

The width of the image ad. For other ad types, this will have no values.

TypeInteger
Display NameImage Width
XML AttributeimageWidth
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ImageCreativeMimeType

Image mime type. Only populated for image ads.

TypeInteger
Display NameImage Mime Type
XML AttributeimageMimeType
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ImageCreativeName

Name for the image ad.

TypeString
Display NameImage ad name
XML AttributeimageAdName
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ImpressionAssistedConversions

Total number of conversions for which this object triggered assist impressions prior to the last click. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.

TypeLong
Display NameImpr. Assisted Conv.
XML AttributeimprAssistedConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ImpressionAssistedConversionsOverLastClickConversions

Total number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameImpr. Assisted Conv. / Last Click Conv.
XML AttributeimprAssistedConvLastClickConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ImpressionAssistedConversionValue

Total value of all conversions for which this object triggered assist impressions. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameImpr. Assisted Conv. Value
XML AttributeimprAssistedConvValue
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Impressions

Count of how often your ad has appeared on a search results page or website on the Google Network.

TypeLong
Display NameImpressions
XML Attributeimpressions
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

InteractionRate

How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameInteraction Rate
XML AttributeinteractionRate
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Interactions

The number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.

TypeLong
Display NameInteractions
XML Attributeinteractions
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

InteractionTypes

The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.

TypeEnumSet
Display NameInteraction Types
XML AttributeinteractionTypes
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

IsNegative

Indicates if the criterion for this row is a negative (exclusion) criterion.

TypeEnum
Display NameIs negative
XML AttributeisNegative
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

LabelIds

List of label IDs for the main object of this row. List elements are returned in JSON list format.

TypeList
Display NameLabel IDs
XML AttributelabelIDs
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Labels

List of label names for the main object of this row. List elements are returned in JSON list format.

TypeList
Display NameLabels
XML Attributelabels
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

LongHeadline

The long format of the headline in a responsive display ad.

TypeString
Display NameLong headline
XML AttributelongHeadline
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

MainColor

The main color for the responsive display ad.

TypeString
Display NameMain color (responsive)
XML AttributemainColorResponsive
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

MarketingImageCallToActionText

The call-to-action text for the GmailAd.

TypeString
Display NameGmail ad marketing image call to action text
XML AttributegmailAdMarketingImageCallToActionText
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

MarketingImageCallToActionTextColor

The call-to-action text color for the GmailAd.

TypeString
Display NameGmail ad marketing image call to action text color
XML AttributegmailAdMarketingImageCallToActionTextColor
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

MarketingImageDescription

The description of the marketing image in the GmailAd.

TypeString
Display NameGmail ad marketing image description
XML AttributegmailAdMarketingImageDescription
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

MarketingImageHeadline

The headline of the marketing image in the GmailAd.

TypeString
Display NameGmail ad marketing image headline
XML AttributegmailAdMarketingImageHeadline
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Month

The first day of the month, formatted as yyyy-MM-dd.

TypeString
Display NameMonth
XML Attributemonth
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

MonthOfYear

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

TypeMonthOfYear
Display NameMonth of Year
XML AttributemonthOfYear
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdAccentColor

The accentColor setting for a MultiAssetResponsiveDisplayAd.

TypeString
Display NameAccent color (multi asset responsive display)
XML AttributeaccentColorMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdAllowFlexibleColor

The allowFlexibleColor setting for a MultiAssetResponsiveDisplayAd.

TypeEnum
Display NameAllow flexible color (multi asset responsive display)
XML AttributeallowFlexibleColorMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdBusinessName

The businessName setting for a MultiAssetResponsiveDisplayAd.

TypeString
Display NameBusiness name (multi asset responsive display)
XML AttributebusinessNameMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdCallToActionText

The callToActionText setting for a MultiAssetResponsiveDisplayAd.

TypeString
Display NameCall to action text (multi asset responsive display)
XML AttributecallToActionTextMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdDescriptions

The descriptions setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and TextAsset entities. List elements are returned in JSON list format.

TypeList
Display NameDescriptions (multi asset responsive display)
XML AttributedescriptionsMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdDynamicSettingsPricePrefix

The dynamicSettingsPricePrefix setting for a MultiAssetResponsiveDisplayAd.

TypeString
Display NamePrice prefix (multi asset responsive display)
XML AttributepricePrefixMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdDynamicSettingsPromoText

The dynamicSettingsPromoText setting for a MultiAssetResponsiveDisplayAd.

TypeString
Display NamePromotion text (multi asset responsive display)
XML AttributepromotionTextMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdFormatSetting

The formatSetting setting for a MultiAssetResponsiveDisplayAd.

TypeDisplayAdFormatSetting
Display NameAd format preference (multi asset responsive display)
XML AttributeadFormatPreferenceMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdHeadlines

The headline setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and TextAsset entities. List elements are returned in JSON list format.

TypeList
Display NameHeadlines (multi asset responsive display)
XML AttributeheadlinesMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdLandscapeLogoImages

The landscapeLogoImages setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and ImageAsset entities. List elements are returned in JSON list format.

TypeList
Display NameLandscape logos (multi asset responsive display)
XML AttributelandscapeLogosMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdLogoImages

The logoImages setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and ImageAsset entities. List elements are returned in JSON list format.

TypeList
Display NameLogos (multi asset responsive display)
XML AttributelogosMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdLongHeadline

The longHeadline setting for a MultiAssetResponsiveDisplayAd.

TypeAssetLink
Display NameLong headline (multi asset responsive display)
XML AttributelongHeadlineMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdMainColor

The mainColor setting for a MultiAssetResponsiveDisplayAd.

TypeString
Display NameMain color (multi asset responsive display)
XML AttributemainColorMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdMarketingImages

The marketingImages setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and ImageAsset entities. List elements are returned in JSON list format.

TypeList
Display NameImages (multi asset responsive display)
XML AttributeimagesMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdSquareMarketingImages

The squareMarketingImages setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and ImageAsset entities. List elements are returned in JSON list format.

TypeList
Display NameSquare images (multi asset responsive display)
XML AttributesquareImagesMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

MultiAssetResponsiveDisplayAdYouTubeVideos

YouTube video ID of the YouTube assets of multi-asset responsive display ad. List elements are returned in JSON list format.

TypeList
Display NameYoutube videos (multi asset responsive display)
XML AttributeyoutubeVideosMultiAssetResponsiveDisplay
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

Path1

The text that appears in the ad with the displayed URL for an expanded text ad.

TypeString
Display NamePath 1
XML Attributepath1
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Path2

In addition to "Path1", more text that appears in the ad with the displayed URL for an expanded text ad.

TypeString
Display NamePath 2
XML Attributepath2
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

PercentNewVisitors

Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". Imported from Google Analytics. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display Name% new sessions
XML AttributenewSessions
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

PolicySummary

Policy information for an ad.

TypeAdGroupAdPolicySummary
Display NamePolicy
XML Attributepolicy
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

PricePrefix

The prefix shown before prices.

TypeString
Display NamePrice prefix (responsive)
XML AttributepricePrefixResponsive
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

PromoText

The promotion text for the responsive display ad.

TypeString
Display NamePromotion text (responsive)
XML AttributepromotionTextResponsive
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Quarter

The first day of the quarter, formatted as yyyy-MM-dd. Uses the calendar year for quarters, e.g., the second quarter of 2014 starts on 2014-04-01.

TypeString
Display NameQuarter
XML Attributequarter
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

ResponsiveSearchAdDescriptions

A JSON string including details about all descriptive text for a responsive search ad, including the asset text, pinning, and performance label. List elements are returned in JSON list format.

TypeList
Display NameResponsive Search Ad descriptions
XML AttributeresponsiveSearchAdDescriptions
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

ResponsiveSearchAdHeadlines

A JSON string including details about all headlines for a responsive search ad, including the asset text, pinning, and performance label. List elements are returned in JSON list format.

TypeList
Display NameResponsive Search Ad headlines
XML AttributeresponsiveSearchAdHeadlines
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

ResponsiveSearchAdPath1

The text that appears in the ad with the displayed URL for a responsive search ad.

TypeString
Display NameResponsive Search Ad path 1
XML AttributeresponsiveSearchAdPath1
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ResponsiveSearchAdPath2

In addition to "ResponsiveSearchAdPath1", more text that appears in the ad with the displayed URL for a responsive search ad.

TypeString
Display NameResponsive Search Ad path 2
XML AttributeresponsiveSearchAdPath2
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ShortHeadline

The short format of the headline in a responsive display ad.

TypeString
Display NameShort headline
XML AttributeshortHeadline
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Slot

The position of the Ad.

TypeSlot
Display NameTop vs. Other
XML AttributetopVsOther
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

Status

The status of the main object in this row. For example, in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.

TypeStatus
Display NameAd state
XML AttributeadState
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

SystemManagedEntitySource

Indicates the source of a system-generated entity.

TypeSystemManagedEntitySource
Display NameSystem managed Entity Source
XML AttributesystemManagedEntitySource
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

TopImpressionPercentage

The percent of your ad impressions that are shown anywhere above the organic search results. See this Help Center article for details. A percentage can be returned as a real number ranging from 0.0 to 1.0. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameImpr. (Top) %
XML AttributeimprTop
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

UniversalAppAdDescriptions

The list of descriptions of the Universal App ad. List elements are returned in JSON list format.

TypeList
Display NameUniversal App Ad descriptions
XML AttributeuniversalAppAdDescriptions
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

UniversalAppAdHeadlines

The list of headers of the Universal App ad. List elements are returned in JSON list format.

TypeList
Display NameUniversal App Ad headlines
XML AttributeuniversalAppAdHeadlines
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

UniversalAppAdHtml5MediaBundles

The HTML5 media bundles attached to the ad. List elements are returned in JSON list format.

TypeList
Display NameUniversal App Ad html5 media bundles
XML AttributeuniversalAppAdHtml5MediaBundles
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

UniversalAppAdImages

The marketing images attached to the ad. List elements are returned in JSON list format.

TypeList
Display NameUniversal App Ad images
XML AttributeuniversalAppAdImages
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

UniversalAppAdMandatoryAdText

The ad text that must be displayed when the ad is served.

TypeAssetLink
Display NameUniversal App Ad mandatory ad text
XML AttributeuniversalAppAdMandatoryAdText
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

UniversalAppAdYouTubeVideos

The YouTube videos attached to the ad. List elements are returned in JSON list format.

TypeList
Display NameUniversal App Ad youTube videos
XML AttributeuniversalAppAdYouTubeVideos
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

ValuePerAllConversion

The value, on average, of all conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameValue / all conv.
XML AttributevalueAllConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ValuePerConversion

The total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameValue / conv.
XML AttributevalueConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ValuePerCurrentModelAttributedConversion

Shows how your historic ValuePerConversion data would look under the attribution model you've currently selected. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameValue / conv. (current model)
XML AttributevalueConvCurrentModel
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

VideoQuartile100Rate

Percentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameVideo played to 100%
XML AttributevideoPlayedTo100
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

VideoQuartile25Rate

Percentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameVideo played to 25%
XML AttributevideoPlayedTo25
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

VideoQuartile50Rate

Percentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameVideo played to 50%
XML AttributevideoPlayedTo50
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

VideoQuartile75Rate

Percentage of impressions where the viewer watched 75% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameVideo played to 75%
XML AttributevideoPlayedTo75
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

VideoViewRate

The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameView rate
XML AttributeviewRate
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

VideoViews

The number of times your video ads were viewed.

TypeLong
Display NameViews
XML Attributeviews
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ViewThroughConversions

The total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.

TypeLong
Display NameView-through conv.
XML AttributeviewThroughConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Week

The date for the Monday of the week, formatted as yyyy-MM-dd.

TypeString
Display NameWeek
XML Attributeweek
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

Year

The year, formatted as yyyy.

TypeInteger
Display NameYear
XML Attributeyear
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue