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

All reports

Below are the fields for all report types supported in AdWords API.

Download this table in CSV format

All reports

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.

AccentColor

The accent color for the responsive display ad.

AccountCurrencyCode

The currency of the Customer account.

AccountDescriptiveName

The descriptive name of the Customer account.

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.

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.

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.

ActiveViewImpressions

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

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.

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.

ActiveViewMeasurableImpressions

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

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.

AdFormat

The underlying media format of the ad. Values can be one of the formats on the Template Ads page, or a MediaType enum.

AdGroupCount

The count of AdGroup objects using the bidding strategy.

AdGroupCreativesCount

The count of AdGroupAd objects using the label.

AdGroupCriteriaCount

The count of AdGroupCriterion objects using the bidding strategy or label.

AdGroupCriterionStatus

Status of the ad group criterion (keyword, placement, etc.).

AdGroupDesktopBidModifier

Desktop bid modifier override at the ad group level. 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.

AdGroupId

The ID of the AdGroup.

AdGroupMobileBidModifier

Mobile bid modifier override at ad group level. 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.

AdGroupName

The name of the AdGroup.

AdGroupsCount

The count of ad groups using the bidding strategy or label.

AdGroupStatus

Status of the ad group.

AdGroupTabletBidModifier

Tablet bid modifier override at the ad group level. 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.

AdGroupType

The type of ad group.

AdId

The ID of the Ad. This field may contain IDs of ads that are not supported in the report request's API version.

AdNetworkType1

First level network type.

AdNetworkType2

Second level network type (includes search partners).

AdRotationMode

How often the ads in the ad group will be served relative to one another.

AdStrengthInfo

The strength information of the ad.

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".

AdVariationControlTrialArmId

If the impression was part of an ad variation and in the control arm, this represents the ad variation control arm ID.

AdVariationTreatmentTrialArmId

If the impression was part of an ad variation and in the treatment arm, this represents the ad variation treatment arm ID.

AdVariationTrialId

If the impression was part of an ad variation, this represents the ad variation trial ID.

AdvertisingChannelSubType

Optional refinement of the campaign's AdvertisingChannelType.

AdvertisingChannelType

Primary serving target for ads in the campaign.

AggregatorId

The multi-client account ID from Merchant Center.

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.

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.

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.

AllowFlexibleColor

Whether the responsive display ad colors must be strictly used.

Amount

The daily budget. On the Campaign Performance Report this column reflects the entire shared budget if the campaign draws from a shared budget. 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.

AoiCityCriteriaId

ID of the city of the Location criterion matching the location of interest associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

AoiCountryCriteriaId

ID of the country of the Location criterion matching the location of interest associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

AoiMetroCriteriaId

ID of the metro area of the Location criterion matching the location of interest associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

AoiMostSpecificTargetId

The most specific location target (Location of interest).

AoiRegionCriteriaId

ID of the region of the Location criterion matching the location of interest associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

ApprovalStatus

Approval status of the criterion.

AssociatedCampaignId

The ID of a Campaign associated with the Budget.

AssociatedCampaignName

The name of a Campaign associated with the Budget.

AssociatedCampaignStatus

The status of a Campaign associated with the Budget.

AttributeValues

The FeedItem's attribute values. List elements are returned in JSON list format.

Automated

Indicates if this ad is automatically created by Google Ads.

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.

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.

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.

AverageCpm

The description for this field varies by report.

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.

AverageFrequency

Average number of times a unique cookie was exposed to your ad over a given time period. Imported from Google Analytics. Deprecated. This field is only populated for dates prior to 2019-08-01. 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.

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.

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.

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.

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.

BaseCampaignId

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

BenchmarkAverageMaxCpc

Indicates how other advertisers are bidding on similar products. 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.

BenchmarkCtr

Indicates how other advertisers' Shopping ads for similar products are performing based on how often people who see their ad end up clicking on it. 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.

BiddingStrategyId

The ID of the BiddingStrategyConfiguration.

BiddingStrategyName

The name of the BiddingStrategyConfiguration.

BiddingStrategySource

Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.

BiddingStrategyType

The type of the BiddingStrategyConfiguration.

BidModifier

The bid modifier. To filter by this field, use values greater than 0 and less than or equal to 1. 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.

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.

