What is Google ad performance?

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.

Show

info_outline Attribute

AccentColor
AccountCurrencyCode
AccountDescriptiveName
AccountTimeZone
AdGroupId
AdGroupName
AdGroupStatus
AdStrengthInfo
AdType
AllowFlexibleColor
Automated
BaseAdGroupId
BaseCampaignId
BusinessName
CallOnlyPhoneNumber
CallToActionText
CampaignId
CampaignName
CampaignStatus
CombinedApprovalStatus
ConversionAdjustment
CreativeDestinationUrl
CreativeFinalAppUrls
CreativeFinalMobileUrls
CreativeFinalUrls
CreativeFinalUrlSuffix
CreativeTrackingUrlTemplate
CreativeUrlCustomParameters
CustomerDescriptiveName
Description
Description1
Description2
DevicePreference
DisplayUrl
EnhancedDisplayCreativeLandscapeLogoImageMediaId
EnhancedDisplayCreativeLogoImageMediaId
EnhancedDisplayCreativeMarketingImageMediaId
EnhancedDisplayCreativeMarketingImageSquareMediaId
ExpandedDynamicSearchCreativeDescription2
ExpandedTextAdDescription2
ExpandedTextAdHeadlinePart3
ExternalCustomerId
FormatSetting
GmailCreativeHeaderImageMediaId
GmailCreativeLogoImageMediaId
GmailCreativeMarketingImageMediaId
GmailTeaserBusinessName
GmailTeaserDescription
GmailTeaserHeadline
Headline
HeadlinePart1
HeadlinePart2
Id
ImageAdUrl
ImageCreativeImageHeight
ImageCreativeImageWidth
ImageCreativeMimeType
ImageCreativeName
IsNegative
LabelIds
Labels
LongHeadline
MainColor
MarketingImageCallToActionText
MarketingImageCallToActionTextColor
MarketingImageDescription
MarketingImageHeadline
MultiAssetResponsiveDisplayAdAccentColor
MultiAssetResponsiveDisplayAdAllowFlexibleColor
MultiAssetResponsiveDisplayAdBusinessName
MultiAssetResponsiveDisplayAdCallToActionText
MultiAssetResponsiveDisplayAdDescriptions
MultiAssetResponsiveDisplayAdDynamicSettingsPricePrefix
MultiAssetResponsiveDisplayAdDynamicSettingsPromoText
MultiAssetResponsiveDisplayAdFormatSetting
MultiAssetResponsiveDisplayAdHeadlines
MultiAssetResponsiveDisplayAdLandscapeLogoImages
MultiAssetResponsiveDisplayAdLogoImages
MultiAssetResponsiveDisplayAdLongHeadline
MultiAssetResponsiveDisplayAdMainColor
MultiAssetResponsiveDisplayAdMarketingImages
MultiAssetResponsiveDisplayAdSquareMarketingImages
MultiAssetResponsiveDisplayAdYouTubeVideos
Path2
Path2
PolicySummary
PricePrefix
PromoText
ResponsiveSearchAdDescriptions
ResponsiveSearchAdHeadlines
ResponsiveSearchAdPath2
ResponsiveSearchAdPath2
ShortHeadline
Status
SystemManagedEntitySource
UniversalAppAdDescriptions
UniversalAppAdHeadlines
UniversalAppAdHtml5MediaBundles
UniversalAppAdImages
UniversalAppAdMandatoryAdText
UniversalAppAdYouTubeVideos

layers Segment

AdNetworkType1
AdNetworkType2
ClickType
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
CriterionId
CriterionType
Date
DayOfWeek
Device
ExternalConversionSource
Month
MonthOfYear
Quarter
Slot
Week
Year

show_chart Metric

AbsoluteTopImpressionPercentage
ActiveViewCpm
ActiveViewCtr
ActiveViewImpressions
ActiveViewMeasurability
ActiveViewMeasurableCost
ActiveViewMeasurableImpressions
ActiveViewViewability
AllConversionRate
AllConversions
AllConversionValue
AverageCost
AverageCpc
AverageCpe
AverageCpm
AverageCpv
AveragePageviews
AveragePosition
AverageTimeOnSite
BounceRate
ClickAssistedConversions
ClickAssistedConversionsOverLastClickConversions
ClickAssistedConversionValue
Clicks
ConversionRate
Conversions
ConversionValue
Cost
CostPerAllConversion
CostPerConversion
CostPerCurrentModelAttributedConversion
CrossDeviceConversions
Ctr
CurrentModelAttributedConversions
CurrentModelAttributedConversionValue
EngagementRate
Engagements
GmailForwards
GmailSaves
GmailSecondaryClicks
ImpressionAssistedConversions
ImpressionAssistedConversionsOverLastClickConversions
ImpressionAssistedConversionValue
Impressions
InteractionRate
Interactions
InteractionTypes
PercentNewVisitors
TopImpressionPercentage
ValuePerAllConversion
ValuePerConversion
ValuePerCurrentModelAttributedConversion
VideoQuartile100Rate
VideoQuartile25Rate
VideoQuartile50Rate
VideoQuartile75Rate
VideoViewRate
VideoViews
ViewThroughConversions

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

Path2

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

TypeString Display NamePath 1 XML Attributepath2 BehaviorAttribute FilterableTrue Supports Zero ImpressionsTrue

Path2

In addition to "Path2", 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

ResponsiveSearchAdPath2

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

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

ResponsiveSearchAdPath2

In addition to "ResponsiveSearchAdPath2", 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