The new Search Ads 360 Reporting API is now available. Join thesearchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.

segments

segments.ad_network_type

Field descriptionAd network type.
CategorySEGMENT
Data Type

ENUM

CONTENT
MIXED
SEARCH
SEARCH_PARTNERS
UNKNOWN
UNSPECIFIED
YOUTUBE_SEARCH
YOUTUBE_WATCH
Type URLgoogle.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

The following fields/resources can be selected with this segment:

segments.asset_interaction_target.asset

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

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

segments.conversion_action

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

The following fields/resources can be selected with this segment:

segments.conversion_action_category

Field descriptionConversion action category.
CategorySEGMENT
Data Type

ENUM

ADD_TO_CART
BEGIN_CHECKOUT
BOOK_APPOINTMENT
CONTACT
CONVERTED_LEAD
DEFAULT
DOWNLOAD
ENGAGEMENT
GET_DIRECTIONS
IMPORTED_LEAD
LEAD
OUTBOUND_CLICK
PAGE_VIEW
PHONE_CALL_LEAD
PURCHASE
QUALIFIED_LEAD
REQUEST_QUOTE
SIGNUP
STORE_SALE
STORE_VISIT
SUBMIT_LEAD_FORM
SUBSCRIBE_PAID
UNKNOWN
UNSPECIFIED
Type URLgoogle.ads.searchads360.v0.enums.ConversionActionCategoryEnum.ConversionActionCategory
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

The following fields/resources can be selected with this segment:

segments.conversion_action_name

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

The following fields/resources can be selected with this segment:

segments.date

Field descriptionDate 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

The following fields/resources can be selected with this segment:

segments.day_of_week

Field descriptionDay of the week, for example, MONDAY.
CategorySEGMENT
Data Type

ENUM

FRIDAY
MONDAY
SATURDAY
SUNDAY
THURSDAY
TUESDAY
UNKNOWN
UNSPECIFIED
WEDNESDAY
Type URLgoogle.ads.searchads360.v0.enums.DayOfWeekEnum.DayOfWeek
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

The following fields/resources can be selected with this segment:

segments.device

Field descriptionDevice to which metrics apply.
CategorySEGMENT
Data Type

ENUM

CONNECTED_TV
DESKTOP
MOBILE
OTHER
TABLET
UNKNOWN
UNSPECIFIED
Type URLgoogle.ads.searchads360.v0.enums.DeviceEnum.Device
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

segments.keyword.ad_group_criterion

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

The following fields/resources can be selected with this segment:

segments.keyword.info.match_type

Field descriptionThe match type of the keyword.
CategorySEGMENT
Data Type

ENUM

BROAD
EXACT
PHRASE
UNKNOWN
UNSPECIFIED
Type URLgoogle.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

segments.product_brand

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

The following fields/resources can be selected with this segment:

segments.product_channel

Field descriptionChannel of the product.
CategorySEGMENT
Data Type

ENUM

LOCAL
ONLINE
UNKNOWN
UNSPECIFIED
Type URLgoogle.ads.searchads360.v0.enums.ProductChannelEnum.ProductChannel
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

The following fields/resources can be selected with this segment:

segments.product_channel_exclusivity

Field descriptionChannel exclusivity of the product.
CategorySEGMENT
Data Type

ENUM

MULTI_CHANNEL
SINGLE_CHANNEL
UNKNOWN
UNSPECIFIED
Type URLgoogle.ads.searchads360.v0.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

The following fields/resources can be selected with this segment:

segments.product_condition

Field descriptionCondition of the product.
CategorySEGMENT
Data Type

ENUM

NEW
OLD
REFURBISHED
UNKNOWN
UNSPECIFIED
USED
Type URLgoogle.ads.searchads360.v0.enums.ProductConditionEnum.ProductCondition
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

segments.product_custom_attribute0

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

The following fields/resources can be selected with this segment:

segments.product_custom_attribute1

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

The following fields/resources can be selected with this segment:

segments.product_custom_attribute2

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

The following fields/resources can be selected with this segment:

segments.product_custom_attribute3

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

The following fields/resources can be selected with this segment:

segments.product_custom_attribute4

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

The following fields/resources can be selected with this segment:

segments.product_item_id

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

The following fields/resources can be selected with this segment:

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

The following fields/resources can be selected with this segment:

segments.product_sold_bidding_category_level1

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

The following fields/resources can be selected with this segment:

segments.product_sold_bidding_category_level2

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

The following fields/resources can be selected with this segment:

segments.product_sold_bidding_category_level3

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

The following fields/resources can be selected with this segment:

segments.product_sold_bidding_category_level4

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

The following fields/resources can be selected with this segment:

segments.product_sold_bidding_category_level5

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

The following fields/resources can be selected with this segment:

segments.product_sold_brand

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

The following fields/resources can be selected with this segment:

segments.product_sold_condition

Field descriptionCondition of the product sold.
CategorySEGMENT
Data Type

ENUM

NEW
OLD
REFURBISHED
UNKNOWN
UNSPECIFIED
USED
Type URLgoogle.ads.searchads360.v0.enums.ProductConditionEnum.ProductCondition
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

The following fields/resources can be selected with this segment:

segments.product_sold_custom_attribute0

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

The following fields/resources can be selected with this segment:

segments.product_sold_custom_attribute1

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

The following fields/resources can be selected with this segment:

segments.product_sold_custom_attribute2

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

The following fields/resources can be selected with this segment:

segments.product_sold_custom_attribute3

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

The following fields/resources can be selected with this segment:

segments.product_sold_custom_attribute4

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

The following fields/resources can be selected with this segment:

segments.product_sold_item_id

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

The following fields/resources can be selected with this segment:

segments.product_sold_title

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

The following fields/resources can be selected with this segment:

segments.product_sold_type_l1

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

The following fields/resources can be selected with this segment:

segments.product_sold_type_l2

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

The following fields/resources can be selected with this segment:

segments.product_sold_type_l3

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

The following fields/resources can be selected with this segment:

segments.product_sold_type_l4

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

The following fields/resources can be selected with this segment:

segments.product_sold_type_l5

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

The following fields/resources can be selected with this segment:

segments.product_store_id

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

The following fields/resources can be selected with this segment:

segments.product_title

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

The following fields/resources can be selected with this segment:

segments.product_type_l1

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

The following fields/resources can be selected with this segment:

segments.product_type_l2

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

The following fields/resources can be selected with this segment:

segments.product_type_l3

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

The following fields/resources can be selected with this segment:

segments.product_type_l4

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

The following fields/resources can be selected with this segment:

segments.product_type_l5

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

The following fields/resources can be selected with this segment:

segments.quarter

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

The following fields/resources can be selected with this segment:

segments.week

Field descriptionWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
CategorySEGMENT
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

The following fields/resources can be selected with this segment:

segments.year

Field descriptionYear, formatted as yyyy.
CategorySEGMENT
Data TypeINT32
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

The following fields/resources can be selected with this segment:

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-05 UTC.