Brand

The ProductBrand value of the product.

BudgetCampaignAssociationStatus

The status of the association between the Budget and the associated Campaign.

BudgetId

The ID of the Budget.

BudgetName

The name of the Budget.

BudgetReferenceCount

The number of campaigns actively using the budget.

BudgetStatus

The status of the Budget.

BusinessName

The business name in a reponsive display ad.

CallDuration

The duration of the call, in seconds.

CallEndTime

The end date and time of the call.

CallerCountryCallingCode

Country code of the caller.

CallerNationalDesignatedCode

Area code of the caller.

CallOnlyPhoneNumber

The phone number of call-only ad.

CallStartTime

The start date and time of the call.

CallStatus

The status of the call.

CallToActionText

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

CallTrackingDisplayLocation

Location (e.g., ad or landing page) of the impression where the phone number was shown.

CallType

The type of the call.

CampaignCount

The count of Campaign objects using the bidding strategy.

CampaignDesktopBidModifier

Desktop bid modifier override at the campaign level. 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.

CampaignGroupId

The ID of campaign group.

CampaignId

The ID of the Campaign.

CampaignLocationTargetId

Location ID of the matching campaign criterion.

CampaignMobileBidModifier

Mobile bid modifier of the campaign. To filter by this field, use values greater than 0 and less than or equal to 1. 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.

CampaignName

The name of the Campaign.

CampaignsCount

The count of Campaign objects using the label.

CampaignStatus

The status of the Campaign.

CampaignTabletBidModifier

Tablet bid modifier override at the campaign level. 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.

CampaignTrialType

The type of campaign. This shows if the campaign is a trial campaign or not.

CanManageClients

Indicates if the account is an MCC account (true) or a regular Google Ads account (false).

Category0

Top level theme category of the pages in your website domain.

Category1

First level theme category of the pages in your website domain.

Category2

Second level theme category of the pages in your website domain.

CategoryL1

The ProductBiddingCategory level 1 value of the product.

CategoryL2

The ProductBiddingCategory level 2 value of the product.

CategoryL3

The ProductBiddingCategory level 3 value of the product.

CategoryL4

The ProductBiddingCategory level 4 value of the product.

CategoryL5

The ProductBiddingCategory level 5 value of the product.

CategoryPaths

The themes of the pages in your website domain derived from your website's structure.

Channel

Channel of the product.

ChannelExclusivity

Channel exclusivity of the product.

CityCriteriaId

ID of the city Location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

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.

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.

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.

Clicks

The number of clicks.

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.

CombinedAdsOrganicClicks

Clicks from ads or organic search results.

CombinedAdsOrganicClicksPerQuery

CombinedAdsOrganicClicks divided by CombinedAdsOrganicQueries. 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.

CombinedAdsOrganicQueries

Total number of searches that returned pages from your site in the organic search results or triggered one of your ads.

CombinedApprovalStatus

Approval status that combines review state and status.

ContentBidCriterionTypeGroup

The type of criteria the ad group uses for absolute bids on the Display Network.

ContentBudgetLostImpressionShare

The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. A percentage returned as "xx.xx%", or the special value "> 90%". 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.

ContentImpressionShare

The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. A percentage returned as "xx.xx%", or the special value "< 10%". 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.

ContentRankLostImpressionShare

The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. A percentage returned as "xx.xx%", or the special value "> 90%". 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.

ConversionAdjustment

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

ConversionAdjustmentLagBucket

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

ConversionAttributionEventType

The event type to which the conversion was attributed.

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".

ConversionLagBucket

Days between click and conversion.

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.

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.

ConversionTrackerId

ID of the conversion tracker.

ConversionTypeName

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

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.

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.

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.

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.

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.

CountryCriteriaId

ID of the country Location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

CpcBid

Cost per click bid. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if AdWords is automatically setting the bid via the chosen bidding strategy, or c) "--" if no CPC bid applies to the row. 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.

CpcBidSource

Source of the CPC bid.

CpmBid

CPM (cost per thousand impressions) bid. 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.

CpmBidSource

Source of the CPM bid.

CpvBid

Cost per view bid. 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.

CpvBidSource

The source of the cost per view bid.

CreativeConversionRate

