AccountDescriptiveName
|
The descriptive name of the Customer account.
Type | String |
Display Name | Account |
XML Attribute | account |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
AdGroupCount
|
The count of AdGroup objects using the bidding strategy.
Type | Integer |
Display Name | Ad Groups |
XML Attribute | adGroups |
Behavior | Metric |
Filterable | False |
Supports Zero Impressions | True |
|
AdGroupCriteriaCount
|
The count of AdGroupCriterion objects using the bidding strategy or label.
Type | Integer |
Display Name | Keywords |
XML Attribute | keywords |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
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.
Type | Double |
Display Name | All conv. rate |
XML Attribute | allConvRate |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
HourOfDay
|
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.
Type | Double |
Display Name | All conv. |
XML Attribute | allConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
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.
Type | Double |
Display Name | All conv. value |
XML Attribute | allConvValue |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
HourOfDay
|
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.
Type | Money |
Display Name | Avg. CPC |
XML Attribute | avgCPC |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
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.
Type | Money |
Display Name | Avg. CPM |
XML Attribute | avgCPM |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
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.
Type | Double |
Display Name | Avg. position |
XML Attribute | avgPosition |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
CampaignCount
|
The count of Campaign objects using the bidding strategy.
Type | Integer |
Display Name | Campaigns |
XML Attribute | campaigns |
Behavior | Metric |
Filterable | False |
Supports Zero Impressions | True |
|
Clicks
|
The number of clicks.
Type | Long |
Display Name | Clicks |
XML Attribute | clicks |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
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".
Type | String |
Display Name | Conversion category |
XML Attribute | conversionCategory |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Not compatible with the following fields:
AverageCpc
AverageCpm
AveragePosition
Clicks
Cost
Ctr
Impressions
|
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.
Type | Double |
Display Name | Conv. rate |
XML Attribute | convRate |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
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.
Type | Double |
Display Name | Conversions |
XML Attribute | conversions |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
ConversionTrackerId
|
ID of the conversion tracker.
Type | Long |
Display Name | Conversion Tracker Id |
XML Attribute | conversionTrackerId |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Not compatible with the following fields:
AverageCpc
AverageCpm
AveragePosition
Clicks
Cost
Ctr
Impressions
|
ConversionTypeName
|
The name of the conversion type. Prevents zero-conversion rows from being returned.
Type | String |
Display Name | Conversion name |
XML Attribute | conversionName |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Not compatible with the following fields:
AverageCpc
AverageCpm
AveragePosition
Clicks
Cost
Ctr
Impressions
|
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.
Type | Double |
Display Name | Total conv. value |
XML Attribute | totalConvValue |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
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.
Type | Money |
Display Name | Cost |
XML Attribute | cost |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
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.
Type | Money |
Display Name | Cost / all conv. |
XML Attribute | costAllConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
HourOfDay
|
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.
Type | Money |
Display Name | Cost / conv. |
XML Attribute | costConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
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.
Type | Double |
Display Name | Cross-device conv. |
XML Attribute | crossDeviceConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
HourOfDay
|
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.
Type | Double |
Display Name | CTR |
XML Attribute | ctr |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
CurrencyCode
|
ISO 4217 codes to specify the currency of monetary values.
Type | String |
Display Name | Currency |
XML Attribute | currency |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
Date
|
The date formatted as yyyy-MM-dd.
Type | Date |
Display Name | Day |
XML Attribute | day |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
|
DayOfWeek
|
The name of the day of the week, e.g., "Monday".
Type | DayOfWeek |
Display Name | Day of week |
XML Attribute | dayOfWeek |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
MONDAY | Monday |
TUESDAY | Tuesday |
WEDNESDAY | Wednesday |
THURSDAY | Thursday |
FRIDAY | Friday |
SATURDAY | Saturday |
SUNDAY | Sunday |
|
Device
|
Device type where the impression was shown.
Type | DeviceType |
Display Name | Device |
XML Attribute | device |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | Other |
DESKTOP | Computers |
HIGH_END_MOBILE | Mobile devices with full browsers |
TABLET | Tablets with full browsers |
CONNECTED_TV | Devices streaming video content to TV screens |
|
ExternalConversionSource
|
The source of conversion such as website, import from calls.
Type | ExternalConversionSource |
Display Name | Conversion source |
XML Attribute | conversionSource |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
UNKNOWN | Other |
WEBPAGE | Website |
ANALYTICS | Analytics |
UPLOAD | Import from clicks |
AD_CALL_METRICS | Calls from ads |
OFFERS | Offers |
ENGAGEMENT | Engagement ads |
WEBSITE_CALL_METRICS | Calls from website |
STORE_VISITS | Store visits |
ANDROID_IN_APP | Android in-app action |
ANDROID_DOWNLOAD | Android app install (from Google Play) |
IOS_IN_APP | iOS in-app action |
IOS_FIRST_OPEN | iOS app install (first open) |
APP_UNSPECIFIED | Mobile app |
ANDROID_FIRST_OPEN | Android app install (first open) |
UPLOAD_CALLS | Import from calls |
FIREBASE | Firebase |
CLICK_TO_CALL | Phone number clicks |
SALESFORCE | Salesforce.com |
STORE_SALES_CRM | Store sales (data partner) |
STORE_SALES_PAYMENT_NETWORK | Store sales (automated) |
GOOGLE_PLAY | Google Play |
THIRD_PARTY_APP_ANALYTICS | Third-party app analytics |
GOOGLE_ATTRIBUTION | Google Attribution |
STORE_SALES_DIRECT | Store sales (direct upload) |
Not compatible with the following fields:
AverageCpc
AverageCpm
AveragePosition
Clicks
Cost
Ctr
Impressions
|
ExternalCustomerId
|
The Customer ID.
Type | Long |
Display Name | Customer ID |
XML Attribute | customerID |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
HourOfDay
|
The hour of day as a number between 0 and 23, inclusive.
Type | Integer |
Display Name | Hour of day |
XML Attribute | hourOfDay |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Not compatible with the following fields:
AllConversionRate
AllConversionValue
CostPerAllConversion
CrossDeviceConversions
ValuePerAllConversion
|
Id
|
ID of the main object of this row.
Type | Long |
Display Name | Bid Strategy ID |
XML Attribute | bidStrategyID |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
Impressions
|
Count of how often your ad has appeared on a search results page or website on the Google Network.
Type | Long |
Display Name | Impressions |
XML Attribute | impressions |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
Month
|
The first day of the month, formatted as yyyy-MM-dd.
Type | String |
Display Name | Month |
XML Attribute | month |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
|
MonthOfYear
|
The name of the month of the year, e.g., "December".
Type | MonthOfYear |
Display Name | Month of Year |
XML Attribute | monthOfYear |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
JANUARY | January |
FEBRUARY | February |
MARCH | March |
APRIL | April |
MAY | May |
JUNE | June |
JULY | July |
AUGUST | August |
SEPTEMBER | September |
OCTOBER | October |
NOVEMBER | November |
DECEMBER | December |
|
Name
|
The name of the main object in this row. For example, in a Campaign Performance Report this will be the name of each row's Campaign. In an Ad Group Performance Report this will be the name of each row's AdGroup.
Type | String |
Display Name | Bid Strategy Name |
XML Attribute | bidStrategyName |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
NonRemovedAdGroupCount
|
The count of non-removed ad groups using the bidding strategy.
Type | Long |
Display Name | Non-Removed Ad Groups |
XML Attribute | nonRemovedAdGroups |
Behavior | Metric |
Filterable | False |
Supports Zero Impressions | True |
|
NonRemovedAdGroupCriteriaCount
|
The count of non-removed ad group criteria using the bidding strategy.
Type | Long |
Display Name | Non-Removed Keywords |
XML Attribute | nonRemovedKeywords |
Behavior | Metric |
Filterable | False |
Supports Zero Impressions | True |
|
NonRemovedCampaignCount
|
The count of non-removed campaigns using the bidding strategy.
Type | Long |
Display Name | Non-Removed Campaigns |
XML Attribute | nonRemovedCampaigns |
Behavior | Metric |
Filterable | False |
Supports Zero Impressions | True |
|
PageOnePromotedBidCeiling
|
Maximum bid limit for the PageOnePromotedBiddingScheme.
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.
Type | Money |
Display Name | Bid limit (Target search page location) |
XML Attribute | bidLimitTargetSearchPageLocation |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
PageOnePromotedBidChangesForRaisesOnly
|
Whether the PageOnePromoted strategy always follows bid estimate changes (false), or only increases (true).
Type | Enum |
Display Name | Bid automation (Target search page location) |
XML Attribute | bidAutomationTargetSearchPageLocation |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
Predicate values / display values
|
PageOnePromotedBidModifier
|
Bid multiplier defined on the PageOnePromotedBiddingScheme.
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.
Type | Double |
Display Name | Bid adjustment (Target search page location) |
XML Attribute | bidAdjustmentTargetSearchPageLocation |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
PageOnePromotedRaiseBidWhenBudgetConstrained
|
Whether the PageOnePromoted strategy is allowed to raise bids if the campaign is "Limited by budget".
Type | Enum |
Display Name | Limited budgets (Target search page location) |
XML Attribute | limitedBudgetsTargetSearchPageLocation |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
|
PageOnePromotedRaiseBidWhenLowQualityScore
|
Whether the PageOnePromoted strategy is allowed to raise bids on keywords with lower-range quality scores.
Type | Enum |
Display Name | Low quality keywords (Target search page location) |
XML Attribute | lowQualityKeywordsTargetSearchPageLocation |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
|
PageOnePromotedStrategyGoal
|
Strategy goal of where impressions will show on search result pages.
Type | StrategyGoal |
Display Name | Location (Target search page location) |
XML Attribute | locationTargetSearchPageLocation |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
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.
Type | String |
Display Name | Quarter |
XML Attribute | quarter |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
|
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.
Type | BiddingStrategyStatus |
Display Name | State |
XML Attribute | state |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
ENABLED | Enabled |
REMOVED | Removed |
UNKNOWN | unknown |
|
TargetCpa
|
The current target CPA set on the Target CPA bidding strategy.
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.
Type | Money |
Display Name | Target CPA |
XML Attribute | targetCPA |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
TargetCpaMaxCpcBidCeiling
|
The maximum CPC bid limit for the Target CPA bidding strategy.
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.
Type | Money |
Display Name | Upper Bid limit (Target CPA) |
XML Attribute | upperBidLimitTargetCPA |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
TargetCpaMaxCpcBidFloor
|
The minimum CPC bid limit for the Target CPA bidding strategy.
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.
Type | Money |
Display Name | Lower Bid limit (Target CPA) |
XML Attribute | lowerBidLimitTargetCPA |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
TargetOutrankShare
|
Target fraction of auctions where the advertiser should outrank the competitor.
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.
Type | Double |
Display Name | Target outranking share |
XML Attribute | targetOutrankingShare |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
TargetOutrankShareBidChangesForRaisesOnly
|
Whether the TargetRoas strategy always follows bid estimate changes (false), or only increases (true).
Type | Enum |
Display Name | Bid automation (Target Outranking Share) |
XML Attribute | bidAutomationTargetOutrankingShare |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
|
TargetOutrankShareCompetitorDomain
|
The competitor's visible domain URL for the TargetRoas strategy.
Type | String |
Display Name | Competitor domain (Target Outranking Share) |
XML Attribute | competitorDomainTargetOutrankingShare |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
TargetOutrankShareMaxCpcBidCeiling
|
The TargetRoas strategy's ceiling on max CPC bids.
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.
Type | Money |
Display Name | Upper Max Cpc Bid limit (Target Outranking Share) |
XML Attribute | upperMaxCpcBidLimitTargetOutrankingShare |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
TargetOutrankShareRaiseBidWhenLowQualityScore
|
Whether the TargetRoas strategy is allowed to raise bids on keywords with lower-range quality scores.
Type | Enum |
Display Name | Low quality keywords (Target Outranking Share) |
XML Attribute | lowQualityKeywordsTargetOutrankingShare |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
|
TargetRoas
|
The desired revenue (based on conversion data) per unit of spend for the TargetRoas BiddingStrategyConfiguration.
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.
Type | Double |
Display Name | Target ROAS |
XML Attribute | targetROAS |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
TargetRoasBidCeiling
|
Maximum bid limit that applies to all keywords managed by the TargetRoas BiddingStrategyConfiguration.
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.
Type | Money |
Display Name | Upper Bid limit (Target ROAS) |
XML Attribute | upperBidLimitTargetROAS |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
TargetRoasBidFloor
|
Minimum bid limit that applies to all keywords managed by the TargetRoas BiddingStrategyConfiguration.
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.
Type | Money |
Display Name | Lower Bid limit (Target ROAS) |
XML Attribute | lowerBidLimitTargetROAS |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
TargetSpendBidCeiling
|
The largest max CPC bid that can be set by the TargetSpend BiddingStrategyConfiguration.
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.
Type | Money |
Display Name | Bid limit (Maximize clicks) |
XML Attribute | bidLimitMaximizeClicks |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
TargetSpendSpendTarget
|
The spend target under which to maximize clicks. Specified by the TargetSpend BiddingStrategyConfiguration.
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.
Type | Money |
Display Name | Target spend (Maximize clicks) |
XML Attribute | targetSpendMaximizeClicks |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
Type
|
The type of the main object in this row. For example, in a Bid Goal Performance Report this will be the type of the BiddingStrategyConfiguration. In a Shared Set Report this will be the type of the SharedSet.
Type | BiddingStrategyType |
Display Name | Bid Strategy Type |
XML Attribute | bidStrategyType |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
MANUAL_CPC | cpc |
MANUAL_CPV | cpv |
MANUAL_CPM | cpm |
PAGE_ONE_PROMOTED | Target search page location |
TARGET_SPEND | Maximize clicks |
TARGET_CPA | Target CPA |
TARGET_ROAS | Target ROAS |
MAXIMIZE_CONVERSIONS | Maximize Conversions |
MAXIMIZE_CONVERSION_VALUE | Maximize Conversion Value |
TARGET_OUTRANK_SHARE | Target Outranking Share |
NONE | None |
UNKNOWN | unknown |
|
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.
Type | Double |
Display Name | Value / all conv. |
XML Attribute | valueAllConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
HourOfDay
|
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.
Type | Double |
Display Name | Value / conv. |
XML Attribute | valueConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
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.
Type | Long |
Display Name | View-through conv. |
XML Attribute | viewThroughConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
Week
|
The date for the Monday of the week, formatted as yyyy-MM-dd.
Type | String |
Display Name | Week |
XML Attribute | week |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
|
Year
|
The year, formatted as yyyy.
Type | Integer |
Display Name | Year |
XML Attribute | year |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
|