campaign

A campaign.

Attributed resources
accessible_bidding_strategy
bidding_strategy
campaign_budget
campaign_group
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?

 Resource fields
accessible_bidding_strategy
ad_serving_optimization_status
advertising_channel_sub_type
advertising_channel_type
ai_max_setting.bundling_required
ai_max_setting.enable_ai_max
app_campaign_setting.app_id
app_campaign_setting.app_store
app_campaign_setting.bidding_strategy_goal_type
asset_automation_settings
audience_setting.use_audience_grouped
base_campaign
bidding_strategy
bidding_strategy_system_status
bidding_strategy_type
brand_guidelines.accent_color
brand_guidelines.main_color
brand_guidelines.predefined_font_family
brand_guidelines_enabled
campaign_budget
campaign_group
commission.commission_rate_micros
contains_eu_political_advertising
demand_gen_campaign_settings.upgraded_targeting
dynamic_search_ads_setting.domain_name
dynamic_search_ads_setting.language_code
dynamic_search_ads_setting.use_supplied_urls_only
end_date_time
excluded_parent_asset_field_types
excluded_parent_asset_set_types
experiment_type
feed_types
final_url_suffix
fixed_cpm.goal
fixed_cpm.target_frequency_info.target_count
fixed_cpm.target_frequency_info.time_unit
frequency_caps
geo_target_type_setting.negative_geo_target_type
geo_target_type_setting.positive_geo_target_type
hotel_property_asset_set
hotel_setting.disable_hotel_setting
hotel_setting.hotel_center_id
id
keyword_match_type
labels
listing_type
local_campaign_setting.location_source_type
local_services_campaign_settings.category_bids
manual_cpa
manual_cpc.enhanced_cpc_enabled
manual_cpm
manual_cpv
maximize_conversion_value.target_roas
maximize_conversion_value.target_roas_tolerance_percent_millis
maximize_conversions.target_cpa_micros
missing_eu_political_advertising_declaration
name
network_settings.target_content_network
network_settings.target_google_search
network_settings.target_google_tv_network
network_settings.target_partner_search_network
network_settings.target_search_network
network_settings.target_youtube
optimization_goal_setting.optimization_goal_types
optimization_score
payment_mode
percent_cpc.cpc_bid_ceiling_micros
percent_cpc.enhanced_cpc_enabled
performance_max_upgrade.performance_max_campaign
performance_max_upgrade.pre_upgrade_campaign
performance_max_upgrade.status
pmax_campaign_settings.brand_targeting_overrides.ignore_exclusions_for_shopping_ads
primary_status
primary_status_reasons
real_time_bidding_setting.opt_in
resource_name
selective_optimization.conversion_actions
serving_status
shopping_setting.advertising_partner_ids
shopping_setting.campaign_priority
shopping_setting.disable_product_feed
shopping_setting.enable_local
shopping_setting.feed_label
shopping_setting.merchant_id
shopping_setting.use_vehicle_inventory
start_date_time
status
target_cpa.cpc_bid_ceiling_micros
target_cpa.cpc_bid_floor_micros
target_cpa.target_cpa_micros
target_cpc.target_cpc_micros
target_cpm.target_frequency_goal.target_count
target_cpm.target_frequency_goal.time_unit
target_cpv
target_impression_share.cpc_bid_ceiling_micros
target_impression_share.location
target_impression_share.location_fraction_micros
target_roas.cpc_bid_ceiling_micros
target_roas.cpc_bid_floor_micros
target_roas.target_roas
target_roas.target_roas_tolerance_percent_millis
target_spend.cpc_bid_ceiling_micros
target_spend.target_spend_micros
targeting_setting.target_restrictions
text_guidelines.messaging_restrictions
text_guidelines.term_exclusions
third_party_integration_partners.brand_lift_integration_partners
third_party_integration_partners.brand_safety_integration_partners
third_party_integration_partners.reach_integration_partners
third_party_integration_partners.viewability_integration_partners
tracking_setting.tracking_url
tracking_url_template
travel_campaign_settings.travel_account_id
url_custom_parameters
vanity_pharma.vanity_pharma_display_url_mode
vanity_pharma.vanity_pharma_text
video_campaign_settings.booking_details.cancellation_date_time
video_campaign_settings.booking_details.hold_expiration_date_time
video_campaign_settings.booking_details.status
video_campaign_settings.reservation_ad_category_self_disclosure.alcohol
video_campaign_settings.reservation_ad_category_self_disclosure.gambling
video_campaign_settings.reservation_ad_category_self_disclosure.politics
video_campaign_settings.video_ad_format_control.format_restriction
video_campaign_settings.video_ad_format_control.non_skippable_in_stream_restrictions.max_duration
video_campaign_settings.video_ad_format_control.non_skippable_in_stream_restrictions.min_duration
video_campaign_settings.video_ad_inventory_control.allow_in_feed
video_campaign_settings.video_ad_inventory_control.allow_in_stream
video_campaign_settings.video_ad_inventory_control.allow_non_skippable_in_stream
video_campaign_settings.video_ad_inventory_control.allow_shorts
video_campaign_settings.video_ad_sequence.minimum_duration
video_campaign_settings.video_ad_sequence.steps
view_through_conversion_optimization_enabled
 Segments
