All reports

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

Download this table in CSV format

All reports

AccentColor

AccentColor

The accent color for the responsive display ad.

AccountCurrencyCode

AccountCurrencyCode

The currency of the Customer account.

AccountDescriptiveName

AccountDescriptiveName

The descriptive name of the Customer account.

AccountTimeZone

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

ActiveViewCpm

Average cost of viewable impressions (ActiveViewImpressions).

ActiveViewCtr

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

ActiveViewImpressions

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

ActiveViewMeasurability

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

ActiveViewMeasurableCost

The cost of the impressions you received that were measurable by Active View.

ActiveViewMeasurableImpressions

ActiveViewMeasurableImpressions

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

ActiveViewViewability

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

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

AdGroupCount

The count of AdGroup objects using the bidding strategy.

AdGroupCreativesCount

AdGroupCreativesCount

The count of AdGroupAd objects using the label.

AdGroupCriteriaCount

AdGroupCriteriaCount

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

AdGroupCriterionStatus

AdGroupCriterionStatus

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

AdGroupDesktopBidModifier

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

AdGroupId

The ID of the AdGroup.

AdGroupMobileBidModifier

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

AdGroupName

The name of the AdGroup.

AdGroupsCount

AdGroupsCount

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

AdGroupStatus

AdGroupStatus

Status of the ad group.

AdGroupTabletBidModifier

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

AdGroupType

The type of ad group.

AdId

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

AdNetworkType1

First level network type.

AdNetworkType2

AdNetworkType2

Second level network type (includes search partners).

AdType

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

AdvertisingChannelSubType

AdvertisingChannelSubType

Optional refinement of the campaign's AdvertisingChannelType.

AdvertisingChannelType

AdvertisingChannelType

Primary serving target for ads in the campaign.

AggregatorId

AggregatorId

The multi-client account ID from Merchant Center.

AllConversionRate

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

AllConversions

Best estimate of the total number of conversions that AdWords 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

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

AllowFlexibleColor

Whether the responsive display ad colors must be strictly used.

Amount

Amount

The daily budget. On the Campaign Performance Report this column reflects the entire shared budget if the campaign draws from a shared budget.

AoiCityCriteriaId

AoiCityCriteriaId

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

AoiCountryCriteriaId

AoiCountryCriteriaId

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

AoiMetroCriteriaId

AoiMetroCriteriaId

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

AoiMostSpecificTargetId

AoiMostSpecificTargetId

The most specific location target (Location of interest).

AoiRegionCriteriaId

AoiRegionCriteriaId

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

ApprovalStatus

ApprovalStatus

Approval status of the criterion.

AssociatedCampaignId

AssociatedCampaignId

The ID of a Campaign associated with the Budget.

AssociatedCampaignName

AssociatedCampaignName

The name of a Campaign associated with the Budget.

AssociatedCampaignStatus

AssociatedCampaignStatus

The status of a Campaign associated with the Budget.

AttributeValues

AttributeValues

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

AverageCost

AverageCost

The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.

AverageCpc

AverageCpc

The total cost of all clicks divided by the total number of clicks received.

AverageCpe

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

AverageCpm

The description for this field varies by report.

AverageCpv

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

AverageFrequency

Average number of times a unique cookie was exposed to your ad over a given time period. 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.

AveragePageviews

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

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

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

BaseAdGroupId

The ID of base ad group of trial ad groups. For regular ad groups, this is equal to AdGroupId.

BaseCampaignId

BaseCampaignId

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

BenchmarkAverageMaxCpc

BenchmarkAverageMaxCpc

Indicates how other advertisers are bidding on similar products.

BenchmarkCtr

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

BiddingStrategyId

The ID of the BiddingStrategyConfiguration.

BiddingStrategyName

BiddingStrategyName

The name of the BiddingStrategyConfiguration.

BiddingStrategySource

BiddingStrategySource

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

BiddingStrategyType

BiddingStrategyType

The type of the BiddingStrategyConfiguration.

BidModifier

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.

BidType

BidType

The bid type.

BounceRate

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

Brand

The ProductBrand value of the product.