The number of clicks that converted divided by your total clicks that can be tracked to a conversion. 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.

CreativeConversions

The number of clicks that converted within your chosen conversion window. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.

CreativeDestinationUrl

Destination URL of the ad.

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.

CreativeFinalMobileUrls

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

CreativeFinalUrls

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

CreativeFinalUrlSuffix

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

CreativeId

ID of the ad.

CreativeQualityScore

The quality score of the ad.

CreativeStatus

Status of the ad.

CreativeTrackingUrlTemplate

Tracking template of the ad.

CreativeUrlCustomParameters

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

Criteria

Descriptive string for the Criterion. For more information on the format of criteria types in reports, see the Criteria prefixes section of the reporting guide.

CriteriaDestinationUrl

Destination URL of the criterion that triggered ads.

CriteriaId

The Criterion ID.

CriteriaParameters

Descriptive string for the Criterion. For more information on the format of criteria types in reports, see the Criteria prefixes section of the reporting guide.

CriteriaType

The type of the Criterion.

CriteriaTypeName

The descriptive name of the CriteriaType.

CriterionAttachmentLevel

The level at which the criterion association is defined.

CriterionId

The Criterion ID.

CriterionType

The type of criterion.

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.

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.

CurrencyCode

ISO 4217 codes to specify the currency of monetary values.

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.

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.

CustomAttribute0

The ProductCustomAttribute level 0 value of the product.

CustomAttribute1

The ProductCustomAttribute level 1 value of the product.

CustomAttribute2

The ProductCustomAttribute level 2 value of the product.

CustomAttribute3

The ProductCustomAttribute level 3 value of the product.

CustomAttribute4

The ProductCustomAttribute level 4 value of the product.

CustomerDescriptiveName

The descriptive name of the Customer.

Date

The date formatted as yyyy-MM-dd.

DayOfWeek

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

DeliveryMethod

Budget delivery method. Determines the rate at which the budget is spent.

Description

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

Description1

Line 1 description of the Ad.

Description2

Line 2 description of the Ad.

DestinationUrl

Destination URL for the impression.

Device

Device type where the impression was shown.

DevicePreference

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

DisapprovalShortNames

List of reasons why the FeedItem is not approved. List elements are returned in JSON list format.

DisplayName

Descriptive name for the criterion. For more information on the format of criteria types in reports, see the Criteria prefixes section of the reporting guide.

DisplayUrl

Display URL of the Ad.

DistanceBucket

Grouping of user distance from location extensions.

Domain

The description for this field varies by report.

EffectiveFinalUrl

Effective final URL of the impressions.

EffectiveTargetRoas

The effective target ROAS, taking overrides into account. 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.

EffectiveTargetRoasSource

The source of the effective target ROAS, taking overrides into account.

EffectiveTrackingUrlTemplate

Effective tracking URL of the impressions.

EndDate

The end date of the campaign, formatted as yyyy-MM-dd.

EndTime

The end time in which the FeedItem is no longer effective and will stop serving.

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.

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.

EnhancedCpcEnabled

Indicates if enhanced CPC is enabled on the bidding strategy.

EnhancedDisplayCreativeLandscapeLogoImageMediaId

The ID of the landscape logo image.

EnhancedDisplayCreativeLogoImageMediaId

The ID of the logo image used in the ResponsiveDisplayAd.

EnhancedDisplayCreativeMarketingImageMediaId

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

EnhancedDisplayCreativeMarketingImageSquareMediaId

The ID of the square marketing image.

EstimatedAddClicksAtFirstPositionCpc

Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.

EstimatedAddCostAtFirstPositionCpc

Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. 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.

ExpandedDynamicSearchCreativeDescription2

The description 2 of the expanded dynamic search ad.

ExpandedFinalUrlString

The final URL with ValueTrack parameters replaced with their final rendered values.

ExpandedTextAdDescription2

The description 2 of the expanded text ad.

ExpandedTextAdHeadlinePart3

The headline part 3 of the expanded text ad.

ExtensionPlaceholderCreativeId

ID of the ad where the extension appeared.

ExtensionPlaceholderType

Placeholder type indicating the type of extension.

ExternalConversionSource

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

ExternalCustomerId

The Customer ID.

FeedId

The Feed ID.

FeedItemAttributes