activity_account_id
activity_city
activity_country
activity_rating
activity_state
ad_destination_type
ad_format_type
ad_network_type
ad_sub_network_type
ad_using_product_data
ad_using_video
adjusted_age_range
adjusted_gender
asset_interaction_target.asset
asset_interaction_target.interaction_on_this_asset
auction_insight_domain
budget_campaign_association_status.campaign
budget_campaign_association_status.status
click_type
conversion_action
conversion_action_category
conversion_action_name
conversion_adjustment
conversion_attribution_event_type
conversion_lag_bucket
conversion_or_adjustment_lag_bucket
conversion_value_rule_primary_dimension
date
day_of_week
device
external_activity_id
external_conversion_source
geo_target_airport
geo_target_canton
geo_target_city
geo_target_country
geo_target_county
geo_target_district
geo_target_metro
geo_target_most_specific_location
geo_target_postal_code
geo_target_province
geo_target_region
geo_target_state
hotel_booking_window_days
hotel_center_id
hotel_check_in_date
hotel_check_in_day_of_week
hotel_city
hotel_class
hotel_country
hotel_date_selection_type
hotel_length_of_stay
hotel_price_bucket
hotel_rate_rule_id
hotel_rate_type
hotel_state
hour
interaction_on_this_extension
landing_page_source
month
month_of_year
new_versus_returning_customers
partner_hotel_id
product_aggregator_id
product_brand
product_category_level1
product_category_level2
product_category_level3
product_category_level4
product_category_level5
product_channel
product_channel_exclusivity
product_condition
product_country
product_custom_attribute0
product_custom_attribute1
product_custom_attribute2
product_custom_attribute3
product_custom_attribute4
product_feed_label
product_item_id
product_language
product_merchant_id
product_sold_brand
product_sold_category_level1
product_sold_category_level2
product_sold_category_level3
product_sold_category_level4
product_sold_category_level5
product_sold_condition
product_sold_custom_attribute0
product_sold_custom_attribute1
product_sold_custom_attribute2
product_sold_custom_attribute3
product_sold_custom_attribute4
product_sold_item_id
product_sold_title
product_sold_type_l1
product_sold_type_l2
product_sold_type_l3
product_sold_type_l4
product_sold_type_l5
product_store_id
product_title
product_type_l1
product_type_l2
product_type_l3
product_type_l4
product_type_l5
quarter
recommendation_type
search_engine_results_page_type
sk_ad_network_ad_event_type
sk_ad_network_attribution_credit
sk_ad_network_coarse_conversion_value
sk_ad_network_fine_conversion_value
sk_ad_network_postback_sequence_index
sk_ad_network_redistributed_fine_conversion_value
sk_ad_network_source_app.sk_ad_network_source_app_id
sk_ad_network_source_domain
sk_ad_network_source_type
sk_ad_network_user_type
sk_ad_network_version
slot
travel_destination_city
travel_destination_country
travel_destination_region
vertical_ads_event_participant_display_names
vertical_ads_hotel_class
vertical_ads_listing
vertical_ads_listing_brand
vertical_ads_listing_city
vertical_ads_listing_country
vertical_ads_listing_region
vertical_ads_partner_account
vertical_ads_vertical
week
year
 Metrics
