A campaign.
| Attributed resources |
|---|
| accessible_bidding_strategy |
| bidding_strategy |
| campaign_budget |
| customer |
Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fields will not segment
metrics in your SELECT
clause.
Fields/Segments/Metrics
This page shows all metrics and segments that can be put in the same SELECT clause as the fields of campaign
.
However, when you specify campaign
in the FROM clause, some metrics and segments
cannot be used.
Use the following filter to show only the fields that can be used when campaign
is specified in the FROM clause.
Is campaign
specified in the FROM clause of your query?
campaign.accessible_bidding_strategy
Field description
Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
campaign.ad_serving_optimization_status
Field description
The ad serving optimization status of the campaign.
Category
ATTRIBUTE
Data Type
Type URL
google.ads.searchads360.v0.enums.AdServingOptimizationStatusEnum.AdServingOptimizationStatus
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.advertising_channel_sub_type
Field description
Optional 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.Category
ATTRIBUTE
Data Type
Type URL
google.ads.searchads360.v0.enums.AdvertisingChannelSubTypeEnum.AdvertisingChannelSubType
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.advertising_channel_type
Field description
The 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.Category
ATTRIBUTE
Data Type
Type URL
google.ads.searchads360.v0.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.bidding_strategy
Field description
The resource name of the portfolio bidding strategy used by the campaign.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
campaign.bidding_strategy_system_status
Field description
The system status of the campaign's bidding strategy.
Category
ATTRIBUTE
Data Type
Type URL
google.ads.searchads360.v0.enums.BiddingStrategySystemStatusEnum.BiddingStrategySystemStatus
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.bidding_strategy_type
Field description
The 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.Category
ATTRIBUTE
Data Type
Type URL
google.ads.searchads360.v0.enums.BiddingStrategyTypeEnum.BiddingStrategyType
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.campaign_budget
Field description
The resource name of the campaign budget of the campaign.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
campaign.create_time
Field description
The timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. create_time will be deprecated in v1. Use creation_time instead.
Category
ATTRIBUTE
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.creation_time
Field description
The timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
Category
ATTRIBUTE
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.dynamic_search_ads_setting.domain_name
Field description
Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.dynamic_search_ads_setting.language_code
Field description
Required. The language code specifying the language of the domain, for example, "en".
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.dynamic_search_ads_setting.use_supplied_urls_only
Field description
Whether the campaign uses advertiser supplied URLs exclusively.
Category
ATTRIBUTE
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.effective_labels
Field description
The resource names of effective labels attached to this campaign. An effective label is a label inherited or directly assigned to this campaign.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
True
campaign.end_date
Field description
The 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.
Category
ATTRIBUTE
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.engine_id
Field description
ID 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.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.excluded_parent_asset_field_types
Field description
The 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.
Category
ATTRIBUTE
Data Type
Type URL
google.ads.searchads360.v0.enums.AssetFieldTypeEnum.AssetFieldType
Filterable
True
Selectable
True
Sortable
False
Repeated
True
campaign.final_url_suffix
Field description
Suffix used to append query parameters to landing pages that are served with parallel tracking.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.frequency_caps
Field description
A list that limits how often each user will see this campaign's ads.
Category
ATTRIBUTE
Data Type
MESSAGE
Type URL
google.ads.searchads360.v0.common.FrequencyCapEntry
Filterable
False
Selectable
True
Sortable
False
Repeated
True
campaign.geo_target_type_setting.negative_geo_target_type
Field description
The setting used for negative geotargeting in this particular campaign.
Category
ATTRIBUTE
Data Type
Type URL
google.ads.searchads360.v0.enums.NegativeGeoTargetTypeEnum.NegativeGeoTargetType
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.geo_target_type_setting.positive_geo_target_type
Field description
The setting used for positive geotargeting in this particular campaign.
Category
ATTRIBUTE
Data Type
Type URL
google.ads.searchads360.v0.enums.PositiveGeoTargetTypeEnum.PositiveGeoTargetType
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.id
Field description
The ID of the campaign.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.labels
Field description
The resource names of labels attached to this campaign.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
True
campaign.last_modified_time
Field description
The 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.
Category
ATTRIBUTE
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.manual_cpa
Field description
Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns.
Category
ATTRIBUTE
Data Type
MESSAGE
Type URL
google.ads.searchads360.v0.common.ManualCpa
Filterable
False
Selectable
True
Sortable
False
Repeated
False
campaign.manual_cpc.enhanced_cpc_enabled
Field description
Whether bids are to be enhanced based on conversion optimizer data.
Category
ATTRIBUTE
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.manual_cpm
Field description
Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
Category
ATTRIBUTE
Data Type
MESSAGE
Type URL
google.ads.searchads360.v0.common.ManualCpm
Filterable
False
Selectable
True
Sortable
False
Repeated
False
campaign.maximize_conversion_value.target_roas
Field description
The 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.
Category
ATTRIBUTE
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.maximize_conversions.target_cpa_micros
Field description
The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.name
Field description
The 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.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.network_settings.target_content_network
Field description
Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
Category
ATTRIBUTE
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.network_settings.target_google_search
Field description
Whether ads will be served with google.com search results.
Category
ATTRIBUTE
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.network_settings.target_partner_search_network
Field description
Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
Category
ATTRIBUTE
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.network_settings.target_search_network
Field description
Whether ads will be served on partner sites in the Google Search Network (requires
target_google_search
to also be true
).Category
ATTRIBUTE
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.optimization_goal_setting.optimization_goal_types
Field description
The list of optimization goal types.
Category
ATTRIBUTE
Data Type
Type URL
google.ads.searchads360.v0.enums.OptimizationGoalTypeEnum.OptimizationGoalType
Filterable
True
Selectable
True
Sortable
False
Repeated
True
campaign.percent_cpc.cpc_bid_ceiling_micros
Field description
Maximum 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.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.percent_cpc.enhanced_cpc_enabled
Field description
Adjusts 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.
Category
ATTRIBUTE
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.real_time_bidding_setting.opt_in
Field description
Whether the campaign is opted in to real-time bidding.
Category
ATTRIBUTE
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.resource_name
Field description
The resource name of the campaign. Campaign resource names have the form:
customers/{customer_id}/campaigns/{campaign_id}
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
campaign.selective_optimization.conversion_actions
Field description
The selected set of resource names for conversion actions for optimizing this campaign.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
True
campaign.serving_status
Field description
The ad serving status of the campaign.
Category
ATTRIBUTE
Data Type
Type URL
google.ads.searchads360.v0.enums.CampaignServingStatusEnum.CampaignServingStatus
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.shopping_setting.campaign_priority
Field description
Priority 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.
Category
ATTRIBUTE
Data Type
INT32
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.shopping_setting.enable_local
Field description
Whether to include local products.
Category
ATTRIBUTE
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.shopping_setting.feed_label
Field description
Feed 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.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.shopping_setting.merchant_id
Field description
ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.shopping_setting.sales_country
Field description
Sales country of products to include in the campaign.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.shopping_setting.use_vehicle_inventory
Field description
Whether to target Vehicle Listing inventory.
Category
ATTRIBUTE
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.start_date
Field description
The date when campaign started in serving customer's timezone in YYYY-MM-DD format.
Category
ATTRIBUTE
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.status
Field description
The status of the campaign. When a new campaign is added, the status defaults to ENABLED.
Category
ATTRIBUTE
Data Type
Type URL
google.ads.searchads360.v0.enums.CampaignStatusEnum.CampaignStatus
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.target_cpa.cpc_bid_ceiling_micros
Field description
Maximum 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.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.target_cpa.cpc_bid_floor_micros
Field description
Minimum 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.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.target_cpa.target_cpa_micros
Field description
Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.target_cpm
Field description
A bidding strategy that automatically optimizes cost per thousand impressions.
Category
ATTRIBUTE
Data Type
MESSAGE
Type URL
google.ads.searchads360.v0.common.TargetCpm
Filterable
False
Selectable
True
Sortable
False
Repeated
False
campaign.target_impression_share.cpc_bid_ceiling_micros
Field description
The 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.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.target_impression_share.location
Field description
The targeted location on the search results page.
Category
ATTRIBUTE
Data Type
Type URL
google.ads.searchads360.v0.enums.TargetImpressionShareLocationEnum.TargetImpressionShareLocation
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.target_impression_share.location_fraction_micros
Field description
The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.target_roas.cpc_bid_ceiling_micros
Field description
Maximum 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.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.target_roas.cpc_bid_floor_micros
Field description
Minimum 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.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.target_roas.target_roas
Field description
The chosen revenue (based on conversion data) per unit of spend.
Category
ATTRIBUTE
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.target_spend.cpc_bid_ceiling_micros
Field description
Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.target_spend.target_spend_micros
Field description
The 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.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.tracking_setting.tracking_url
Field description
The url used for dynamic tracking.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.tracking_url_template
Field description
The URL template for constructing a tracking URL.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign.url_custom_parameters
Field description
The list of mappings used to substitute custom parameter tags in a
tracking_url_template
, final_urls
, or mobile_final_urls
.Category
ATTRIBUTE
Data Type
MESSAGE
Type URL
google.ads.searchads360.v0.common.CustomParameter
Filterable
False
Selectable
True
Sortable
False
Repeated
True
campaign.url_expansion_opt_out
Field description
Represents 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.
Category
ATTRIBUTE
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.ad_network_type
Field description
Ad network type.
Category
SEGMENT
Data Type
Type URL
google.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.asset_interaction_target.asset
Field description
The asset resource name.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.asset_interaction_target.interaction_on_this_asset
Field description
Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit.
Category
SEGMENT
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.conversion_action
Field description
Resource name of the conversion action.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.conversion_action_category
Field description
Conversion action category.
Category
SEGMENT
Data Type
Type URL
google.ads.searchads360.v0.enums.ConversionActionCategoryEnum.ConversionActionCategory
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.conversion_action_name
Field description
Conversion action name.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.date
Field description
Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
Category
SEGMENT
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.day_of_week
Field description
Day of the week, for example, MONDAY.
Category
SEGMENT
Data Type
Type URL
google.ads.searchads360.v0.enums.DayOfWeekEnum.DayOfWeek
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.device
Field description
Device to which metrics apply.
Category
SEGMENT
Data Type
Type URL
google.ads.searchads360.v0.enums.DeviceEnum.Device
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.geo_target_city
Field description
Resource name of the geo target constant that represents a city.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.geo_target_country
Field description
Resource name of the geo target constant that represents a country.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.geo_target_metro
Field description
Resource name of the geo target constant that represents a metro.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.geo_target_region
Field description
Resource name of the geo target constant that represents a region.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.hour
Field description
Hour of day as a number between 0 and 23, inclusive.
Category
SEGMENT
Data Type
INT32
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.month
Field description
Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Category
SEGMENT
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_bidding_category_level1
Field description
Bidding category (level 1) of the product.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
segments.product_bidding_category_level2
Field description
Bidding category (level 2) of the product.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
segments.product_bidding_category_level3
Field description
Bidding category (level 3) of the product.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
segments.product_bidding_category_level4
Field description
Bidding category (level 4) of the product.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
segments.product_bidding_category_level5
Field description
Bidding category (level 5) of the product.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
segments.product_brand
Field description
Brand of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_channel
Field description
Channel of the product.
Category
SEGMENT
Data Type
Type URL
google.ads.searchads360.v0.enums.ProductChannelEnum.ProductChannel
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_channel_exclusivity
Field description
Channel exclusivity of the product.
Category
SEGMENT
Data Type
Type URL
google.ads.searchads360.v0.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_condition
Field description
Condition of the product.
Category
SEGMENT
Data Type
Type URL
google.ads.searchads360.v0.enums.ProductConditionEnum.ProductCondition
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_country
Field description
Resource name of the geo target constant for the country of sale of the product.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_custom_attribute0
Field description
Custom attribute 0 of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_custom_attribute1
Field description
Custom attribute 1 of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_custom_attribute2
Field description
Custom attribute 2 of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_custom_attribute3
Field description
Custom attribute 3 of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_custom_attribute4
Field description
Custom attribute 4 of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_item_id
Field description
Item ID of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_language
Field description
Resource name of the language constant for the language of the product.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_bidding_category_level1
Field description
Bidding category (level 1) of the product sold.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
segments.product_sold_bidding_category_level2
Field description
Bidding category (level 2) of the product sold.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
segments.product_sold_bidding_category_level3
Field description
Bidding category (level 3) of the product sold.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
segments.product_sold_bidding_category_level4
Field description
Bidding category (level 4) of the product sold.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
segments.product_sold_bidding_category_level5
Field description
Bidding category (level 5) of the product sold.
Category
SEGMENT
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
segments.product_sold_brand
Field description
Brand of the product sold.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_condition
Field description
Condition of the product sold.
Category
SEGMENT
Data Type
Type URL
google.ads.searchads360.v0.enums.ProductConditionEnum.ProductCondition
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_custom_attribute0
Field description
Custom attribute 0 of the product sold.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_custom_attribute1
Field description
Custom attribute 1 of the product sold.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_custom_attribute2
Field description
Custom attribute 2 of the product sold.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_custom_attribute3
Field description
Custom attribute 3 of the product sold.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_custom_attribute4
Field description
Custom attribute 4 of the product sold.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_item_id
Field description
Item ID of the product sold.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_title
Field description
Title of the product sold.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_type_l1
Field description
Type (level 1) of the product sold.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_type_l2
Field description
Type (level 2) of the product sold.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_type_l3
Field description
Type (level 3) of the product sold.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_type_l4
Field description
Type (level 4) of the product sold.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_sold_type_l5
Field description
Type (level 5) of the product sold.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_store_id
Field description
Store ID of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_title
Field description
Title of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_type_l1
Field description
Type (level 1) of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_type_l2
Field description
Type (level 2) of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_type_l3
Field description
Type (level 3) of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_type_l4
Field description
Type (level 4) of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.product_type_l5
Field description
Type (level 5) of the product.
Category
SEGMENT
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.quarter
Field description
Quarter 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.
Category
SEGMENT
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.week
Field description
Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Category
SEGMENT
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.year
Field description
Year, formatted as yyyy.
Category
SEGMENT
Data Type
INT32
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.absolute_top_impression_percentage
Field description
Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions
Field description
The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_by_conversion_date
Field description
The 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
.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_from_click_to_call
Field description
The 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_from_directions
Field description
The 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_from_interactions_rate
Field description
All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_from_interactions_value_per_interaction
Field description
The value of all conversions from interactions divided by the total number of interactions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_from_menu
Field description
The number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_from_order
Field description
The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_from_other_engagement
Field description
The 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_from_store_visit
Field description
Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_from_store_website
Field description
The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_value
Field description
The value of all conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_value_by_conversion_date
Field description
The 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
.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_value_per_cost
Field description
The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads).
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.average_cost
Field description
The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.average_cpc
Field description
The 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
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.average_cpm
Field description
Average 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
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.average_quality_score
Field description
The average quality score.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.clicks
Field description
The number of clicks.
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.client_account_conversions
Field description
The number of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.client_account_conversions_value
Field description
The value of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.client_account_cross_sell_cost_of_goods_sold_micros
Field description
Client account cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. 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
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.client_account_cross_sell_gross_profit_micros
Field description
Client account cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. 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
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.client_account_cross_sell_revenue_micros
Field description
Client account cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. 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
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.client_account_cross_sell_units_sold
Field description
Client account cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.client_account_lead_cost_of_goods_sold_micros
Field description
Client account lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. 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
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.client_account_lead_gross_profit_micros
Field description
Client account lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. 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
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.client_account_lead_revenue_micros
Field description
Client account lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. 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
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.client_account_lead_units_sold
Field description
Client account lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.client_account_view_through_conversions
Field description
The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad.
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.content_budget_lost_impression_share
Field description
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. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.content_impression_share
Field description
The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.content_rank_lost_impression_share
Field description
The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions
Field description
The 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions_by_conversion_date
Field description
The 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions_from_interactions_rate
Field description
Average biddable conversions (from interaction) per conversion eligible interaction. Shows how often, on average, an ad interaction leads to a biddable conversion.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions_from_interactions_value_per_interaction
Field description
The 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions_value
Field description
The 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions_value_by_conversion_date
Field description
The sum of biddable conversions value by conversion date. When this column is selected with date, the values in date column means the conversion date.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions_value_per_cost
Field description
The value of biddable conversion divided by the total cost of conversion eligible interactions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cost_micros
Field description
The 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
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cost_per_all_conversions
Field description
The cost of ad interactions divided by all conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cost_per_conversion
Field description
Average conversion eligible cost per biddable conversion.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cost_per_current_model_attributed_conversion
Field description
The cost of ad interactions divided by current model attributed 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cross_device_conversions
Field description
Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cross_device_conversions_by_conversion_date
Field description
The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611
.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cross_device_conversions_value
Field description
The sum of the value of cross-device conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cross_device_conversions_value_by_conversion_date
Field description
The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611
.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cross_sell_cost_of_goods_sold_micros
Field description
Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. 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
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cross_sell_gross_profit_micros
Field description
Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. 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
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cross_sell_revenue_micros
Field description
Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. 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
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cross_sell_units_sold
Field description
Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.ctr
Field description
The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.general_invalid_click_rate
Field description
The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks. These are clicks Google considers illegitimate that are detected through routine means of filtration (that is, known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504
for details.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.general_invalid_clicks
Field description
Number of general invalid clicks. These are a subset of your invalid clicks that are detected through routine means of filtration (such as known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc.). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504
for details.
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.historical_landing_page_quality_score
Field description
The quality of historical landing page experience.
Category
METRIC
Data Type
ENUM
Type URL
google.ads.searchads360.v0.enums.QualityScoreBucketEnum.QualityScoreBucket
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.historical_quality_score
Field description
The historical quality score.
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.historical_search_predicted_ctr
Field description
The historical search predicted click through rate (CTR).
Category
METRIC
Data Type
ENUM
Type URL
google.ads.searchads360.v0.enums.QualityScoreBucketEnum.QualityScoreBucket
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.impressions
Field description
Count of how often your ad has appeared on a search results page or website on the Google Network.
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.interaction_rate
Field description
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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.interactions
Field description
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.
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.invalid_click_rate
Field description
The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.invalid_clicks
Field description
Number of clicks Google considers illegitimate and doesn't charge you for.
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.lead_cost_of_goods_sold_micros
Field description
Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. 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
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.lead_gross_profit_micros
Field description
Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. 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
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.lead_revenue_micros
Field description
Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. 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
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.lead_units_sold
Field description
Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.mobile_friendly_clicks_percentage
Field description
The percentage of mobile clicks that go to a mobile-friendly page.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.search_absolute_top_impression_share
Field description
The 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.search_budget_lost_absolute_top_impression_share
Field description
The number estimating how often your ad wasn't the very first ad among the top ads in the 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.search_budget_lost_impression_share
Field description
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. 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.search_budget_lost_top_impression_share
Field description
The number estimating how often your ad didn't show adjacent to the top 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.search_click_share
Field description
The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.search_exact_match_impression_share
Field description
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. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.search_impression_share
Field description
The 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.search_rank_lost_absolute_top_impression_share
Field description
The number estimating how often your ad wasn't the very first ad among the top ads in the 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.search_rank_lost_impression_share
Field description
The 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.search_rank_lost_top_impression_share
Field description
The number estimating how often your ad didn't show adjacent to the top 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.search_top_impression_share
Field description
The impressions you've received among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. 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. Top ads are generally above the top organic results, although they may show below the top organic results on certain queries.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.top_impression_percentage
Field description
The percent of your ad impressions that are shown adjacent to the top organic search results.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.value_per_all_conversions
Field description
The value of all conversions divided by the number of all conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.value_per_all_conversions_by_conversion_date
Field description
The 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
.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.value_per_conversion
Field description
The value of biddable conversion divided by the number of biddable conversions. Shows how much, on average, each of the biddable conversions is worth.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.value_per_conversions_by_conversion_date
Field description
Biddable 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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.visits
Field description
Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