List of attribute values for the FeedItem.

FeedItemEndTime

End time at which the FeedItem is no longer effective and will stop serving.

FeedItemId

The FeedItem ID.

FeedItemStartTime

Start time when the FeedItem is effective and can begin serving.

FeedItemStatus

Status of the FeedItem.

FinalAppUrls

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

FinalMobileUrls

List of final mobile URLs of the main object of this row. UrlList elements are returned in JSON list format.

FinalUrl

Final URL of the impressions.

FinalUrls

List of final URLs of the main object of this row. UrlList elements are returned in JSON list format.

FinalUrlSuffix

URL template for appending params to final URL.

FirstPageCpc

Estimate of the CPC bid required in order to show your ad on the first page of search results. Usually a number in micros, but may be prefixed with "auto: " or may simply be the string "auto" if automatic bidding is used.

FirstPositionCpc

Estimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results. Usually a number in micros, but may be prefixed with "auto: " or may simply be the string "auto" if automatic bidding is used.

FormatSetting

The format setting of the responsive display ad.

GclId

The Google Click ID.

GeoTargetingCriterionId

Location ID of the feed item's geoTargeting.

GeoTargetingRestriction

The type of location that can be used for targeting.

GmailCreativeHeaderImageMediaId

The ID of the header image in the GmailAd.

GmailCreativeLogoImageMediaId

The ID of the logo image in the GmailAd teaser.

GmailCreativeMarketingImageMediaId

The ID of the marketing image in the GmailAd.

GmailForwards

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

GmailSaves

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

GmailSecondaryClicks

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

GmailTeaserBusinessName

The business name in the GmailAd teaser.

GmailTeaserDescription

The description in the GmailAd teaser.

GmailTeaserHeadline

The headline in the GmailAd teaser.

HasQualityScore

Whether the QualityScore field of the criterion has value. Use this field in a report request predicate to include or exclude criteria with or without a value for the QualityScore field.

HasRecommendedBudget

Whether there is a recommended budget for this object.

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.

HeadlinePart1

The first part of an expanded text ad headline.

HeadlinePart2

The second part of an expanded text ad headline.

HistoricalCreativeQualityScore

The quality of historical ad relevance.

HistoricalLandingPageQualityScore

The quality of historical landing page experience.

HistoricalQualityScore

The historical quality score.

HistoricalSearchPredictedCtr

The historical expected clickthrough rate.

HourOfDay

The hour of day as a number between 0 and 23, inclusive.

Id

ID of the main object of this row.

ImageAdUrl

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

ImageCreativeImageHeight

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

ImageCreativeImageWidth

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

ImageCreativeMimeType

Image mime type. Only populated for image ads.

ImageCreativeName

Name for the image ad.

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.

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.

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.

ImpressionReach

Number of unique cookies that were exposed to your ad over a given time period, or the special value "< 100" if the number of cookies is less than 100. Deprecated. This field is only populated for dates prior to 2019-08-01.

Impressions

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

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.

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.

InteractionTypes

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

InvalidClickRate

The percentage ("x.xx%") of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. 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.

InvalidClicks

Number of clicks Google considers illegitimate and doesn't charge you for.

IsAutoOptimized

Indicates if Display Campaign Optimizer is enabled for the ad group. Corresponds to the ad group's ExplorerAutoOptimizerSetting.

IsAutoTaggingEnabled

Indicates if auto tagging is enabled on the account.

IsBidOnPath

Indicates if the placement was added as a criterion.

IsBudgetExplicitlyShared

Indicates if the budget is a shared budget (true) or specific to the campaign (false).

IsNegative

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

IsPathExcluded

Indicates if the URL or placement is currently excluded.

IsRestrict

A value of 'true' indicates that the criterion type is used for bidding and restricting targeting. A value of 'false' indicates that the criterion type is used only for bidding. This will have the opposite value from that of targetAll for the criteria's corresponding AdGroup.TargetingSettingDetail. For example, if the TargetingSettingDetail for criterionTypeGroup = PLACEMENT has targetAll = true, then the IsRestrict field will be false for Placement criteria.

IsSelfAction

Indicates if the extension for the placeholder feed item of this row was clicked (true) or merely displayed (false).

IsTargetingLocation