BudgetCampaignAssociationStatus

BudgetCampaignAssociationStatus

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

BudgetId

BudgetId

The ID of the Budget.

BudgetName

BudgetName

The name of the Budget.

BudgetReferenceCount

BudgetReferenceCount

The number of campaigns actively using the budget.

BudgetStatus

BudgetStatus

The status of the Budget.

BusinessName

BusinessName

The business name in a reponsive display ad.

CallDuration

CallDuration

The duration of the call, in seconds.

CallEndTime

CallEndTime

The end date and time of the call.

CallerCountryCallingCode

CallerCountryCallingCode

Country code of the caller.

CallerNationalDesignatedCode

CallerNationalDesignatedCode

Area code of the caller.

CallOnlyPhoneNumber

CallOnlyPhoneNumber

The phone number of call-only ad.

CallStartTime

CallStartTime

The start date and time of the call.

CallStatus

CallStatus

The status of the call.

CallToActionText

CallToActionText

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

CallTrackingDisplayLocation

CallTrackingDisplayLocation

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

CallType

CallType

The type of the call.

CampaignCount

CampaignCount

The count of Campaign objects using the bidding strategy.

CampaignDesktopBidModifier

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

CampaignGroupId

The ID of campaign group.

CampaignId

CampaignId

The ID of the Campaign.

CampaignLocationTargetId

CampaignLocationTargetId

Location ID of the matching campaign criterion.

CampaignMobileBidModifier

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

CampaignName

The name of the Campaign.

CampaignsCount

CampaignsCount

The count of Campaign objects using the label.

CampaignStatus

CampaignStatus

The status of the Campaign.

CampaignTabletBidModifier

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

CampaignTrialType

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

CanManageClients

CanManageClients

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

Category0

Category0

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

Category1

Category1

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

Category2

Category2

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

CategoryL1

CategoryL1

The ProductBiddingCategory level 1 value of the product.

CategoryL2

CategoryL2

The ProductBiddingCategory level 2 value of the product.

CategoryL3

CategoryL3

The ProductBiddingCategory level 3 value of the product.

CategoryL4

CategoryL4

The ProductBiddingCategory level 4 value of the product.

CategoryL5

CategoryL5

The ProductBiddingCategory level 5 value of the product.

CategoryPaths

CategoryPaths

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

Channel

Channel

Channel of the product.

ChannelExclusivity

ChannelExclusivity

Channel exclusivity of the product.

CityCriteriaId

CityCriteriaId

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

ClickAssistedConversions

ClickAssistedConversions

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

ClickAssistedConversionsOverLastClickConversions

ClickAssistedConversionsOverLastClickConversions

The total number of conversions for which this keyword, ad, ad group, or campaign received assist 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

ClickAssistedConversionValue

The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assist 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

Clicks

The number of clicks.

ClickType

ClickType

The Impressions field will reflect how often the ad was served with that click type available. Since ads can serve with multiple click types displayed, impressions may be double counted and the totals may not be accurate.

CombinedAdsOrganicClicks

CombinedAdsOrganicClicks

Clicks from ads or organic search results.

CombinedAdsOrganicClicksPerQuery

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

CombinedAdsOrganicQueries

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

CombinedApprovalStatus

CombinedApprovalStatus

Approval status that combines review state and status.

ContentBidCriterionTypeGroup

ContentBidCriterionTypeGroup

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

ContentBudgetLostImpressionShare

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

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

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.

ConversionCategoryName

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

ConversionRate

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

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

ConversionTrackerId

ID of the conversion tracker.

ConversionTypeName

ConversionTypeName

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

ConversionValue

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

Cost

The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.

CostPerAllConversion

CostPerAllConversion

Total cost divided by all conversions.

CostPerConversion

CostPerConversion

The Cost attributable to conversion-tracked clicks divided by the number of conversions

CostPerCurrentModelAttributedConversion

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

CountryCriteriaId

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

CpcBid

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.

CpcBidSource

CpcBidSource

Source of the CPC bid.

CpmBid

CpmBid

CPM (cost per thousand impressions) bid.

CpmBidSource

CpmBidSource

