Google Search Ads

Google Search Ads

GroupFieldID Has Conversion Is FormulaTypeDescription
Dataslayer DimensionsHub Accounthub_account Dimension
Dataslayer DimensionsConnector nameconnector_name Dimension
TimeDateDate DimensionDate to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
TimeDay of weekDayOfWeek DimensionDay of the week, for example, MONDAY.
TimeWeek (starting on Monday)Week DimensionWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
TimeYear-Week (starting on Monday)YearWeek DimensionWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
TimeMonthMonth DimensionMonth as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
TimeYear-MonthYearMonth DimensionMonth as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
TimeQuarterQuarter DimensionQuarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
TimeYearYear DimensionYear, formatted as yyyy.
TimeHourHour DimensionDate to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
CustomerCustomer IDCustomerId DimensionThe ID of the customer.
CustomerCustomer nameCustomerDescriptiveName DimensionOptional, non-unique descriptive name of the customer.
CustomerCustomer StatusCustomerStatus DimensionThe status of the customer.
CustomerCustomer Creation timeCustomerCreationTime DimensionThe timestamp when this customer was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
CustomerCustomer Last modified timeCustomerLastModifiedTime DimensionThe datetime when this customer was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
CustomerCustomer Currency codeCustomerCurrencyCode DimensionThe currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
CustomerAccount statusAccountStatus DimensionAccount status, for example, Enabled, Paused, Removed, etc.
CustomerAccount typeAccountType DimensionEngine account type, for example, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track, etc.
CustomerCustomer Engine idCustomerEngineId DimensionID of the account in the external engine account.
CustomerCustomer Final url suffixCustomerFinalUrlSuffix DimensionThe URL template for appending params to the final URL.
CustomerIs Customer ManagerCustomerManager DimensionWhether the customer is a manager.
CustomerCustomer Time zoneCustomerTimeZone DimensionThe local timezone ID of the customer.
CustomerCustomer Tracking url templateCustomerTrackingUrlTemplate DimensionThe URL template for constructing a tracking URL out of parameters.
CustomerAuto tagging enabledAutoTaggingEnabled DimensionWhether auto-tagging is enabled for the customer.
CustomerAccepted customer data termsConversionTrackingSettingAcceptedCustomerDataTerms DimensionWhether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709.
CustomerConversion Tracking IDConversionTrackingSettingConversionTrackingId DimensionThe conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversion_tracking_status does). This field is read-only.
CustomerConversion tracking statusConversionTrackingSettingConversionTrackingStatus DimensionConversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the login-customer-id of the request.
CustomerCross account conversion Tracking IDConversionTrackingSettingCrossAccountConversionTrackingId DimensionThe conversion tracking id of the customer's manager. This is set when the customer is opted into cross-account conversion tracking, and it overrides conversion_tracking_id.
CustomerEnhanced conversions for leads enabledConversionTrackingSettingEnhancedConversionsForLeadsEnabled DimensionWhether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only.
CustomerGoogle ads conversion customerConversionTrackingSettingGoogleAdsConversionCustomer DimensionThe resource name of the customer where conversions are created and managed. This field is read-only.
CustomerGoogle ads cross account conversion tracking idConversionTrackingSettingGoogleAdsCrossAccountConversionTrackingId DimensionThe conversion tracking id of the customer's manager. This is set when the customer is opted into conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only.
CustomerAdvertiser IDDoubleClickCampaignManagerSettingAdvertiserId DimensionID of the Campaign Manager advertiser associated with this customer.
CustomerNetwork IDDoubleClickCampaignManagerSettingNetworkId DimensionID of the Campaign Manager network associated with this customer.
CustomerCampaign Manager network Time zoneDoubleClickCampaignManagerSettingTimeZone DimensionTime zone of the Campaign Manager network associated with this customer in IANA Time Zone Database format, such as America/New_York.
CampaignCampaign IdCampaignId DimensionThe ID of the campaign.
CampaignCampaign NameCampaignName DimensionThe name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
CampaignAdvertising channel typeAdvertisingChannelType DimensionThe primary serving target for ads within the campaign. The targeting options can be refined in network_settings. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed.
CampaignAdvertising channel sub typeAdvertisingChannelSubType DimensionOptional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed.
CampaignCampaign Engine idCampaignEngineId DimensionID of the campaign in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "campaign.id" instead.
CampaignCampaign budgetCampaignBudget DimensionThe budget of the campaign.
CampaignCampaign StatusCampaignStatus DimensionThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
CampaignCampaign Serving statusCampaignServingStatus DimensionThe ad serving status of the campaign.
CampaignCampaign Creation timeCampaignCreationTime DimensionThe timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
CampaignCampaign Last modified timeCampaignLastModifiedTime DimensionThe datetime when this campaign was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
CampaignCampaign Start dateCampaignStartDate DimensionThe date when campaign started in serving customer's timezone in YYYY-MM-DD format.
CampaignCampaign End dateCampaignEndDate DimensionThe last day of the campaign in serving customer's timezone in YYYY-MM-DD format. On create, defaults to 2037-12-30, which means the campaign will run indefinitely. To set an existing campaign to run indefinitely, set this field to 2037-12-30.
CampaignCampaign Bid strategyCampaignBiddingStrategy DimensionPortfolio bidding strategy used by campaign.
CampaignCampaign Bid strategy system statusCampaignBiddingStrategySystemStatus DimensionThe system status of the campaign's bidding strategy.
CampaignCampaign Bid strategy typeCampaignBiddingStrategyType DimensionThe type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only.
CampaignAd serving optimization statusAdServingOptimizationStatus DimensionThe ad serving optimization status of the campaign.
CampaignDynamic search ads Domain nameDynamicSearchAdsSettingDomainName DimensionRequired. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".
CampaignDynamic search ads Language codeDynamicSearchAdsSettingLanguageCode DimensionRequired. The language code specifying the language of the domain, for example, "en".
CampaignDynamic search ads Use supplied urls onlyDynamicSearchAdsSettingUseSuppliedUrlsOnly DimensionWhether the campaign uses advertiser supplied URLs exclusively.
CampaignExcluded parent asset field typesExcludedParentAssetFieldTypes DimensionThe asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level.
CampaignFrequency capsFrequencyCaps DimensionA list that limits how often each user will see this campaign's ads.
CampaignGeo target type negative geo target typeGeoTargetTypeSettingNegativeGeoTargetType DimensionThe setting used for negative geotargeting in this particular campaign.
CampaignGeo target type positive geo target typeGeoTargetTypeSetting.PositiveGeoTargetType DimensionThe setting used for positive geotargeting in this particular campaign.
CampaignCampaign LabelsCampaignLabels DimensionThe resource names of labels attached to this campaign.
CampaignManual CPAManualCpa DimensionStandard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns.
CampaignManual CPC enhanced cpc enabledManualCpcEnhancedCpcEnabled DimensionWhether bids are to be enhanced based on conversion optimizer data.
CampaignManual CPMManualCpm DimensionStandard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
CampaignCampaign Max conv. value target roasCampaignMaximizeConversionValueTargetRoas DimensionThe target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget.
CampaignCampaign Max conv.target CPA microsCampaignMaximizeConversionsTargetCpaMicros DimensionThe target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget.
CampaignTarget content networkTargetContentNetwork DimensionWhether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
CampaignTarget google searchTargetGoogleSearch DimensionWhether ads will be served with google.com search results.
CampaignTarget partner search networkTargetPartnerSearchNetwork DimensionWhether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
CampaignTarget search networkTargetSearchNetwork DimensionWhether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
CampaignOptimization goal typesOptimizationGoalTypes DimensionThe list of optimization goal types.
CampaignPercent CPC bid ceiling microsCpcBidCeilingMicros DimensionMaximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined.
CampaignPercent enhanced CPC enabledPercentCpcEnhancedCpcEnabled DimensionAdjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not.
CampaignOPT inRealTimeBiddingSettingOptIn DimensionWhether the campaign is opted in to real-time bidding.
CampaignConversion actionsSelectiveOptimizationConversionActions DimensionThe selected set of conversion actions for optimizing this campaign.
CampaignShopping Campaign priorityCampaignPriority DimensionPriority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set.
CampaignShopping Enable localEnableLocal DimensionWhether to include local products.
CampaignShopping feed labelShoppingSettingFeedLabel DimensionFeed label of products to include in the campaign. Only one of feed_label or sales_country can be set. If used instead of sales_country, the feed_label field accepts country codes in the same format for example: 'XX'. Otherwise can be any string used for feed label in Google Merchant Center.
CampaignShopping merchant IDShoppingSettingMerchantId DimensionID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
CampaignShopping sales countryShoppingSettingSalesCountry DimensionSales country of products to include in the campaign.
CampaignShopping use vehicle inventoryShoppingSettingUseVehicleInventory DimensionWhether to target Vehicle Listing inventory.
CampaignCampaign Target cpa CPC bid ceiling microsCampaignTargetCpaCpcBidCeilingMicros DimensionMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
CampaignCampaign Target cpa CPC bid floor microsCampaignTargetCpaCpcBidFloorMicros DimensionMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
CampaignCampaign Trget cpa microsCampaignTargetCpaTargetCpaMicros DimensionAverage CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
CampaignCamapign Target CPMCamapignTargetCpm DimensionA bidding strategy that automatically optimizes cost per thousand impressions.
CampaignCampaign Target impression share CPC bid ceiling microsCampaignTargetImpressionShareCpcBidCeilingMicros DimensionThe highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros.
CampaignCampaign Target impression share locationCampaignTargetImpressionShareLocation DimensionThe targeted location on the search results page.
CampaignCampaign Target impression share location fraction microsCampaignTargetImpressionShareLocationFractionMicros DimensionThe chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
CampaignCampaign Target roas CPC bid ceiling microsCampaignTargetRoasCpcBidCeilingMicros DimensionMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
CampaignCampaign Target roas CPC bid floor microsCampaignTargetRoasCpcBidFloorMicros DimensionMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
CampaignCampaign Target roasCampaignTargetRoasTargetRoas DimensionRequired. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
CampaignCampaign Target spend CPC bid ceiling microsCampaignTargetSpendCpcBidCeilingMicros DimensionMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
CampaignCampaign Target spend microsCampaignTargetSpendTargetSpendMicros DimensionThe spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details.
CampaignTracking URLTrackingSettingTrackingUrl DimensionThe url used for dynamic tracking.
CampaignUrl custom parametersUrlCustomParameters DimensionThe list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
CampaignUrl expansion opt outUrlExpansionOptOut DimensionRepresents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.
CampaignCampaign Final url suffixCampaignFinalUrlSuffix DimensionSuffix used to append query parameters to landing pages that are served with parallel tracking.
CampaignCampaign Tracking url templateCampaignTrackingUrlTemplate DimensionThe URL template for constructing a tracking URL.
Ad GroupAd Group IdAdGroupId DimensionThe ID of the ad group.
Ad GroupAd Group NameAdGroupName DimensionThe name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
Ad GroupAd Group StatusAdGroupStatus DimensionThe status of the ad group.
Ad GroupAd Group TypeAdGroupType DimensionThe type of the ad group.
Ad GroupAd network typeAdNetworkType DimensionAd network type.
Ad GroupAd Group Language codeAdGroupLanguageCode DimensionThe language of the ads and keywords in an ad group. This field is only available for Microsoft Advertising accounts. More details: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
Ad GroupAd Group Engine idAdGroupEngineId DimensionID of the ad group in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "ad_group.id" instead.
Ad GroupAd Group Engine statusAdGroupEngineStatus DimensionThe Engine Status for ad group.
Ad GroupAd Group LabelsAdGroupLabels DimensionThe resource names of labels attached to this ad group.
Ad GroupAd Group Creation timeAdGroupCreationTime DimensionThe timestamp when this ad_group was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
Ad GroupAd Group Last modified timeAdGroupLastModifiedTime DimensionThe datetime when this ad group was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
Ad GroupAd Group Start dateAdGroupStartDate DimensionDate when this ad group starts serving ads. By default, the ad group starts now or the ad group's start date, whichever is later. If this field is set, then the ad group starts at the beginning of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14
Ad GroupAd Group End dateAdGroupEndDate DimensionDate when the ad group ends serving ads. By default, the ad group ends on the ad group's end date. If this field is set, then the ad group ends at the end of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14
Ad GroupAd rotation modeAdGroupAdRotationMode DimensionThe ad rotation mode of the ad group.
Ad GroupAd Group Cpc bid microsAdGroupCpcBidMicros DimensionThe maximum CPC (cost-per-click) bid.
Ad GroupAd Group Target restrictionsAdGroupTargetingSettingTargetRestrictions DimensionThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
Ad Group AdAd Display urlAdDisplayUrl DimensionThe URL that appears in the ad description for some ad formats.
Ad Group AdAd IDAdId DimensionThe ID of the ad.
Ad Group AdAd NameAdName DimensionThe name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.
Ad Group AdAd StatusAdGroupAdStatus DimensionThe status of the ad.
Ad Group AdAd typeAdType DimensionThe type of ad.
Ad Group AdAd Engine idAdGroupAdEngineId DimensionID of the ad in the external engine account. This field is for SearchAds 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-SearchAds 360 entity, use "ad_group_ad.ad.id" instead.
Ad Group AdAd Engine statusAdEngineStatus DimensionAdditional status of the ad in the external engine account. Possible statuses (depending on the type of external account) include active, eligible, pending review, etc.
Ad Group AdAD Creation timeAdGroupAdCreationTime DimensionThe timestamp when this ad_group_ad was created. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
Ad Group AdAd Last modified timeAdGroupAdLastModifiedTime DimensionThe datetime when this ad group ad was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
Ad Group AdAd LabelsAdGroupAdLabels DimensionThe resource names of labels attached to this ad group ad.
Ad Group AdText Ad HeadlineAdTextAdHeadline DimensionThe headline of the ad.
Ad Group AdText Ad Display URLAdTextAdDisplayUrl DimensionThe displayed URL of the ad.
Ad Group AdAd Final URLsAdFinalUrls DimensionThe list of possible final URLs after all cross-domain redirects for the ad.
Ad Group AdText Ad Tracking IDAdTextAdAdTrackingId DimensionThe tracking id of the ad.
Ad Group AdText Ad Description 1AdTextAdDescription1 DimensionThe first line of the ad's description.
Ad Group AdText Ad Description 2AdTextAdDescription2 DimensionThe second line of the ad's description.
Ad Group AdText Ad Display mobile URLAdTextAdDisplayMobileUrl DimensionThe displayed mobile URL of the ad.
Ad Group AdDynamic search ad Tracking IDAdExpandedDynamicSearchAdAdTrackingId DimensionThe tracking id of the ad.
Ad Group AdDynamic search Ad Description 1AdExpandedDynamicSearchAdDescription1 DimensionThe first line of the ad's description.
Ad Group AdDynamic search Ad Description 2AdExpandedDynamicSearchAdDescription2 DimensionThe second line of the ad's description.
Ad Group AdExpanded text Ad Tracking IDAdExpandedTextAdAdTrackingId DimensionThe tracking id of the ad.
Ad Group AdExpanded text Ad Description 1AdExpandedTextAdDescription1 DimensionThe first line of the ad's description.
Ad Group AdExpanded text Ad Description 2AdExpandedTextAdDescription2 DimensionThe second line of the ad's description.
Ad Group AdExpanded text Ad HeadlineAdExpandedTextAdHeadline DimensionThe headline of the ad.
Ad Group AdExpanded text Ad Headline 2AdExpandedTextAdHeadline2 DimensionThe second headline of the ad.
Ad Group AdExpanded text Ad Headline 3AdExpandedTextAdHeadline3 DimensionThe third headline of the ad.
Ad Group AdExpanded text Ad Path 1AdExpandedTextAdPath1 DimensionText appended to the auto-generated visible URL with a delimiter.
Ad Group AdExpanded text Ad Path 2AdExpandedTextAdPath2 DimensionText appended to path1 with a delimiter.
Ad Group AdResponsive search Ad Tracking IDAdResponsiveSearchAdAdTrackingId DimensionThe tracking id of the ad.
Ad Group AdResponsive search Ad Path 1AdResponsiveSearchAdPath1 DimensionText appended to the auto-generated visible URL with a delimiter.
Ad Group AdResponsive search Ad Path 2AdResponsiveSearchAdPath2 DimensionText appended to path1 with a delimiter.
Bidding StrategyBidding Strategy IdBiddingStrategyId DimensionThe ID of the bidding strategy.
Bidding StrategyBidding Strategy NameBiddingStrategyName DimensionThe name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
Bidding StrategyBidding Strategy StatusBiddingStrategyStatus DimensionThe status of the bidding strategy. This field is read-only.
Bidding StrategyBidding Strategy TypeBiddingStrategyType DimensionThe type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only.
Bidding StrategyBidding Strategy Currency codeBiddingStrategyCurrencyCode DimensionThe currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this currency can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effective_currency_code field returns the currency used by the strategy.
Bidding StrategyCampaign countCampaignCount DimensionThe number of campaigns attached to this bidding strategy. This field is read-only.
Bidding StrategyEffective currency codeEffectiveCurrencyCode DimensionThe currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currency_code. Bidding strategy metrics are reported in this currency. This field is read-only.
Bidding StrategyEnhanced cpcEnhancedCpc DimensionA bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
Bidding StrategyMax conv. value CPC Bid ceiling microsMaximizeConversionValueCpcBidCeilingMicros DimensionMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
Bidding StrategyMax conv. value CPC Bid floor microsMaximizeConversionValueCpcBidFloorMicros DimensionMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
Bidding StrategyMax conv. CPC Bid ceiling microsMaximizeConversionsCpcBidCeilingMicros DimensionMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
Bidding StrategyMax conv. CPC Bid floor microsMaximizeConversionsCpcBidFloorMicros DimensionMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
Bidding StrategyNon removed campaign countNonRemovedCampaignCount DimensionThe number of non-removed campaigns attached to this bidding strategy. This field is read-only.
Bidding StrategyTarget outrank share CPC Bid ceiling microsTargetOutrankShareCpcBidCeilingMicros DimensionMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Bidding StrategyBidding Strategy Max conv. value target roasBiddingStrategyMaximizeConversionValueTargetRoas DimensionThe target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget.
Bidding StrategyBidding Strategy Max conv.target CPA microsBiddingStrategyMaximizeConversionsTargetCpaMicros DimensionThe target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget.
Bidding StrategyBidding Strategy Target cpa CPC bid ceiling microsBiddingStrategyTargetCpaCpcBidCeilingMicros DimensionMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
Bidding StrategyBidding StrategyTarget cpa CPC bid floor microsBiddingStrategyTargetCpaCpcBidFloorMicros DimensionMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
Bidding StrategyBidding Strategy Target cpa microsBiddingStrategyTargetCpa.TargetCpaMicros DimensionAverage CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Bidding StrategyBidding Strategy Target impression share CPC bid ceiling microsBiddingStrategyTargetImpressionShareCpcBidCeilingMicros DimensionThe highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros.
Bidding StrategyBidding Strategy Target impression share locationBiddingStrategyTargetImpressionShareLocation DimensionThe targeted location on the search results page.
Bidding StrategyBidding Strategy Target impression share location fraction microsBiddingStrategyTargetImpressionShareLocationFractionMicros DimensionThe chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
Bidding StrategyBidding Strategy Target roas CPC bid ceiling microsBiddingStrategyTargetRoasCpcBidCeilingMicros DimensionMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
Bidding StrategyBidding Strategy Target roas CPC bid floor microsBiddingStrategyTargetRoasCpcBidFloorMicros DimensionMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
Bidding StrategyBidding Strategy Target roasBiddingStrategyTargetRoasTargetRoas DimensionRequired. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
Bidding StrategyBidding Strategy Target spend CPC bid ceiling microsBiddingStrategyTargetSpendCpcBidCeilingMicros DimensionMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Bidding StrategyBidding Strategy Target spend microsBiddingStrategyTargetSpendTargetSpendMicros DimensionThe spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details.
Campaign BudgetCampaign Budget AmountCampaignBudgetAmount DimensionThe amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit. Monthly spend is capped at 30.4 times this amount.
Campaign BudgetCampaign Budget Delivery methodDeliveryMethod DimensionThe delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation.
Campaign BudgetCampaign Budget PeriodPeriod DimensionPeriod over which to spend the budget. Defaults to DAILY if not specified.
Dynamic Search Ad Search TermLanding pageLandingPage DimensionThe dynamically selected landing page URL of the impression. This field is read-only.
Customer AssetCustomer Asset StatusCustomerAssetStatus DimensionStatus of the customer asset.
Campaign AssetCampaign Asset StatusCampaignAssetStatus DimensionStatus of the campaign asset.
ProductsProduct bidding category level1ProductBiddingCategoryLevel1 DimensionBidding category (level 1) of the product.
ProductsProduct bidding category level2ProductBiddingCategoryLevel2 DimensionBidding category (level 2) of the product.
ProductsProduct bidding category level3ProductBiddingCategoryLevel3 DimensionBidding category (level 3) of the product.
ProductsProduct bidding category level4ProductBiddingCategoryLevel4 DimensionBidding category (level 4) of the product.
ProductsProduct bidding category level5ProductBiddingCategoryLevel5 DimensionBidding category (level 5) of the product.
ProductsProduct brandProductBrand DimensionBrand of the product.
ProductsProduct channelProductChannel DimensionChannel of the product.
ProductsProduct channel exclusivityProductChannelExclusivity DimensionChannel exclusivity of the product.
ProductsProduct conditionProductCondition DimensionCondition of the product.
ProductsProduct countryProductCountry DimensionResource name of the geo target constant for the country of sale of the product.
ProductsProduct custom attribute0ProductCustomAttribute0 DimensionCustom attribute 0 of the product.
ProductsProduct custom attribute1ProductCustomAttribute1 DimensionCustom attribute 1 of the product.
ProductsProduct custom attribute2ProductCustomAttribute2 DimensionCustom attribute 2 of the product.
ProductsProduct custom attribute3ProductCustomAttribute3 DimensionCustom attribute 3 of the product.
ProductsProduct custom attribute4ProductCustomAttribute4 DimensionCustom attribute 4 of the product.
ProductsProduct item idProductItemId DimensionItem ID of the product.
ProductsProduct languageProductLanguage DimensionResource name of the language constant for the language of the product.
ProductsProduct sold bidding category level1ProductSoldBiddingCategoryLevel1 DimensionBidding category (level 1) of the product sold.
ProductsProduct sold bidding category level2ProductSoldBiddingCategoryLevel2 DimensionBidding category (level 2) of the product sold.
ProductsProduct sold bidding category level3ProductSoldBiddingCategoryLevel3 DimensionBidding category (level 3) of the product sold.
ProductsProduct sold bidding category level4ProductSoldBiddingCategoryLevel4 DimensionBidding category (level 4) of the product sold.
ProductsProduct sold bidding category level5ProductSoldBiddingCategoryLevel5 DimensionBidding category (level 5) of the product sold.
ProductsProduct sold brandProductSoldBrand DimensionBrand of the product sold.
ProductsProduct sold conditionProductSoldCondition DimensionCondition of the product sold.
ProductsProduct sold custom attribute0ProductSoldCustomAttribute0 DimensionCustom attribute 0 of the product sold.
ProductsProduct sold custom attribute1ProductSoldCustomAttribute1 DimensionCustom attribute 1 of the product sold.
ProductsProduct sold custom attribute2ProductSoldCustomAttribute2 DimensionCustom attribute 2 of the product sold.
ProductsProduct sold custom attribute3ProductSoldCustomAttribute3 DimensionCustom attribute 3 of the product sold.
ProductsProduct sold custom attribute4ProductSoldCustomAttribute4 DimensionCustom attribute 4 of the product sold.
ProductsProduct sold item idProductSoldItemId DimensionItem ID of the product sold.
ProductsProduct sold titleProductSoldTitle DimensionTitle of the product sold.
ProductsProduct sold type l1ProductSoldTypeL1 DimensionType (level 1) of the product sold.
ProductsProduct sold type l2ProductSoldTypeL2 DimensionType (level 2) of the product sold.
ProductsProduct sold type l3ProductSoldTypeL3 DimensionType (level 3) of the product sold.
ProductsProduct sold type l4ProductSoldTypeL4 DimensionType (level 4) of the product sold.
ProductsProduct sold type l5ProductSoldTypeL5 DimensionType (level 5) of the product sold.
ProductsProduct store idProductStoreId DimensionStore ID of the product.
ProductsProduct titleProductTitle DimensionTitle of the product.
ProductsProduct type l1ProductTypeL1 DimensionType (level 1) of the product.
ProductsProduct type l2ProductTypeL2 DimensionType (level 2) of the product.
ProductsProduct type l3ProductTypeL3 DimensionType (level 3) of the product.
ProductsProduct type l4ProductTypeL4 DimensionType (level 4) of the product.
ProductsProduct type l5ProductTypeL5 DimensionType (level 5) of the product.
ConversionsConversion actionConversionAction DimensionResource name of the conversion action.
ConversionsConversion action categoryConversionActionCategory DimensionConversion action category.
ConversionsConversion action nameConversionActionName DimensionConversion action name.
KeywordsKeyword IDKeywordID DimensionThe ID of the criterion.
KeywordsKeyword TypeKeywordType DimensionThe type of the criterion.
KeywordsKeyword StatusKeywordStatus DimensionThe status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded.
KeywordsKeyword Engine IDKeywordEngineID DimensionID of the ad group criterion in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc.
KeywordsKeyword Engine StatusKeywordEngineStatus DimensionThe Engine Status for ad group criterion.
KeywordsKeyword TextKeywordText DimensionThe text of the keyword (at most 80 characters and 10 words).
KeywordsKeyword Match TypeKeywordMatchType DimensionThe match type of the keyword.
KeywordsKeyword GenderKeywordGenderType DimensionType of the gender.
KeywordsKeyword Final URLsKeywordFinalURLs DimensionThe list of possible final URLs after all cross-domain redirects for the ad.
BasicClicksClicks MetricThe number of clicks.
BasicImpressionsImpressions MetricCount of how often your ad has appeared on a search results page or website on the Google Network.
BasicCtrCtr MetricThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
BasicInteractionsInteractions MetricThe 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.
BasicInteraction event typesInteractionEventTypes MetricThe types of payable and free interactions.
BasicInteraction rateInteractionRate MetricHow 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.
BasicCostCost MetricThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
BasicAverage costAverageCost MetricThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
BasicAverage cpcAverageCpc MetricThe total cost of all clicks divided by the total number of clicks received. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
BasicAverage cpmAverageCpm MetricAverage cost-per-thousand impressions (CPM). This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
ConversionsConversionsConversions MetricThe number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsConversions valueConversionsValue MetricThe sum of conversion values for the conversions included in the "conversions" field. This metric is useful only if you entered a value for your conversion actions.
ConversionsAll conversionsAllConversions MetricThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
ConversionsAll conversions valueAllConversionsValue MetricThe value of all conversions.
ConversionsConversions by conversion dateConversionsByConversionDate MetricThe sum of conversions by conversion date for biddable conversion types. Can be fractional due to attribution modeling. When this column is selected with date, the values in date column means the conversion date.
ConversionsConversions from interactions rateConversionsFromInteractionsRate MetricAverage biddable conversions (from interaction) per conversion eligible interaction. Shows how often, on average, an ad interaction leads to a biddable conversion.
ConversionsConversions from interactions value per interactionConversionsFromInteractionsValuePerInteraction MetricThe value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsConversions value by conversion dateConversionsValueByConversionDate MetricThe sum of biddable conversions value by conversion date. When this column is selected with date, the values in date column means the conversion date.
ConversionsConversions value per costConversionsValuePerCost MetricThe value of biddable conversion divided by the total cost of conversion eligible interactions.
ConversionsAll conversions by conversion dateAllConversionsByConversionDate MetricThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.
ConversionsAll conversions from click to callAllConversionsFromClickToCall MetricThe number of times people clicked the "Call" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only.
ConversionsAll conversions from directionsAllConversionsFromDirections MetricThe number of times people clicked a "Get directions" button to navigate to a store after clicking an ad. This metric applies to feed items only.
ConversionsAll conversions from interactions rateAllConversionsFromInteractionsRate MetricAll conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
ConversionsAll conversions from interactions value per interactionAllConversionsFromInteractionsValuePerInteraction MetricThe value of all conversions from interactions divided by the total number of interactions.
ConversionsAll conversions from menuAllConversionsFromMenu MetricThe number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only.
ConversionsAll conversions from orderAllConversionsFromOrder MetricThe number of times people placed an order at a store after clicking an ad. This metric applies to feed items only.
ConversionsAll conversions from other engagementAllConversionsFromOtherEngagement MetricThe number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only.
ConversionsAll conversions from store visitAllConversionsFromStoreVisit MetricEstimated number of times people visited a store after clicking an ad. This metric applies to feed items only.
ConversionsAll conversions from store websiteAllConversionsFromStoreWebsite MetricThe number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only.
ConversionsAll conversions value by conversion dateAllConversionsValueByConversionDate MetricThe value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.
ConversionsAll conversions value per costAllConversionsValuePerCost MetricThe value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads).
ConversionsCost per all conversionsCostPerAllConversions MetricThe cost of ad interactions divided by all conversions.
ConversionsCost per conversionCostPerConversion MetricAverage conversion eligible cost per biddable conversion.
ConversionsValue per all conversionsValuePerAllConversions MetricThe value of all conversions divided by the number of all conversions.
ConversionsValue per all conversions by conversion dateValuePerAllConversionsByConversionDate MetricThe value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.
ConversionsValue per conversionValuePerConversion MetricThe value of biddable conversion divided by the number of biddable conversions. Shows how much, on average, each of the biddable conversions is worth.
ConversionsValue per conversions by conversion dateValuePerConversionsByConversionDate MetricBiddable conversions value by conversion date divided by biddable conversions by conversion date. Shows how much, on average, each of the biddable conversions is worth (by conversion date). When this column is selected with date, the values in date column means the conversion date.
Search Impression ShareAvailable impressionAvailableImpression Metric
Search Impression ShareSearch impression shareSearchImpressionShare MetricThe impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Search Impression ShareLost impressions due to budgetLostImpressionsDueToBudget Metric
Search Impression ShareLost impressions due to rankLostImpressionsDueToRank Metric
Search Impression ShareLost impressionsLostImpressions Metric
Search Impression ShareSearch budget lost impression shareSearchBudgetLostImpressionShare MetricThe estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search Impression ShareSearch rank lost impression shareSearchRankLostImpressionShare MetricThe estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search Top Impression ShareImpressions On TopImpressionsOnTop Metric
Search Top Impression ShareTop impression percentageTopImpressionPercentage MetricThe percent of your ad impressions that are shown anywhere above the organic search results.
Search Top Impression ShareAvailale Impressions On TopAvailableImpressionsOnTop Metric
Search Top Impression ShareSearch top impression shareSearchTopImpressionShare MetricThe 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. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Search Top Impression ShareLost Top impressions due to budgetLostTopImpressionsDueToBudget Metric
Search Top Impression ShareLost Top impressions due to RankLostTopImpressionsDueToRank Metric
Search Top Impression ShareSearch budget lost top impression shareSearchBudgetLostTopImpressionShare MetricThe number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search Top Impression ShareSearch rank lost top impression shareSearchRankLostTopImpressionShare MetricThe number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search Absolute Top Impression ShareImpressions On Absolut TopImpressionsOnAbsoluteTop Metric
Search Absolute Top Impression ShareAvailale Impressions On Absolut TopAvailableImpressionsOnAbsoluteTop Metric
Search Absolute Top Impression ShareAbsolute top impression percentageAbsoluteTopImpressionPercentage MetricThe percent of your ad impressions that are shown as the very first ad above the organic search results.
Search Absolute Top Impression ShareSearch absolute top impression shareSearchAbsoluteTopImpressionShare MetricThe percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/sa360/answer/9566729 for details. Any value below 0.1 is reported as 0.0999.
Search Absolute Top Impression ShareLost Absolute Top impressions due to budgetLostAbsoluteTopImpressionsDueToBudget Metric
Search Absolute Top Impression ShareLost Absolute Top impressions due to RankLostAbsoluteTopImpressionsDueToRank Metric
Search Absolute Top Impression ShareSearch budget lost absolute top impression shareSearchBudgetLostAbsoluteTopImpressionShare MetricThe number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search Absolute Top Impression ShareSearch rank lost absolute top impression shareSearchRankLostAbsoluteTopImpressionShare MetricThe number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.