Indicates whether the row's location (among all of the locations associated with an impression) was the targeting location for the impressions in that row.

IsTestAccount

Indicates if the account is a test account.

KeywordId

The ID of the Keyword that triggered the ad.

KeywordMatchType

The match type for the Keyword.

KeywordTargetingId

The ID of the feed item's keyword targeting.

KeywordTargetingMatchType

Match type of the feed item's keywordTargeting.

KeywordTargetingText

Text of the feed item's keywordTargeting.

KeywordTextMatchingQuery

Keyword that matched the query and triggered the ad.

LabelId

The ID of the Label.

LabelIds

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

LabelName

The name of the Label.

Labels

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

LanguageCriteriaId

Language of the product information.

Line1

The dynamically generated headline of the Dynamic Search Ad.

LocationType

The type of location. Location of interest (AREA_OF_INTEREST) indicates a location that the user showed interest in. Physical location (LOCATION_OF_PRESENCE) is where a user is located or is regularly located.

LongHeadline

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

LopCityCriteriaId

ID of the city of the Location criterion matching the physical location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

LopCountryCriteriaId

ID of the country of the Location criterion matching the physical location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

LopMetroCriteriaId

ID of the metro area of the Location criterion matching the physical location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

LopMostSpecificTargetId

The most specific location target (Physical location).

LopRegionCriteriaId

ID of the region of the Location criterion matching the physical location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

MainColor

The main color for the responsive display ad.

MarketingImageCallToActionText

The call-to-action text for the GmailAd.

MarketingImageCallToActionTextColor

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

MarketingImageDescription

The description of the marketing image in the GmailAd.

MarketingImageHeadline

The headline of the marketing image in the GmailAd.

MaximizeConversionValueTargetRoas

The target ROAS that was set for maximizing revenue while averaging the target return on ad spend. 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.

MemberCount

The number of entities in the shared set.

MerchantId

ID of the Google Merchant Center account associated with the products being advertised.

MetroCriteriaId

ID of the metro area Location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

Month

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

MonthOfYear

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

MostSpecificCriteriaId

ID of the most specific Location criterion associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

MultiAssetResponsiveDisplayAdAccentColor

The accentColor setting for a MultiAssetResponsiveDisplayAd.

MultiAssetResponsiveDisplayAdAllowFlexibleColor

The allowFlexibleColor setting for a MultiAssetResponsiveDisplayAd.

MultiAssetResponsiveDisplayAdBusinessName

The businessName setting for a MultiAssetResponsiveDisplayAd.

MultiAssetResponsiveDisplayAdCallToActionText

The callToActionText setting for a MultiAssetResponsiveDisplayAd.

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.

MultiAssetResponsiveDisplayAdDynamicSettingsPricePrefix

The dynamicSettingsPricePrefix setting for a MultiAssetResponsiveDisplayAd.

MultiAssetResponsiveDisplayAdDynamicSettingsPromoText

The dynamicSettingsPromoText setting for a MultiAssetResponsiveDisplayAd.

MultiAssetResponsiveDisplayAdFormatSetting

The formatSetting setting for a MultiAssetResponsiveDisplayAd.

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.

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.

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.

MultiAssetResponsiveDisplayAdLongHeadline

The longHeadline setting for a MultiAssetResponsiveDisplayAd.

MultiAssetResponsiveDisplayAdMainColor

The mainColor setting for a MultiAssetResponsiveDisplayAd.

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.

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.

MultiAssetResponsiveDisplayAdYouTubeVideos

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

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.

NonRemovedAdGroupCount

The count of non-removed ad groups using the bidding strategy.

NonRemovedAdGroupCriteriaCount

The count of non-removed ad group criteria using the bidding strategy.

NonRemovedCampaignCount

The count of non-removed campaigns using the bidding strategy.

NumOfflineImpressions

Number of offline phone impressions.

NumOfflineInteractions

Number of offline phone calls.

OfferId

Offer/item ID of the product.

OfflineInteractionRate

Number of phone calls received (NumOfflineInteractions) divided by the number of times your phone number is shown (NumOfflineImpressions). 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.

OrganicAveragePosition

Average top position of your organic listing (or multiple listings) for each query. 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.

OrganicClicks

Number of times someone clicked your site's listing in the unpaid results for a particular query.

