Learn more about migrating to the Google Ads API by watching our latest webinar

segments

segments.ad_destination_type

Field descriptionAd Destination type.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.AdDestinationTypeEnum.AdDestinationType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.ad_network_type

Field descriptionAd network type.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.AdNetworkTypeEnum.AdNetworkType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.asset_interaction_target.asset

Field descriptionThe 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 descriptionOnly 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.budget_campaign_association_status.campaign

Field descriptionThe campaign resource name.
CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.budget_campaign_association_status.status

Field descriptionBudget campaign association status.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.BudgetCampaignAssociationStatusEnum.BudgetCampaignAssociationStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.click_type

Field descriptionClick type.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.ClickTypeEnum.ClickType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.conversion_action

Field descriptionResource name of the conversion action.
CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.conversion_action_category

Field descriptionConversion action category.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.ConversionActionCategoryEnum.ConversionActionCategory
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.conversion_action_name

Field descriptionConversion action name.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.conversion_adjustment

Field descriptionThis segments your conversion columns by the original conversion and conversion value vs. 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 descriptionConversion attribution event type.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.ConversionAttributionEventTypeEnum.ConversionAttributionEventType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.conversion_lag_bucket

Field descriptionAn enum value representing the number of days between the impression and the conversion.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.ConversionLagBucketEnum.ConversionLagBucket
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.conversion_or_adjustment_lag_bucket

Field descriptionAn 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.v8.enums.ConversionOrAdjustmentLagBucketEnum.ConversionOrAdjustmentLagBucket
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.date

Field descriptionDate to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
CategorySEGMENT
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.day_of_week

Field descriptionDay of the week, e.g., MONDAY.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.DayOfWeekEnum.DayOfWeek
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.device

Field descriptionDevice to which metrics apply.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.DeviceEnum.Device
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.external_conversion_source

Field descriptionExternal conversion source.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.ExternalConversionSourceEnum.ExternalConversionSource
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.geo_target_airport

Field descriptionResource 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 descriptionResource 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 descriptionResource 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 descriptionResource 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 descriptionResource 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 descriptionResource 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 descriptionResource 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 descriptionResource 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 descriptionResource 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 descriptionResource 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 descriptionResource 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 descriptionResource 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 descriptionHotel booking window in days.
CategorySEGMENT
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_center_id

Field descriptionHotel center ID.
CategorySEGMENT
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_check_in_date

Field descriptionHotel 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 descriptionHotel check-in day of week.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.DayOfWeekEnum.DayOfWeek
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_city

Field descriptionHotel city.
CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_class

Field descriptionHotel class.
CategorySEGMENT
Data TypeINT32
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_country

Field descriptionHotel country.
CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_date_selection_type

Field descriptionHotel date selection type.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.HotelDateSelectionTypeEnum.HotelDateSelectionType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_length_of_stay

Field descriptionHotel length of stay.
CategorySEGMENT
Data TypeINT32
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_price_bucket

Field descriptionHotel price bucket.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.HotelPriceBucketEnum.HotelPriceBucket
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_rate_rule_id

Field descriptionHotel rate rule ID.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_rate_type

Field descriptionHotel rate type.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.HotelRateTypeEnum.HotelRateType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_state

Field descriptionHotel state.
CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hour

Field descriptionHour 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 descriptionOnly 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.keyword.ad_group_criterion

Field descriptionThe AdGroupCriterion resource name.
CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable With

segments.keyword.info.match_type

Field descriptionThe match type of the keyword.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.KeywordMatchTypeEnum.KeywordMatchType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.keyword.info.text

Field descriptionThe text of the keyword (at most 80 characters and 10 words).
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.month

Field descriptionMonth 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 descriptionMonth of the year, e.g., January.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.MonthOfYearEnum.MonthOfYear
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.partner_hotel_id

Field descriptionPartner hotel ID.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.placeholder_type

Field descriptionPlaceholder type. This is only used with feed item metrics.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.PlaceholderTypeEnum.PlaceholderType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_aggregator_id

Field descriptionAggregator ID of the product.
CategorySEGMENT
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_bidding_category_level1

Field descriptionBidding category (level 1) of the product.
CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable With

segments.product_bidding_category_level2

Field descriptionBidding category (level 2) of the product.
CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable With

segments.product_bidding_category_level3

Field descriptionBidding category (level 3) of the product.
CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable With

segments.product_bidding_category_level4

Field descriptionBidding category (level 4) of the product.
CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable With

segments.product_bidding_category_level5

Field descriptionBidding category (level 5) of the product.
CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable With

segments.product_brand

Field descriptionBrand of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_channel

Field descriptionChannel of the product.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.ProductChannelEnum.ProductChannel
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_channel_exclusivity

Field descriptionChannel exclusivity of the product.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_condition

Field descriptionCondition of the product.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.ProductConditionEnum.ProductCondition
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_country

Field descriptionResource 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 descriptionCustom attribute 0 of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_custom_attribute1

Field descriptionCustom attribute 1 of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_custom_attribute2

Field descriptionCustom attribute 2 of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_custom_attribute3

Field descriptionCustom attribute 3 of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_custom_attribute4

Field descriptionCustom attribute 4 of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_item_id

Field descriptionItem ID of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_language

Field descriptionResource 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 descriptionMerchant ID of the product.
CategorySEGMENT
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_store_id

Field descriptionStore ID of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_title

Field descriptionTitle of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_type_l1

Field descriptionType (level 1) of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_type_l2

Field descriptionType (level 2) of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_type_l3

Field descriptionType (level 3) of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_type_l4

Field descriptionType (level 4) of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_type_l5

Field descriptionType (level 5) of the product.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.quarter

Field descriptionQuarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
CategorySEGMENT
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.recommendation_type

Field descriptionRecommendation type.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.RecommendationTypeEnum.RecommendationType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.search_engine_results_page_type

Field descriptionType of the search engine results page.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.SearchEngineResultsPageTypeEnum.SearchEngineResultsPageType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.search_term_match_type

Field descriptionMatch type of the keyword that triggered the ad, including variants.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.SearchTermMatchTypeEnum.SearchTermMatchType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With