Source of the CPM bid.

CpvBid

CpvBid

Cost per view 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 CPV bid applies to the row.

CpvBidSource

CpvBidSource

The source of the cost per view bid.

CreativeConversionRate

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

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

CreativeDestinationUrl

Destination URL of the ad.

CreativeFinalAppUrls

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

CreativeFinalMobileUrls

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

CreativeFinalUrls

CreativeFinalUrls

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

CreativeId

CreativeId

ID of the ad.

CreativeQualityScore

CreativeQualityScore

The quality score of the ad.

CreativeStatus

CreativeStatus

Status of the ad.

CreativeTrackingUrlTemplate

CreativeTrackingUrlTemplate

Tracking template of the ad.

CreativeUrlCustomParameters

CreativeUrlCustomParameters

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

Criteria

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

CriteriaDestinationUrl

The description for this field varies by report.

CriteriaId

CriteriaId

The Criterion ID.

CriteriaParameters

CriteriaParameters

The description for this field varies by report.

CriteriaStatus

CriteriaStatus

The status of the Criterion. Behaves as a segment in this report.

CriteriaType

CriteriaType

The type of the Criterion.

CriteriaTypeName

CriteriaTypeName

The descriptive name of the CriteriaType.

CriterionAttachmentLevel

CriterionAttachmentLevel

The level at which the criterion association is defined.

CriterionId

CriterionId

The Criterion ID.

CriterionType

CriterionType

The type of criterion.

CrossDeviceConversions

CrossDeviceConversions

Conversions from when a customer clicks on an AdWords 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

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.

CurrentModelAttributedConversions

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

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

CustomAttribute0

The ProductCustomAttribute level 0 value of the product.

CustomAttribute1

CustomAttribute1

The ProductCustomAttribute level 1 value of the product.

CustomAttribute2

CustomAttribute2

The ProductCustomAttribute level 2 value of the product.

CustomAttribute3

CustomAttribute3

The ProductCustomAttribute level 3 value of the product.

CustomAttribute4

CustomAttribute4

The ProductCustomAttribute level 4 value of the product.

CustomerDescriptiveName

CustomerDescriptiveName

The descriptive name of the Customer.

Date

Date

The date formatted as yyyy-MM-dd.

DayOfWeek

DayOfWeek

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

DeliveryMethod

DeliveryMethod

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

Description

Description

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

Description1

Description1

Line 1 description of the Ad.

Description2

Description2

Line 2 description of the Ad.

DestinationUrl

DestinationUrl

Destination URL for the impression.

Device

Device

Device type where the impression was shown.

DevicePreference

DevicePreference

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

DisapprovalShortNames

DisapprovalShortNames

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

DisplayName

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

DisplayUrl

Display URL of the Ad.

DistanceBucket

DistanceBucket

Grouping of user distance from location extensions.

Domain

Domain

The description for this field varies by report.

EffectiveDestinationUrl

EffectiveDestinationUrl

Effective destination URL of the impressions.

EffectiveFinalUrl

EffectiveFinalUrl

Effective final URL of the impressions.

EffectiveTargetRoas

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

EffectiveTargetRoasSource

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

EffectiveTrackingUrlTemplate

EffectiveTrackingUrlTemplate

Effective tracking URL of the impressions.

EndDate

EndDate

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

EndTime

EndTime

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

EngagementRate

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

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

EnhancedCpcEnabled

Indicates if enhanced CPC is enabled on the bidding strategy.

EnhancedCpvEnabled

EnhancedCpvEnabled

Indicates if enhanced CPV is enabled on the bidding strategy.

EnhancedDisplayCreativeLandscapeLogoImageMediaId

EnhancedDisplayCreativeLandscapeLogoImageMediaId

The ID of the landscape logo image.

EnhancedDisplayCreativeLogoImageMediaId

EnhancedDisplayCreativeLogoImageMediaId

The ID of the logo image used in the ResponsiveDisplayAd.

EnhancedDisplayCreativeMarketingImageMediaId

EnhancedDisplayCreativeMarketingImageMediaId

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

EnhancedDisplayCreativeMarketingImageSquareMediaId

