Google Ads API is returning to beta status. Please read our blog post for more details.

segments

segments.ad_network_type

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

segments.click_type

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

segments.conversion_action

Field descriptionResource name of the conversion action.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.conversion_action_category

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

segments.conversion_action_name

Field descriptionConversion action name.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
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 Type BOOLEAN
Type URLgoogle.protobuf.BoolValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.conversion_attribution_event_type

Field descriptionConversion attribution event type.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v2.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.v2.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.v2.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 Type DATE
Type URLgoogle.protobuf.StringValue
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.v2.enums.DayOfWeekEnum.DayOfWeek
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.device

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

segments.external_conversion_source

Field descriptionExternal conversion source.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v2.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 Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.geo_target_canton

Field descriptionResource name of the geo target constant that represents a canton.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.geo_target_city

Field descriptionResource name of the geo target constant that represents a city.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.geo_target_country

Field descriptionResource name of the geo target constant that represents a country.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.geo_target_county

Field descriptionResource name of the geo target constant that represents a county.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.geo_target_district

Field descriptionResource name of the geo target constant that represents a district.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.geo_target_metro

Field descriptionResource name of the geo target constant that represents a metro.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
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 Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
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 Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.geo_target_province

Field descriptionResource name of the geo target constant that represents a province.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.geo_target_region

Field descriptionResource name of the geo target constant that represents a region.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.geo_target_state

Field descriptionResource name of the geo target constant that represents a state.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_booking_window_days

Field descriptionHotel booking window in days.
CategorySEGMENT
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_center_id

Field descriptionHotel center ID.
CategorySEGMENT
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_check_in_date

Field descriptionHotel check-in date. Formatted as yyyy-MM-dd.
CategorySEGMENT
Data Type DATE
Type URLgoogle.protobuf.StringValue
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.v2.enums.DayOfWeekEnum.DayOfWeek
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_city

Field descriptionHotel city.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_class

Field descriptionHotel class.
CategorySEGMENT
Data Type INT32
Type URLgoogle.protobuf.Int32Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_country

Field descriptionHotel country.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_date_selection_type

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

segments.hotel_length_of_stay

Field descriptionHotel length of stay.
CategorySEGMENT
Data Type INT32
Type URLgoogle.protobuf.Int32Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_rate_rule_id

Field descriptionHotel rate rule ID.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hotel_rate_type

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

segments.hotel_state

Field descriptionHotel state.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.hour

Field descriptionHour of day as a number between 0 and 23, inclusive.
CategorySEGMENT
Data Type INT32
Type URLgoogle.protobuf.Int32Value
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 Type BOOLEAN
Type URLgoogle.protobuf.BoolValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.keyword.ad_group_criterion

Field descriptionThe AdGroupCriterion resource name.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
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.v2.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 Type STRING
Type URLgoogle.protobuf.StringValue
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 Type DATE
Type URLgoogle.protobuf.StringValue
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.v2.enums.MonthOfYearEnum.MonthOfYear
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.partner_hotel_id

Field descriptionPartner hotel ID.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
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.v2.enums.PlaceholderTypeEnum.PlaceholderType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_aggregator_id

Field descriptionAggregator ID of the product.
CategorySEGMENT
Data Type UINT64
Type URLgoogle.protobuf.UInt64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_bidding_category_level1

Field descriptionBidding category (level 1) of the product.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable With

segments.product_bidding_category_level2

Field descriptionBidding category (level 2) of the product.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable With

segments.product_bidding_category_level3

Field descriptionBidding category (level 3) of the product.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable With

segments.product_bidding_category_level4

Field descriptionBidding category (level 4) of the product.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable With

segments.product_bidding_category_level5

Field descriptionBidding category (level 5) of the product.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Selectable With

segments.product_brand

Field descriptionBrand of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_channel

Field descriptionChannel of the product.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v2.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.v2.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_condition

Field descriptionCondition of the product.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v2.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 Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_custom_attribute0

Field descriptionCustom attribute 0 of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_custom_attribute1

Field descriptionCustom attribute 1 of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_custom_attribute2

Field descriptionCustom attribute 2 of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_custom_attribute3

Field descriptionCustom attribute 3 of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_custom_attribute4

Field descriptionCustom attribute 4 of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_item_id

Field descriptionItem ID of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_language

Field descriptionResource name of the language constant for the language of the product.
CategorySEGMENT
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_merchant_id

Field descriptionMerchant ID of the product.
CategorySEGMENT
Data Type UINT64
Type URLgoogle.protobuf.UInt64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_store_id

Field descriptionStore ID of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_title

Field descriptionTitle of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_type_l1

Field descriptionType (level 1) of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_type_l2

Field descriptionType (level 2) of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_type_l3

Field descriptionType (level 3) of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_type_l4

Field descriptionType (level 4) of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

segments.product_type_l5

Field descriptionType (level 5) of the product.
CategorySEGMENT
Data Type STRING
Type URLgoogle.protobuf.StringValue
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 Type DATE
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With