absolute_top_impression_percentage
active_view_audibility_invalid_givt_measurable_impressions_rate
active_view_audibility_invalid_measurable_impressions_rate
active_view_audibility_measurable_impressions
active_view_audibility_measurable_impressions_rate
active_view_audible_impressions
active_view_audible_impressions_rate
active_view_audible_quartile_p100_rate
active_view_audible_quartile_p25_rate
active_view_audible_quartile_p50_rate
active_view_audible_quartile_p75_rate
active_view_audible_thirty_seconds_impressions
active_view_audible_thirty_seconds_impressions_rate
active_view_audible_two_seconds_impressions
active_view_audible_two_seconds_impressions_rate
active_view_cpm
active_view_ctr
active_view_impressions
active_view_measurability
active_view_measurable_cost_micros
active_view_measurable_impressions
active_view_viewability
all_average_cart_size
all_average_order_value_micros
all_conversions
all_conversions_by_conversion_date
all_conversions_from_click_to_call
all_conversions_from_directions
all_conversions_from_interactions_rate
all_conversions_from_interactions_value_per_interaction
all_conversions_from_location_asset_click_to_call
all_conversions_from_location_asset_directions
all_conversions_from_location_asset_menu
all_conversions_from_location_asset_order
all_conversions_from_location_asset_other_engagement
all_conversions_from_location_asset_store_visits
all_conversions_from_location_asset_website
all_conversions_from_menu
all_conversions_from_order
all_conversions_from_other_engagement
all_conversions_from_store_visit
all_conversions_from_store_website
all_conversions_value
all_conversions_value_by_conversion_date
all_conversions_value_per_cost
all_cost_of_goods_sold_micros
all_cross_sell_cost_of_goods_sold_micros
all_cross_sell_gross_profit_micros
all_cross_sell_revenue_micros
all_cross_sell_units_sold
all_gross_profit_margin
all_gross_profit_micros
all_lead_cost_of_goods_sold_micros
all_lead_gross_profit_micros
all_lead_revenue_micros
all_lead_units_sold
all_new_customer_lifetime_value
all_orders
all_revenue_micros
all_units_sold
auction_insight_search_absolute_top_impression_percentage
auction_insight_search_impression_share
auction_insight_search_outranking_share
auction_insight_search_overlap_rate
auction_insight_search_position_above_rate
auction_insight_search_top_impression_percentage
average_cart_size
average_cost
average_cpc
average_cpe
average_cpm
average_impression_frequency_per_user
average_order_value_micros
average_page_views
average_target_cpa_micros
average_target_roas
average_time_on_site
average_video_watch_time_duration_millis
benchmark_average_max_cpc
biddable_app_install_conversions
biddable_app_post_install_conversions
biddable_cohort_app_post_install_conversions
biddable_indirect_install_first_in_app_conversion_micros
bounce_rate
clicks
clicks_unique_query_clusters
content_budget_lost_impression_share
content_impression_share
content_rank_lost_impression_share
conversions
conversions_by_conversion_date
conversions_from_interactions_rate
conversions_from_interactions_value_per_interaction
conversions_unique_query_clusters
conversions_value
conversions_value_by_conversion_date
conversions_value_per_cost
cost_converted_currency_per_platform_comparable_conversion
cost_micros
cost_of_goods_sold_micros
cost_per_all_conversions
cost_per_conversion
cost_per_current_model_attributed_conversion
cost_per_platform_comparable_conversion
coviewed_impressions
cross_device_conversions
cross_device_conversions_by_conversion_date
cross_device_conversions_value_by_conversion_date
cross_device_conversions_value_micros
cross_sell_cost_of_goods_sold_micros
cross_sell_gross_profit_micros
cross_sell_revenue_micros
cross_sell_units_sold
ctr
current_model_attributed_conversions
current_model_attributed_conversions_from_interactions_rate
current_model_attributed_conversions_from_interactions_value_per_interaction
current_model_attributed_conversions_value
current_model_attributed_conversions_value_per_cost
eligible_impressions_from_location_asset_store_reach
engagement_rate
engagements
general_invalid_click_rate
general_invalid_clicks
gmail_forwards
gmail_saves
gmail_secondary_clicks
gross_profit_margin
gross_profit_micros
historical_creative_quality_score
historical_landing_page_quality_score
historical_quality_score
historical_search_predicted_ctr
hotel_average_lead_value_micros
hotel_eligible_impressions
hotel_price_difference_percentage
impressions
impressions_unique_query_clusters
interaction_event_types
interaction_rate
interactions
invalid_click_rate
invalid_clicks
lead_cost_of_goods_sold_micros
lead_gross_profit_micros
lead_revenue_micros
lead_units_sold
message_chat_rate
message_chats
message_impressions
mobile_friendly_clicks_percentage
new_customer_lifetime_value
optimization_score_uplift
optimization_score_url
orders
percent_new_visitors
phone_calls
phone_impressions
phone_through_rate
platform_comparable_conversions
platform_comparable_conversions_by_conversion_date
platform_comparable_conversions_from_interactions_rate
platform_comparable_conversions_from_interactions_value_per_interaction
platform_comparable_conversions_value
platform_comparable_conversions_value_by_conversion_date
platform_comparable_conversions_value_per_cost
primary_impressions
publisher_organic_clicks
publisher_purchased_clicks
publisher_unknown_clicks
relative_ctr
results_conversions_purchase
revenue_micros
search_absolute_top_impression_share
search_budget_lost_absolute_top_impression_share
search_budget_lost_impression_share
search_budget_lost_top_impression_share
search_click_share
search_exact_match_impression_share
search_impression_share
search_rank_lost_absolute_top_impression_share
search_rank_lost_impression_share
search_rank_lost_top_impression_share
search_top_impression_share
sk_ad_network_installs
sk_ad_network_total_conversions
speed_score
store_visits_last_click_model_attributed_conversions
svr
top_impression_percentage
trueview_average_cpv
unique_users
unique_users_five_plus
unique_users_four_plus
unique_users_ten_plus
unique_users_three_plus
unique_users_two_plus
units_sold
valid_accelerated_mobile_pages_clicks_percentage
value_per_all_conversions
value_per_all_conversions_by_conversion_date
value_per_conversion
value_per_conversions_by_conversion_date
value_per_current_model_attributed_conversion
value_per_platform_comparable_conversion
value_per_platform_comparable_conversions_by_conversion_date
video_quartile_p100_rate
video_quartile_p25_rate
video_quartile_p50_rate
video_quartile_p75_rate
video_trueview_view_rate
video_trueview_view_rate_in_feed
video_trueview_view_rate_in_stream
video_trueview_view_rate_shorts
video_trueview_views
video_watch_time_duration_millis
view_through_conversions
view_through_conversions_from_location_asset_click_to_call
view_through_conversions_from_location_asset_directions
view_through_conversions_from_location_asset_menu
view_through_conversions_from_location_asset_order
view_through_conversions_from_location_asset_other_engagement
view_through_conversions_from_location_asset_store_visits
view_through_conversions_from_location_asset_website

campaign.accessible_bidding_strategy

Field description

Output only. 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.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign.ad_serving_optimization_status

Field description

The ad serving optimization status of the campaign.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.AdServingOptimizationStatusEnum.AdServingOptimizationStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.advertising_channel_sub_type

Field description

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

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.AdvertisingChannelSubTypeEnum.AdvertisingChannelSubType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.advertising_channel_type

Field description

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

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.ai_max_setting.bundling_required

Field description

Output only. Indicates whether a search campaign has adopted AI Max before, and is required to have AI Max enabled to adopt campaign-level text asset automation and brand list targeting in all API versions.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.resources.Campaign.AiMaxSetting.AiMaxBundlingRequired
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.ai_max_setting.enable_ai_max

Field description

Controls whether or not AI Max features are served for this campaign. Individual AI Max features are enabled or disabled by their respective settings. But if enable_ai_max is set to false or cleared, then no AI Max features will serve for this campaign, regardless of the other settings. Search Term Matching is enabled by default when AI Max is enabled, and can be disabled at the ad group level.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.app_campaign_setting.app_id

Field description