EnhancedDisplayCreativeMarketingImageSquareMediaId

The ID of the square marketing image.

EstimatedAddClicksAtFirstPositionCpc

EstimatedAddClicksAtFirstPositionCpc

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

EstimatedAddCostAtFirstPositionCpc

EstimatedAddCostAtFirstPositionCpc

Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.

ExtensionPlaceholderCreativeId

ExtensionPlaceholderCreativeId

ID of the ad where the extension appeared.

ExtensionPlaceholderType

ExtensionPlaceholderType

Placeholder type indicating the type of extension.

ExternalConversionSource

ExternalConversionSource

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

ExternalCustomerId

ExternalCustomerId

The Customer ID.

FeedId

FeedId

The Feed ID.

FeedItemAttributes

FeedItemAttributes

List of attribute values for the FeedItem.

FeedItemEndTime

FeedItemEndTime

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

FeedItemId

FeedItemId

The FeedItem ID.

FeedItemStartTime

FeedItemStartTime

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

FeedItemStatus

FeedItemStatus

Status of the FeedItem.

FinalAppUrls

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

FinalMobileUrls

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

FinalUrl

FinalUrl

Final URL of the impressions.

FinalUrls

FinalUrls

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

FirstPageCpc

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

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

FormatSetting

The format setting of the responsive display ad.

GclId

GclId

The Google Click ID.

GeoTargetingCriterionId

GeoTargetingCriterionId

Location ID of the feed item's geoTargeting.

GeoTargetingRestriction

GeoTargetingRestriction

The type of location that can be used for targeting.

GmailForwards

GmailForwards

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

GmailSaves

GmailSaves

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

GmailSecondaryClicks

GmailSecondaryClicks

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

HasQualityScore

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.

Headline

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

HeadlinePart1

The first part of an expanded text ad headline.

HeadlinePart2

HeadlinePart2

The second part of an expanded text ad headline.

HistoricalCreativeQualityScore

HistoricalCreativeQualityScore

The quality of historical ad relevance.

HistoricalLandingPageQualityScore

HistoricalLandingPageQualityScore

The quality of historical landing page experience.

HistoricalQualityScore

HistoricalQualityScore

The historical quality score.

HistoricalSearchPredictedCtr

HistoricalSearchPredictedCtr

The historical expected clickthrough rate.

HourOfDay

HourOfDay

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

Id

Id

ID of the main object of this row.

ImageAdUrl

ImageAdUrl

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

ImageCreativeImageHeight

ImageCreativeImageHeight

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

ImageCreativeImageWidth

ImageCreativeImageWidth

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

ImageCreativeMimeType

ImageCreativeMimeType

Image mime type. Only populated for image ads.

ImageCreativeName

ImageCreativeName

Name for the image ad.

ImpressionAssistedConversions

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

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

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

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.

Impressions

Impressions

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

InteractionRate

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

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

InteractionTypes

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

InvalidClickRate

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

InvalidClicks

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

IsAutoOptimized

IsAutoOptimized

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

IsAutoTaggingEnabled

IsAutoTaggingEnabled

Indicates if auto tagging is enabled on the account.

IsBidOnPath

IsBidOnPath

Indicates if the placement was added as a criterion.

IsBudgetExplicitlyShared

IsBudgetExplicitlyShared

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

IsNegative

IsNegative

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

IsPathExcluded

IsPathExcluded

Indicates if the URL or placement is currently excluded.

IsRestrict

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

IsSelfAction

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

IsTargetingLocation

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

IsTestAccount

Indicates if the account is a test account.

KeywordId

KeywordId

The ID of the Keyword that triggered the ad.

KeywordMatchType

KeywordMatchType

The match type for the Keyword.

KeywordTargetingId

KeywordTargetingId

The ID of the feed item's keyword targeting.

KeywordTargetingMatchType

KeywordTargetingMatchType

Match type of the feed item's keywordTargeting.

KeywordTargetingText

KeywordTargetingText

Text of the feed item's keywordTargeting.

KeywordTextMatchingQuery

KeywordTextMatchingQuery

Keyword that matched the query and triggered the ad.