OrganicClicksPerQuery

Number of clicks you've received on your organic search listings divided by the total number of searches that returned pages from your site. 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.

OrganicImpressions

Number of organic search listing impressions.

OrganicImpressionsPerQuery

Average number of times a page from your site was listed per query. 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.

OrganicQueries

Total number of searches that returned organic search results for your site over the given period.

Page

Page number in search results where the ad was shown.

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.

PageOnePromotedBidChangesForRaisesOnly

Whether the PageOnePromoted strategy always follows bid estimate changes (false), or only increases (true).

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.

PageOnePromotedRaiseBidWhenBudgetConstrained

Whether the PageOnePromoted strategy is allowed to raise bids if the campaign is "Limited by budget".

PageOnePromotedRaiseBidWhenLowQualityScore

Whether the PageOnePromoted strategy is allowed to raise bids on keywords with lower-range quality scores.

PageOnePromotedStrategyGoal

Strategy goal of where impressions will show on search result pages.

Parameter

The WebpageParameter criterion.

ParentCriterionId

Criterion ID of the product partition's parent.

PartitionType

The partition type of the ProductPartition criterion.

Path1

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

Path2

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

PercentageMobileFriendlyClicks

The percentage of mobile clicks that go to a mobile-friendly page. 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.

PercentageValidAcceleratedMobilePagesClicks

The percentage of ad clicks to AMP (accelerated mobile pages) landing pages that reach a valid AMP page. 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.

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.

Period

Period over which to spend the budget.

PlaceholderType

Placeholder type indicating the type of extension.

PolicySummary

Policy information for an ad.

PostClickQualityScore

The quality score of the landing page.

PricePrefix

The prefix shown before prices.

ProductCondition

The ProductCanonicalCondition of the product.

ProductGroup

Path to the ProductPartition, including all of its parent partitions.

ProductTitle

The title of the product.

ProductTypeL1

The ProductType level 1 value of the product.

ProductTypeL2

The ProductType level 2 value of the product.

ProductTypeL3

The ProductType level 3 value of the product.

ProductTypeL4

The ProductType level 4 value of the product.

ProductTypeL5

The ProductType level 5 value of the product.

PromoText

The promotion text for the responsive display ad.

QualityScore

The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). If quality score information is missing, then "--" will be returned. You can filter using the "HasQualityScore" column to include or exclude criteria with or without a value for the QualityScore field. See the reporting concepts guide for more details.

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.

Query

If the string for this attribute is longer than 128 char bytes, the returned result will NOT be a single aggregated row.

QueryMatchType

Match type of the keyword that triggered the ad.

QueryMatchTypeWithVariant

Match type of the keyword that triggered the ad, including variants. See https://support.google.com/google-ads/answer/2472708 for an explanation of close variants.

QueryTargetingStatus

Indicates whether the search term is currently one of your targeted or excluded keywords.

RecommendedBudgetAmount

The recommended budget amount. 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.

RecommendedBudgetEstimatedChangeInWeeklyClicks

The estimated change in weekly clicks if the recommended budget is applied.

RecommendedBudgetEstimatedChangeInWeeklyCost

The estimated change in weekly cost if the recommended budget is applied. 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.

RecommendedBudgetEstimatedChangeInWeeklyInteractions

The estimated change in weekly interactions if the recommended budget is applied.

RecommendedBudgetEstimatedChangeInWeeklyViews

The estimated change in weekly views if the recommended budget is applied.

ReferenceCount

The number of campaigns that actively use the shared set.

RegionCriteriaId

ID of the region Location associated with the impression. You can look up the corresponding name and other information using LocationCriterionService.

RelativeCtr

Your clickthrough rate (Ctr) divided by the average clickthrough rate of all advertisers on the websites that show your ads. Measures how your ads perform on Display Network sites compared to other ads on the same sites. 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.

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.

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.

ResponsiveSearchAdPath1

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

ResponsiveSearchAdPath2

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

Scheduling

Schedule specifying when the FeedItem may serve. FeedItemScheduling elements are returned in JSON list format.

SearchAbsoluteTopImpressionShare

The impressions you've received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location. See this Help Center article for details. A percentage returned as "xx.xx%", or the special value "< 10%". 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.