Immutable. A string that uniquely identifies a mobile application.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.app_campaign_setting.app_store

Field description

Immutable. The application store that distributes this specific app.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.AppCampaignAppStoreEnum.AppCampaignAppStore
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.app_campaign_setting.bidding_strategy_goal_type

Field description

Represents the goal which the bidding strategy of this app campaign should optimize towards.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.AppCampaignBiddingStrategyGoalTypeEnum.AppCampaignBiddingStrategyGoalType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.asset_automation_settings

Field description

Contains the opt-in/out status of each AssetAutomationType. See documentation of each asset automation type enum for default opt in/out behavior.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.resources.Campaign.AssetAutomationSetting
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign.audience_setting.use_audience_grouped

Field description

Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.base_campaign

Field description

Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.bidding_strategy

Field description

The resource name of the portfolio bidding strategy used by the campaign.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign.bidding_strategy_system_status

Field description

Output only. The system status of the campaign's bidding strategy.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.BiddingStrategySystemStatusEnum.BiddingStrategySystemStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.bidding_strategy_type

Field description

Output only. 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.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.BiddingStrategyTypeEnum.BiddingStrategyType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.brand_guidelines.accent_color

Field description

The accent brand color, entered as a hex code (e.g., #00ff00). You must provide the accent_color if you provide a main_color.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign.brand_guidelines.main_color

Field description

The main brand color, entered as a hex code (e.g., #00ff00). You must provide the main_color if you provide an accent_color.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign.brand_guidelines.predefined_font_family

Field description

The brand's font family. Must be one of the following Google Fonts (case sensitive): Open Sans, Roboto, Montserrat, Poppins, Lato, Oswald, Playfair Display, Roboto Slab.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign.brand_guidelines_enabled

Field description

Immutable. Whether Brand Guidelines are enabled for this Campaign. Only applicable to Performance Max campaigns. If enabled, business name and logo assets must be linked as CampaignAssets instead of AssetGroupAssets. Writable only at campaign creation. Set to true to enable Brand Guidelines when creating a new Performance Max campaign. Immutable after creation. This field cannot be modified using standard update operations after the campaign has been created. For existing campaigns: To enable Brand Guidelines on a campaign after it has been created, use the CampaignService.EnablePMaxBrandGuidelines method, which is a separate operation. It is not possible to disable Brand Guidelines for an existing campaign. Incompatible with Travel Goals: This feature is not supported for Performance Max campaigns with Travel Goals. Attempting to set this field to true for a Travel Goals campaign will result in an error.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign.campaign_budget

Field description

The resource name of the campaign budget of the campaign.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign.campaign_group

Field description

The resource name of the campaign group that this campaign belongs to.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign.commission.commission_rate_micros

Field description

Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x * 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%).

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.contains_eu_political_advertising

Field description

The advertiser should self-declare whether this campaign contains political advertising content targeted towards the European Union.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.EuPoliticalAdvertisingStatusEnum.EuPoliticalAdvertisingStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.demand_gen_campaign_settings.upgraded_targeting

Field description

Immutable. Specifies whether this campaign uses upgraded targeting options. When this field is set to true, you can use location and language targeting at the ad group level as opposed to the standard campaign-level targeting. This field defaults to true, and can only be set when creating a campaign.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.dynamic_search_ads_setting.language_code

Field description

Required. The language code specifying the language of the domain, for example, "en".

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.dynamic_search_ads_setting.use_supplied_urls_only

Field description

Whether the campaign uses advertiser supplied URLs exclusively.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.end_date_time

Field description

The last day and time of the campaign in serving customer's timezone in "yyyy-MM-dd HH:mm:ss" format. Set the time component to 23:59:59 for daily granularity, time granularity is only supported for some campaign types. On create, defaults to running indefinitely. To set an existing campaign to run indefinitely, clear this field.

CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.AssetFieldTypeEnum.AssetFieldType
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

campaign.excluded_parent_asset_set_types

Field description

The asset set types that should be excluded from this campaign. Asset set links with these types will not be inherited by this campaign from the upper level. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this campaign, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this campaign. Only LOCATION_SYNC is currently supported.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.AssetSetTypeEnum.AssetSetType
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

campaign.experiment_type

Field description

Output only. The type of campaign: normal, draft, or experiment.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.CampaignExperimentTypeEnum.CampaignExperimentType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.feed_types

Field description

Output only. Types of feeds that are attached directly to this campaign.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.AssetSetTypeEnum.AssetSetType
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

campaign.final_url_suffix

Field description

Suffix used to append query parameters to landing pages that are served with parallel tracking.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.fixed_cpm.goal

Field description

Fixed CPM bidding goal. Determines the exact bidding optimization parameters.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.FixedCpmGoalEnum.FixedCpmGoal
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.fixed_cpm.target_frequency_info.target_count

Field description

Target frequency count represents the number of times an advertiser wants to show the ad to target a single user.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.fixed_cpm.target_frequency_info.time_unit

Field description

Time window expressing the period over which you want to reach the specified target_count.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.FixedCpmTargetFrequencyTimeUnitEnum.FixedCpmTargetFrequencyTimeUnit
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.frequency_caps

Field description

A list that limits how often each user will see this campaign's ads.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.common.FrequencyCapEntry
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign.geo_target_type_setting.negative_geo_target_type

Field description

The setting used for negative geotargeting in this particular campaign.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.NegativeGeoTargetTypeEnum.NegativeGeoTargetType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.geo_target_type_setting.positive_geo_target_type

Field description

The setting used for positive geotargeting in this particular campaign.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.PositiveGeoTargetTypeEnum.PositiveGeoTargetType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.hotel_property_asset_set

Field description

Immutable. The resource name for a set of hotel properties for Performance Max for travel goals campaigns.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.hotel_setting.disable_hotel_setting

Field description

Disable the optional hotel setting. This field is currently supported only for Demand Gen campaigns.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.hotel_setting.hotel_center_id

Field description

The linked Hotel Center account.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.id

Field description

Output only. The ID of the campaign.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.keyword_match_type

Field description

Keyword match type of Campaign. Set to BROAD to set broad matching for all keywords in a campaign.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.CampaignKeywordMatchTypeEnum.CampaignKeywordMatchType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.labels

Field description

Output only. The resource names of labels attached to this campaign.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

campaign.listing_type

Field description

Immutable. Listing type of ads served for this campaign. Field is restricted for usage with Performance Max campaigns.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.ListingTypeEnum.ListingType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.local_campaign_setting.location_source_type

Field description

The location source type for this local campaign.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.LocationSourceTypeEnum.LocationSourceType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.local_services_campaign_settings.category_bids

Field description

Categorical level bids associated with MANUAL_CPA bidding strategy.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.resources.Campaign.CategoryBid
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

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.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.common.ManualCpa
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

campaign.manual_cpc.enhanced_cpc_enabled

Field description

Whether bids are to be enhanced based on conversion optimizer data.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.manual_cpm

Field description

Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.common.ManualCpm
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

campaign.manual_cpv

Field description

A bidding strategy that pays a configurable amount per video view.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.common.ManualCpv
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeDOUBLE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.maximize_conversion_value.target_roas_tolerance_percent_millis

Field description

The percent of ROAS(return on advertising spend) degradation tolerance allowed to increase traffic diversity and conversion volume, specified in millis (for example, 10,000 = 10%). A value of 10,000 means that the advertiser can expect ROAS degradation of up to 10% of the specified target ROAS.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.maximize_conversions.target_cpa_micros

Field description

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

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.missing_eu_political_advertising_declaration

Field description

Output only. Indicates whether this campaign is missing a declaration about whether it contains political advertising targeted towards the EU and is ineligible for any exemptions. If this field is true, use the contains_eu_political_advertising field to add the required declaration. This field is read-only.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Field description

Whether ads will be served with google.com search results.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.network_settings.target_google_tv_network

Field description

Whether ads will be served on the Google TV network.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.network_settings.target_partner_search_network

Field description

Whether ads will be served on the partner network. This is available only to some select partner accounts. Unless you have been instructed to use this field, it likely does not apply to your account. This does not control whether ads will be served on Google Search Partners Network; use target_search_network for that instead.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.network_settings.target_search_network

Field description

Whether ads will be served on sites in the Google Search Partners Network (requires target_google_search to also be true).

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.network_settings.target_youtube

Field description

Whether ads will be served on YouTube.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.optimization_goal_setting.optimization_goal_types

Field description

The list of optimization goal types.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.OptimizationGoalTypeEnum.OptimizationGoalType
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

campaign.optimization_score

Field description

Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only.

CategoryATTRIBUTE
Data TypeDOUBLE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.payment_mode

Field description

Payment mode for the campaign.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.PaymentModeEnum.PaymentMode
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.performance_max_upgrade.performance_max_campaign

Field description

Output only. The resource name of the Performance Max campaign the campaign is upgraded to.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.performance_max_upgrade.pre_upgrade_campaign

Field description

Output only. The resource name of the legacy campaign upgraded to Performance Max.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.performance_max_upgrade.status

Field description

Output only. The upgrade status of a campaign requested to be upgraded to Performance Max.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.PerformanceMaxUpgradeStatusEnum.PerformanceMaxUpgradeStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.pmax_campaign_settings.brand_targeting_overrides.ignore_exclusions_for_shopping_ads

Field description

If true, brand exclusions are ignored for Shopping ads.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.primary_status

Field description

Output only. The primary status of the campaign. Provides insight into why a campaign is not serving or not serving optimally. Modification to the campaign and its related entities might take a while to be reflected in this status.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.CampaignPrimaryStatusEnum.CampaignPrimaryStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.primary_status_reasons

Field description

Output only. The primary status reasons of the campaign. Provides insight into why a campaign is not serving or not serving optimally. These reasons are aggregated to determine an overall CampaignPrimaryStatus.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.CampaignPrimaryStatusReasonEnum.CampaignPrimaryStatusReason
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

campaign.real_time_bidding_setting.opt_in

Field description

Whether the campaign is opted in to real-time bidding.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.resource_name

Field description

Immutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign.selective_optimization.conversion_actions

Field description

The selected set of resource names for conversion actions for optimizing this campaign.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

campaign.serving_status

Field description

Output only. The ad serving status of the campaign.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.CampaignServingStatusEnum.CampaignServingStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.shopping_setting.advertising_partner_ids

Field description

The list of Google Ads accounts IDs of advertising partners cooperating within the campaign. This feature is currently available only for accounts having an advertising partner link. Once set, the field is immutable. This feature is currently supported only for Performance Max, Shopping, Search and Demand Gen campaign types.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

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.

CategoryATTRIBUTE
Data TypeINT32
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.shopping_setting.disable_product_feed

Field description

Disable the optional product feed. This field is currently supported only for Demand Gen campaigns. See https://support.google.com/google-ads/answer/13721750 to learn more about this feature.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.shopping_setting.enable_local

Field description

Whether to include local products.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.shopping_setting.feed_label

Field description

Feed label of products to include in the campaign. Valid feed labels may contain a maximum of 20 characters including uppercase letters, numbers, hyphens, and underscores. If you previously used the deprecated sales_country in the two-letter country code (XX) format, the feed_label field should be used instead. For more information see the feed label support article.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.shopping_setting.use_vehicle_inventory

Field description

Immutable. Whether to target Vehicle Listing inventory. This field is supported only in Smart Shopping Campaigns. For setting Vehicle Listing inventory in Performance Max campaigns, use listing_type instead.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.start_date_time

Field description

The date and time when campaign started in serving. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. Set the time component to 00:00:00 for daily granularity, time granularity is only supported for some campaign types.

CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.status

Field description

The status of the campaign. When a new campaign is added, the status defaults to ENABLED.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.CampaignStatusEnum.CampaignStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.target_cpc.target_cpc_micros

Field description

Average CPC target. This target should be greater than or equal to minimum billable unit based on the currency for the account.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.target_cpm.target_frequency_goal.target_count

Field description

Target Frequency count representing how many times you want to reach a single user.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.target_cpm.target_frequency_goal.time_unit

Field description

Time window expressing the period over which you want to reach the specified target_count.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.TargetFrequencyTimeUnitEnum.TargetFrequencyTimeUnit
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.target_cpv

Field description

An automated bidding strategy that sets bids to optimize performance given the target CPV you set.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.common.TargetCpv
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.target_impression_share.location

Field description

The targeted location on the search results page.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.TargetImpressionShareLocationEnum.TargetImpressionShareLocation
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.target_roas.target_roas

Field description

Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.

CategoryATTRIBUTE
Data TypeDOUBLE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.target_roas.target_roas_tolerance_percent_millis

Field description

The percent of ROAS(return on advertising spend) degradation tolerance allowed to increase traffic diversity and conversion volume, specified in millis (for example, 10,000 = 10%). A value of 10,000 means that the advertiser can expect ROAS degradation of up to 10% of the specified target ROAS. This field is only mutable for portfolio bidding strategies.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.target_spend.target_spend_micros

Field description

Deprecated: 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.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.targeting_setting.target_restrictions

Field description

The per-targeting-dimension setting to restrict the reach of your campaign or ad group.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.common.TargetRestriction
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign.text_guidelines.messaging_restrictions

Field description

Freeform instructions that will be used to guide text asset generation using LLM inference. At most 40 restrictions may be provided.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.resources.Campaign.MessagingRestriction
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign.text_guidelines.term_exclusions

Field description

Exact words or phrases that will be excluded from generated text assets. At most 25 exclusions may be provided. Valid exclusions may contain a maximum of 30 characters.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

campaign.third_party_integration_partners.brand_lift_integration_partners

Field description

Third party integration partners for Brand Lift verification for this Campaign.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.common.CampaignThirdPartyBrandLiftIntegrationPartner
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign.third_party_integration_partners.brand_safety_integration_partners

Field description

Third party integration partners for brand safety verification for this Campaign.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.common.CampaignThirdPartyBrandSafetyIntegrationPartner
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign.third_party_integration_partners.reach_integration_partners

Field description

Third party integration partners for reach verification for this Campaign.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.common.CampaignThirdPartyReachIntegrationPartner
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign.third_party_integration_partners.viewability_integration_partners

Field description

Third party integration partners for YouTube viewability verification for this Campaign.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.common.CampaignThirdPartyViewabilityIntegrationPartner
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign.tracking_setting.tracking_url

Field description

Output only. The url used for dynamic tracking.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.tracking_url_template

Field description

The URL template for constructing a tracking URL.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.travel_campaign_settings.travel_account_id

Field description

Immutable. The Travel account ID associated with the Travel campaign.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.common.CustomParameter
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign.vanity_pharma.vanity_pharma_display_url_mode

Field description

The display mode for vanity pharma URLs.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.VanityPharmaDisplayUrlModeEnum.VanityPharmaDisplayUrlMode
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.vanity_pharma.vanity_pharma_text

Field description

The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.VanityPharmaTextEnum.VanityPharmaText
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.booking_details.cancellation_date_time

Field description

Output only. Time when the booked inventory of this campaign will be cancelled or has been cancelled. Available for primary status NOT_ELIGIBLE if the campaign will be cancelled and for primary status reason BOOKING_CANCELLED. Format is "yyyy-MM-dd HH:mm:ss" in the customer's time zone.

CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.booking_details.hold_expiration_date_time

Field description

Output only. Time until which booked inventory will be held or has been held for this campaign. Available for status HELD and HOLD_EXPIRED. Format is "yyyy-MM-dd HH:mm:ss" in the customer's time zone.

CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.booking_details.status

Field description

Output only. The status of the booking.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.BookingStatusEnum.BookingStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.reservation_ad_category_self_disclosure.alcohol

Field description

The campaign is expected to contain alcohol-related ads.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.reservation_ad_category_self_disclosure.gambling

Field description

The campaign is expected to contain gambling-related ads.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.reservation_ad_category_self_disclosure.politics

Field description

The campaign is expected to contain politics-related ads.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.video_ad_format_control.format_restriction

Field description

All contained responsive ads are expected to respect this restriction.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.VideoAdFormatRestrictionEnum.VideoAdFormatRestriction
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.video_ad_format_control.non_skippable_in_stream_restrictions.max_duration

Field description

The maximum allowed duration for non-skippable ads.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.NonSkippableMaxDurationEnum.NonSkippableMaxDuration
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.video_ad_format_control.non_skippable_in_stream_restrictions.min_duration

Field description

The minimum allowed duration for non-skippable ads.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.NonSkippableMinDurationEnum.NonSkippableMinDuration
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed

Field description

Determine if video responsive ads can be used for in-feed video ads.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream

Field description

Determine if video responsive ads can be used for in-stream video ads.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.video_ad_inventory_control.allow_non_skippable_in_stream

Field description

Determine if video responsive ads can be used for non-skippable in-stream ads. This is only available for campaigns that allow mixing of non-skippable with other formats (Video reach campaign with Target Frequency bidding strategy goal).

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts

Field description

Determine if video responsive ads can be used as shorts format.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.video_ad_sequence.minimum_duration

Field description

Users are eligible to repeat sequence after this period. Defaults to WEEK if not specified.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.VideoAdSequenceMinimumDurationEnum.VideoAdSequenceMinimumDuration
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign.video_campaign_settings.video_ad_sequence.steps

Field description

The list of sequence steps and data associated with them.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v24.resources.Campaign.VideoCampaignSettings.VideoAdSequenceStep
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign.view_through_conversion_optimization_enabled

Field description

Whether VTC (View-through Conversion) optimization is enabled for this campaign. Only allowed for certain Demand Gen and App Campaigns.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.activity_account_id

Field description

Activity account ID.

CategorySEGMENT
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.activity_city

Field description

The city where the travel activity is available.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.activity_country

Field description

The country where the travel activity is available.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.activity_rating

Field description

Activity rating.

CategorySEGMENT
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.activity_state

Field description

The state where the travel activity is available.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.ad_destination_type

Field description

Ad Destination type.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.AdDestinationTypeEnum.AdDestinationType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.ad_format_type

Field description

Ad Format type.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.AdFormatTypeEnum.AdFormatType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.ad_network_type

Field description

Ad network type.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.AdNetworkTypeEnum.AdNetworkType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.ad_sub_network_type

Field description

Ad sub network type. Currently only available for ads running as part of DemandGen campaigns on YouTube and has to always be selected together with ad_network_type.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.AdSubNetworkTypeEnum.AdSubNetworkType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.ad_using_product_data

Field description

Indicates whether an ad is using product data from a Google Merchant Center feed. This segment is only available for PMax campaigns and will not return data when any other campaign type is selected.

CategorySEGMENT
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.ad_using_video

Field description

Indicates whether an ad is using a video asset. This segment is only available for PMax campaigns and will not return data when any other campaign type is selected.

CategorySEGMENT
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.adjusted_age_range

Field description

Adjusted age range. This is the age range of the user after applying modeling to get more accurate age and gender information. Currently, both adjusted_age_range and adjusted_gender need to be selected together to get valid reach stats. These segmentations are only available for allowlisted customers.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.AgeRangeTypeEnum.AgeRangeType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.adjusted_gender

Field description

Adjusted gender. This is the gender of the user after applying modeling to get more accurate age and gender information. Currently, both adjusted_age_range and adjusted_gender need to be selected together to get valid reach stats. These segmentations are only available for allowlisted customers.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.GenderTypeEnum.GenderType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.asset_interaction_target.asset

Field description

The asset resource name.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

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.

CategorySEGMENT
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.auction_insight_domain

Field description

Domain (visible URL) of a participant in the Auction Insights report.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableFalse
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.budget_campaign_association_status.campaign

Field description

The campaign resource name.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.budget_campaign_association_status.status

Field description

Budget campaign association status.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.BudgetCampaignAssociationStatusEnum.BudgetCampaignAssociationStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.click_type

Field description

Click type.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.ClickTypeEnum.ClickType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.conversion_action

Field description

Resource name of the conversion action.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.conversion_action_category

Field description

Conversion action category.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.ConversionActionCategoryEnum.ConversionActionCategory
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.conversion_action_name

Field description

Conversion action name.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.conversion_adjustment

Field description

This segments your conversion columns by the original conversion and conversion value versus the delta if conversions were adjusted. False row has the data as originally stated; While true row has the delta between data now and the data as originally stated. Summing the two together results post-adjustment data.

CategorySEGMENT
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.conversion_attribution_event_type

Field description

Conversion attribution event type.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.ConversionAttributionEventTypeEnum.ConversionAttributionEventType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.conversion_lag_bucket

Field description

An enum value representing the number of days between the impression and the conversion.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.ConversionLagBucketEnum.ConversionLagBucket
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.conversion_or_adjustment_lag_bucket

Field description

An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.ConversionOrAdjustmentLagBucketEnum.ConversionOrAdjustmentLagBucket
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.conversion_value_rule_primary_dimension

Field description

Primary dimension of applied conversion value rules. NO_RULE_APPLIED shows the total recorded value of conversions that do not have a value rule applied. ORIGINAL shows the original value of conversions to which a value rule has been applied. GEO_LOCATION, DEVICE, AUDIENCE, ITINERARY show the net adjustment after value rules were applied.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.ConversionValueRulePrimaryDimensionEnum.ConversionValueRulePrimaryDimension
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.date

Field description

Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.

CategorySEGMENT
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.day_of_week

Field description

Day of the week, for example, MONDAY.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.DayOfWeekEnum.DayOfWeek
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.device

Field description

Device to which metrics apply.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.DeviceEnum.Device
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.external_activity_id

Field description

Advertiser supplied activity ID.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.external_conversion_source

Field description

External conversion source.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.ExternalConversionSourceEnum.ExternalConversionSource
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.geo_target_airport

Field description

Resource name of the geo target constant that represents an airport.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.geo_target_canton

Field description

Resource name of the geo target constant that represents a canton.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.geo_target_city

Field description

Resource name of the geo target constant that represents a city.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.geo_target_country

Field description

Resource name of the geo target constant that represents a country.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.geo_target_county

Field description

Resource name of the geo target constant that represents a county.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.geo_target_district

Field description

Resource name of the geo target constant that represents a district.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.geo_target_metro

Field description

Resource name of the geo target constant that represents a metro.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.geo_target_most_specific_location

Field description

Resource name of the geo target constant that represents the most specific location.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.geo_target_postal_code

Field description

Resource name of the geo target constant that represents a postal code.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.geo_target_province

Field description

Resource name of the geo target constant that represents a province.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.geo_target_region

Field description

Resource name of the geo target constant that represents a region.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.geo_target_state

Field description

Resource name of the geo target constant that represents a state.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hotel_booking_window_days

Field description

Hotel booking window in days.

CategorySEGMENT
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hotel_center_id

Field description

Hotel center ID.

CategorySEGMENT
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hotel_check_in_date

Field description

Hotel check-in date. Formatted as yyyy-MM-dd.

CategorySEGMENT
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hotel_check_in_day_of_week

Field description

Hotel check-in day of week.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.DayOfWeekEnum.DayOfWeek
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hotel_city

Field description

Hotel city.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hotel_class

Field description

Hotel class.

CategorySEGMENT
Data TypeINT32
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hotel_country

Field description

Hotel country.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hotel_date_selection_type

Field description

Hotel date selection type.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.HotelDateSelectionTypeEnum.HotelDateSelectionType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hotel_length_of_stay

Field description

Hotel length of stay.

CategorySEGMENT
Data TypeINT32
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hotel_price_bucket

Field description

Hotel price bucket.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.HotelPriceBucketEnum.HotelPriceBucket
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hotel_rate_rule_id

Field description

Hotel rate rule ID.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hotel_rate_type

Field description

Hotel rate type.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.HotelRateTypeEnum.HotelRateType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hotel_state

Field description

Hotel state.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.hour

Field description

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

CategorySEGMENT
Data TypeINT32
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.interaction_on_this_extension

Field description

Only used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit.

CategorySEGMENT
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.landing_page_source

Field description

The source of a landing page in the landing page report.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.LandingPageSourceEnum.LandingPageSource
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.month

Field description

Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.

CategorySEGMENT
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.month_of_year

Field description

Month of the year, for example, January.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.MonthOfYearEnum.MonthOfYear
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.new_versus_returning_customers

Field description

This is for segmenting conversions by whether the user is a new customer or a returning customer. This segmentation is typically used to measure the impact of customer acquisition goal.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.ConvertingUserPriorEngagementTypeAndLtvBucketEnum.ConvertingUserPriorEngagementTypeAndLtvBucket
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.partner_hotel_id

Field description

Partner hotel ID.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_aggregator_id

Field description

Aggregator ID of the product.

CategorySEGMENT
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_brand

Field description

Brand of the product.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_category_level1

Field description

Category (level 1) of the product.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable with

segments.product_category_level2

Field description

Category (level 2) of the product.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable with

segments.product_category_level3

Field description

Category (level 3) of the product.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable with

segments.product_category_level4

Field description

Category (level 4) of the product.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable with

segments.product_category_level5

Field description

Category (level 5) of the product.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable with

segments.product_channel

Field description

Channel of the product.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.ProductChannelEnum.ProductChannel
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_channel_exclusivity

Field description

Channel exclusivity of the product.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_condition

Field description

Condition of the product.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.ProductConditionEnum.ProductCondition
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_country

Field description

Resource name of the geo target constant for the country of sale of the product.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_custom_attribute0

Field description

Custom attribute 0 of the product.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_custom_attribute1

Field description

Custom attribute 1 of the product.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_custom_attribute2

Field description

Custom attribute 2 of the product.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_custom_attribute3

Field description

Custom attribute 3 of the product.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_custom_attribute4

Field description

Custom attribute 4 of the product.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_feed_label

Field description

Feed label of the product.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_item_id

Field description

Item ID of the product.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_language

Field description

Resource name of the language constant for the language of the product.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_merchant_id

Field description

Merchant ID of the product.

CategorySEGMENT
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_sold_brand

Field description

Brand of the product sold.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_sold_category_level1

Field description

Category (level 1) of the product sold.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable with

segments.product_sold_category_level2

Field description

Category (level 2) of the product sold.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable with

segments.product_sold_category_level3

Field description

Category (level 3) of the product sold.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable with

segments.product_sold_category_level4

Field description

Category (level 4) of the product sold.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable with

segments.product_sold_category_level5

Field description

Category (level 5) of the product sold.

CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable with

segments.product_sold_condition

Field description

Condition of the product sold.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v24.enums.ProductConditionEnum.ProductCondition
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_sold_custom_attribute0

Field description

Custom attribute 0 of the product sold.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_sold_custom_attribute1

Field description

Custom attribute 1 of the product sold.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_sold_custom_attribute2

Field description

Custom attribute 2 of the product sold.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_sold_custom_attribute3

Field description

Custom attribute 3 of the product sold.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_sold_custom_attribute4

Field description

Custom attribute 4 of the product sold.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_sold_item_id

Field description

Item ID of the product sold.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_sold_title

Field description

Title of the product sold.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_sold_type_l1

Field description

Type (level 1) of the product sold.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_sold_type_l2

Field description

Type (level 2) of the product sold.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.product_sold_type_l3

Field description

Type (level 3) of the product sold.

CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with