LabelId

LabelId

The ID of the Label.

LabelIds

LabelIds

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

LabelName

LabelName

The name of the Label.

Labels

Labels

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

LanguageCriteriaId

LanguageCriteriaId

Language of the product information.

Line1

Line1

The dynamically generated headline of the Dynamic Search Ad.

LocationType

LocationType

The type of location. AREA_OF_INTEREST indicates a location that was searched for, or a location derived from viewed content. LOCATION_OF_PRESENCE is the actual physical location of the user.

LongHeadline

LongHeadline

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

LopCityCriteriaId

LopCityCriteriaId

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

LopCountryCriteriaId

LopCountryCriteriaId

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

LopMetroCriteriaId

LopMetroCriteriaId

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

LopMostSpecificTargetId

LopMostSpecificTargetId

The most specific location target (Physical location).

LopRegionCriteriaId

LopRegionCriteriaId

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

MainColor

MainColor

The main color for the responsive display ad.

MemberCount

MemberCount

The number of entities in the shared set.

MerchantId

MerchantId

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

MetroCriteriaId

MetroCriteriaId

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

Month

Month

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

MonthOfYear

MonthOfYear

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

MostSpecificCriteriaId

MostSpecificCriteriaId

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

Name

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

NonRemovedAdGroupCount

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

NonRemovedAdGroupCriteriaCount

NonRemovedAdGroupCriteriaCount

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

NonRemovedCampaignCount

NonRemovedCampaignCount

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

NumOfflineImpressions

NumOfflineImpressions

Number of offline phone impressions.

NumOfflineInteractions

NumOfflineInteractions

Number of offline phone calls.

OfferId

OfferId

Offer/item ID of the product.

OfflineInteractionRate

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

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

OrganicClicks

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

OrganicClicksPerQuery

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

OrganicImpressions

Number of organic search listing impressions.

OrganicImpressionsPerQuery

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

OrganicQueries

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

Page

Page

Page number in search results where the ad was shown.

PageOnePromotedBidCeiling

PageOnePromotedBidCeiling

Maximum bid limit for the PageOnePromotedBiddingScheme.

PageOnePromotedBidChangesForRaisesOnly

PageOnePromotedBidChangesForRaisesOnly

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

PageOnePromotedBidModifier

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

PageOnePromotedRaiseBidWhenBudgetConstrained

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

PageOnePromotedRaiseBidWhenLowQualityScore

PageOnePromotedRaiseBidWhenLowQualityScore

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

PageOnePromotedStrategyGoal

PageOnePromotedStrategyGoal

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

Parameter

Parameter

The WebpageParameter criterion.

ParentCriterionId

ParentCriterionId

Criterion ID of the product partition's parent.

PartitionType

PartitionType

The partition type of the ProductPartition criterion.

Path1

Path1

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

Path2

Path2

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

PercentNewVisitors

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

Period over which to spend the budget.

PlaceholderType

PlaceholderType

Placeholder type indicating the type of extension.

PolicySummary

PolicySummary

Policy information for an ad.

PostClickQualityScore

PostClickQualityScore

The quality score of the landing page.

PricePrefix

PricePrefix

The prefix shown before prices.

ProductCondition

ProductCondition

The ProductCanonicalCondition of the product.

ProductGroup

ProductGroup

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

ProductTitle

ProductTitle

The title of the product.

ProductTypeL1

ProductTypeL1

The ProductType level 1 value of the product.

ProductTypeL2

ProductTypeL2

The ProductType level 2 value of the product.

ProductTypeL3

ProductTypeL3

The ProductType level 3 value of the product.

ProductTypeL4

ProductTypeL4

The ProductType level 4 value of the product.

ProductTypeL5

ProductTypeL5

The ProductType level 5 value of the product.

PromoText

PromoText

The promotion text for the responsive display ad.

QualityScore

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

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

Query

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

QueryMatchType

QueryMatchType

Match type of the keyword that triggered the ad.

QueryMatchTypeWithVariant

QueryMatchTypeWithVariant

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

QueryTargetingStatus

QueryTargetingStatus

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

ReferenceCount