SearchBudgetLostAbsoluteTopImpressionShare

The number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. See this Help Center article for details. A percentage returned as "xx.xx%", or the special value "< 10%". 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.

SearchBudgetLostImpressionShare

The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. A percentage returned as "xx.xx%", or the special value "> 90%". 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.

SearchBudgetLostTopImpressionShare

The number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. See this Help Center article for details. A percentage returned as "xx.xx%", or the special value "< 10%". 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.

SearchClickShare

The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. A percentage returned as "xx.xx%", or the special value "< 10%". 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.

SearchExactMatchImpressionShare

The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. A percentage returned as "xx.xx%", or the special value "< 10%". 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.

SearchImpressionShare

The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. A percentage returned as "xx.xx%", or the special value "< 10%". 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.

SearchPredictedCtr

Clickthrough rate compared to that of other advertisers.

SearchQuery

Query that led to the impression.

SearchRankLostAbsoluteTopImpressionShare

The number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. 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.

SearchRankLostImpressionShare

The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. A percentage returned as "xx.xx%", or the special value "> 90%". 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.

SearchRankLostTopImpressionShare

The number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. 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.

SearchTopImpressionShare

The impressions you've received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location. 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.

SerpType

The type of search result.

ServingStatus

Indicates if the Campaign is serving ads.

SharedSetId

The ID of the SharedSet.

SharedSetName

The name of the SharedSet.

SharedSetType

The type of the SharedSet.

ShortHeadline

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

Slot

The position of the Ad.

SpeedScore

A measure of how quickly your page loads after clicks on your mobile ads. The score is a range from 1 to 10, 10 being fastest.

StartDate

The start date of the campaign, formatted as yyyy-MM-dd.

StartTime

The start time in which the FeedItem is effective and can begin serving.

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.

StoreId

Store ID of the product.

SystemManagedEntitySource

Indicates the source of a system-generated entity.

SystemServingStatus

Serving status of the criterion.

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.

TargetCpaBidSource

The level at which the target CPA bid was set. This is applicable only at the ad group level.

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.

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.

TargetingAdGroupId

Ad group ID of the feed item's adGroupTargeting.

TargetingCampaignId

Campaign ID of the feed item's campaignTargeting.

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.

TargetOutrankShareBidChangesForRaisesOnly

Whether the TargetRoas strategy always follows bid estimate changes (false), or only increases (true).

TargetOutrankShareCompetitorDomain

The competitor's visible domain URL for the TargetRoas strategy.

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.

TargetOutrankShareRaiseBidWhenLowQualityScore

Whether the TargetRoas strategy is allowed to raise bids on keywords with lower-range quality scores.

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.

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.

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.

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.

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.

Title

Title of the landing page.

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.

TopOfPageCpc

Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. Usually a number in micros, but may be prefixed with "auto: " or may simply be the string "auto" if automatic bidding is used.

TotalAmount

The total budget amount, if you set a campaign's total budget in the Google Ads UI. Currently, campaign total budgets are only available for video campaigns with a specific start and end date. See this Help Center article to learn more about this option. 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.

TrackingUrlTemplate

Tracking template of the main object of this row.

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.

UnexpandedFinalUrlString

The final URL with ValueTrack parameter templates left in place.

UniversalAppAdDescriptions

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

UniversalAppAdHeadlines

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

UniversalAppAdHtml5MediaBundles

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

UniversalAppAdImages

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

UniversalAppAdMandatoryAdText

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

UniversalAppAdYouTubeVideos

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

Url

The description for this field varies by report.

UrlCustomParameters

Custom URL parameters of the main object of this row. CustomParameters elements are returned in JSON map format.

UserListId

The ID of the UserList (audience).

UserListName

The name of the AdwordsUserList.

UserListsCount

The count of UserList objects using the label.

ValidationDetails

Details about the validation state for the FeedItem. List elements are returned in JSON list format.

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.

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.

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.

VerticalId

The ID of vertical.

VideoChannelId

The video channel ID.

VideoDuration

The duration of the video in milliseconds.

VideoId

The video ID.

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.

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.

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.

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.

VideoTitle

The video title.

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.

VideoViews

The number of times your video ads were viewed.

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.

Week

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

Year

The year, formatted as yyyy.