ReferenceCount

The number of campaigns that actively use the shared set.

RegionCriteriaId

RegionCriteriaId

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

RelativeCtr

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.

Scheduling

Scheduling

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

SearchBudgetLostImpressionShare

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.

SearchClickShare

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

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

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

SearchPredictedCtr

Clickthrough rate compared to that of other advertisers.

SearchQuery

SearchQuery

Query that led to the impression.

SearchRankLostImpressionShare

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.

SerpType

SerpType

The type of search result.

ServingStatus

ServingStatus

Indicates if the Campaign is serving ads.

SharedSetId

SharedSetId

The ID of the SharedSet.

SharedSetName

SharedSetName

The name of the SharedSet.

SharedSetType

SharedSetType

The type of the SharedSet.

ShortHeadline

ShortHeadline

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

Slot

Slot

The position of the Ad.

StartDate

StartDate

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

StartTime

StartTime

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

Status

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

StoreId

Store ID of the product.

SystemServingStatus

SystemServingStatus

Serving status of the criterion.

TargetCpa

TargetCpa

The average CPA target set on the Target CPA bidding strategy.

TargetCpaBidSource

TargetCpaBidSource

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

TargetCpaMaxCpcBidCeiling

TargetCpaMaxCpcBidCeiling

The maximum CPC bid limit for the Target CPA bidding strategy.

TargetCpaMaxCpcBidFloor

TargetCpaMaxCpcBidFloor

The minimum CPC bid limit for the Target CPA bidding strategy.

TargetingAdGroupId

TargetingAdGroupId

Ad group ID of the feed item's adGroupTargeting.

TargetingCampaignId

TargetingCampaignId

Campaign ID of the feed item's campaignTargeting.

TargetOutrankShare

TargetOutrankShare

Target fraction (in micros) of auctions where the advertiser should outrank the competitor.

TargetOutrankShareBidChangesForRaisesOnly

TargetOutrankShareBidChangesForRaisesOnly

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

TargetOutrankShareCompetitorDomain

TargetOutrankShareCompetitorDomain

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

TargetOutrankShareMaxCpcBidCeiling

TargetOutrankShareMaxCpcBidCeiling

The TargetRoas strategy's ceiling on max CPC bids.

TargetOutrankShareRaiseBidWhenLowQualityScore

TargetOutrankShareRaiseBidWhenLowQualityScore

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

TargetRoas

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

TargetRoasBidCeiling

Maximum bid limit that applies to all keywords managed by the TargetRoas BiddingStrategyConfiguration.

TargetRoasBidFloor

TargetRoasBidFloor

Minimum bid limit that applies to all keywords managed by the TargetRoas BiddingStrategyConfiguration.

TargetSpendBidCeiling

TargetSpendBidCeiling

The largest max CPC bid that can be set by the TargetSpend BiddingStrategyConfiguration.

TargetSpendSpendTarget

TargetSpendSpendTarget

The spend target under which to maximize clicks. Specified by the TargetSpend BiddingStrategyConfiguration.

Title

Title

Title of the landing page.

TopOfPageCpc

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.

TrackingUrlTemplate

TrackingUrlTemplate

Tracking template of the main object of this row.

Type

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.

Url

Url

The description for this field varies by report.

UrlCustomParameters

UrlCustomParameters

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

UserListId

UserListId

The ID of the UserList (audience).

UserListName

UserListName

The name of the AdwordsUserList.

UserListsCount

UserListsCount

The count of UserList objects using the label.

ValidationDetails

ValidationDetails

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

ValuePerAllConversion

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

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

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

VerticalId

The ID of vertical.

VideoChannelId

VideoChannelId

The video channel ID.

VideoDuration

VideoDuration

The duration of the video in milliseconds.

VideoId

VideoId

The video ID.

VideoQuartile100Rate

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

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

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

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

VideoTitle

The video title.

VideoViewRate

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

VideoViews

The number of times your video ads were viewed.

ViewThroughConversions

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

Week

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

Year

Year

The year, formatted as yyyy.

Send feedback about...

AdWords API
AdWords API
Need help? Visit our support page.