// Copyright 2026 Google LLC

//

// Licensed under the Apache License, Version 2.0 (the "License");

// you may not use this file except in compliance with the License.

// You may obtain a copy of the License at

//

// http://www.apache.org/licenses/LICENSE-2.0

//

// Unless required by applicable law or agreed to in writing, software

// distributed under the License is distributed on an "AS IS" BASIS,

// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

// See the License for the specific language governing permissions and

// limitations under the License.

syntax = "proto3";

package google.ads.googleads.v22.common;

import "google/ads/googleads/v22/common/criteria.proto";

import "google/ads/googleads/v22/enums/ad_destination_type.proto";

import "google/ads/googleads/v22/enums/ad_format_type.proto";

import "google/ads/googleads/v22/enums/ad_network_type.proto";

import "google/ads/googleads/v22/enums/age_range_type.proto";

import "google/ads/googleads/v22/enums/budget_campaign_association_status.proto";

import "google/ads/googleads/v22/enums/click_type.proto";

import "google/ads/googleads/v22/enums/conversion_action_category.proto";

import "google/ads/googleads/v22/enums/conversion_attribution_event_type.proto";

import "google/ads/googleads/v22/enums/conversion_lag_bucket.proto";

import "google/ads/googleads/v22/enums/conversion_or_adjustment_lag_bucket.proto";

import "google/ads/googleads/v22/enums/conversion_value_rule_primary_dimension.proto";

import "google/ads/googleads/v22/enums/converting_user_prior_engagement_type_and_ltv_bucket.proto";

import "google/ads/googleads/v22/enums/day_of_week.proto";

import "google/ads/googleads/v22/enums/device.proto";

import "google/ads/googleads/v22/enums/external_conversion_source.proto";

import "google/ads/googleads/v22/enums/gender_type.proto";

import "google/ads/googleads/v22/enums/hotel_date_selection_type.proto";

import "google/ads/googleads/v22/enums/hotel_price_bucket.proto";

import "google/ads/googleads/v22/enums/hotel_rate_type.proto";

import "google/ads/googleads/v22/enums/landing_page_source.proto";

import "google/ads/googleads/v22/enums/match_type.proto";

import "google/ads/googleads/v22/enums/month_of_year.proto";

import "google/ads/googleads/v22/enums/product_channel.proto";

import "google/ads/googleads/v22/enums/product_channel_exclusivity.proto";

import "google/ads/googleads/v22/enums/product_condition.proto";

import "google/ads/googleads/v22/enums/recommendation_type.proto";

import "google/ads/googleads/v22/enums/search_engine_results_page_type.proto";

import "google/ads/googleads/v22/enums/search_term_match_source.proto";

import "google/ads/googleads/v22/enums/search_term_match_type.proto";

import "google/ads/googleads/v22/enums/search_term_targeting_status.proto";

import "google/ads/googleads/v22/enums/sk_ad_network_ad_event_type.proto";

import "google/ads/googleads/v22/enums/sk_ad_network_attribution_credit.proto";

import "google/ads/googleads/v22/enums/sk_ad_network_coarse_conversion_value.proto";

import "google/ads/googleads/v22/enums/sk_ad_network_source_type.proto";

import "google/ads/googleads/v22/enums/sk_ad_network_user_type.proto";

import "google/ads/googleads/v22/enums/slot.proto";

import "google/api/resource.proto";

option csharp_namespace = "Google.Ads.GoogleAds.V22.Common";

option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v22/common;common";

option java_multiple_files = true;

option java_outer_classname = "SegmentsProto";

option java_package = "com.google.ads.googleads.v22.common";

option objc_class_prefix = "GAA";

option php_namespace = "Google\\Ads\\GoogleAds\\V22\\Common";

option ruby_package = "Google::Ads::GoogleAds::V22::Common";

// Proto file describing segment only fields.

// Segment only fields.

message Segments {

// Activity account ID.

optional int64 activity_account_id = 148;

// The city where the travel activity is available.

optional string activity_city = 185;

// The country where the travel activity is available.

optional string activity_country = 186;

// Activity rating.

optional int64 activity_rating = 149;

// The state where the travel activity is available.

optional string activity_state = 187;

// Advertiser supplied activity ID.

optional string external_activity_id = 150;

// Ad Destination type.

google.ads.googleads.v22.enums.AdDestinationTypeEnum.AdDestinationType

ad_destination_type = 136;

// Ad Format type.

google.ads.googleads.v22.enums.AdFormatTypeEnum.AdFormatType ad_format_type =

191;

// Ad network type.

google.ads.googleads.v22.enums.AdNetworkTypeEnum.AdNetworkType

ad_network_type = 3;

// Resource name of the ad group.

optional string ad_group = 158;

// Resource name of the asset group.

optional string asset_group = 159;

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

optional string auction_insight_domain = 145;

// Budget campaign association status.

BudgetCampaignAssociationStatus budget_campaign_association_status = 134;

// Resource name of the campaign.

optional string campaign = 157;

// Click type.

google.ads.googleads.v22.enums.ClickTypeEnum.ClickType click_type = 26;

// Resource name of the conversion action.

optional string conversion_action = 113 [(google.api.resource_reference) = {

type: "googleads.googleapis.com/ConversionAction"

}];

// Conversion action category.

google.ads.googleads.v22.enums.ConversionActionCategoryEnum

.ConversionActionCategory conversion_action_category = 53;

// Conversion action name.

optional string conversion_action_name = 114;

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

optional bool conversion_adjustment = 115;

// Conversion attribution event type.

google.ads.googleads.v22.enums.ConversionAttributionEventTypeEnum

.ConversionAttributionEventType conversion_attribution_event_type = 2;

// An enum value representing the number of days between the impression and

// the conversion.

google.ads.googleads.v22.enums.ConversionLagBucketEnum.ConversionLagBucket

conversion_lag_bucket = 50;

// An enum value representing the number of days between the impression and

// the conversion or between the impression and adjustments to the conversion.

google.ads.googleads.v22.enums.ConversionOrAdjustmentLagBucketEnum

.ConversionOrAdjustmentLagBucket conversion_or_adjustment_lag_bucket = 51;

// Date to which metrics apply.

// yyyy-MM-dd format, for example, 2018-04-17.

optional string date = 79;

// Day of the week, for example, MONDAY.

google.ads.googleads.v22.enums.DayOfWeekEnum.DayOfWeek day_of_week = 5;

// Device to which metrics apply.

google.ads.googleads.v22.enums.DeviceEnum.Device device = 1;

// External conversion source.

google.ads.googleads.v22.enums.ExternalConversionSourceEnum

.ExternalConversionSource external_conversion_source = 55;

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

optional string geo_target_airport = 116;

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

optional string geo_target_canton = 117;

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

optional string geo_target_city = 118;

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

optional string geo_target_country = 119;

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

optional string geo_target_county = 120;

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

optional string geo_target_district = 121;

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

optional string geo_target_metro = 122;

// Resource name of the geo target constant that represents the most

// specific location.

optional string geo_target_most_specific_location = 123;

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

optional string geo_target_postal_code = 124;

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

optional string geo_target_province = 125;

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

optional string geo_target_region = 126;

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

optional string geo_target_state = 127;

// Hotel booking window in days.

optional int64 hotel_booking_window_days = 135;

// Hotel center ID.

optional int64 hotel_center_id = 80;

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

optional string hotel_check_in_date = 81;

// Hotel check-in day of week.

google.ads.googleads.v22.enums.DayOfWeekEnum.DayOfWeek

hotel_check_in_day_of_week = 9;

// Hotel city.

optional string hotel_city = 82;

// Hotel class.

optional int32 hotel_class = 83;

// Hotel country.

optional string hotel_country = 84;

// Hotel date selection type.

google.ads.googleads.v22.enums.HotelDateSelectionTypeEnum

.HotelDateSelectionType hotel_date_selection_type = 13;

// Hotel length of stay.

optional int32 hotel_length_of_stay = 85;

// Hotel rate rule ID.

optional string hotel_rate_rule_id = 86;

// Hotel rate type.

google.ads.googleads.v22.enums.HotelRateTypeEnum.HotelRateType

hotel_rate_type = 74;

// Hotel price bucket.

google.ads.googleads.v22.enums.HotelPriceBucketEnum.HotelPriceBucket

hotel_price_bucket = 78;

// Hotel state.

optional string hotel_state = 87;

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

optional int32 hour = 88;

// Only used with feed item metrics.

// Indicates whether the interaction metrics occurred on the feed item itself

// or a different extension or ad unit.

optional bool interaction_on_this_extension = 89;

// Keyword criterion.

Keyword keyword = 61;

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

google.ads.googleads.v22.enums.LandingPageSourceEnum.LandingPageSource

landing_page_source = 200;

// Month as represented by the date of the first day of a month. Formatted as

// yyyy-MM-dd.

optional string month = 90;

// Month of the year, for example, January.

google.ads.googleads.v22.enums.MonthOfYearEnum.MonthOfYear month_of_year = 18;

// Partner hotel ID.

optional string partner_hotel_id = 91;

// Aggregator ID of the product.

optional int64 product_aggregator_id = 132;

// Category (level 1) of the product.

optional string product_category_level1 = 161;

// Category (level 2) of the product.

optional string product_category_level2 = 162;

// Category (level 3) of the product.

optional string product_category_level3 = 163;

// Category (level 4) of the product.

optional string product_category_level4 = 164;

// Category (level 5) of the product.

optional string product_category_level5 = 165;

// Brand of the product.

optional string product_brand = 97;

// Channel of the product.

google.ads.googleads.v22.enums.ProductChannelEnum.ProductChannel

product_channel = 30;

// Channel exclusivity of the product.

google.ads.googleads.v22.enums.ProductChannelExclusivityEnum

.ProductChannelExclusivity product_channel_exclusivity = 31;

// Condition of the product.

google.ads.googleads.v22.enums.ProductConditionEnum.ProductCondition

product_condition = 32;

// Resource name of the geo target constant for the country of sale of the

// product.

optional string product_country = 98;

// Custom attribute 0 of the product.

optional string product_custom_attribute0 = 99;

// Custom attribute 1 of the product.

optional string product_custom_attribute1 = 100;

// Custom attribute 2 of the product.

optional string product_custom_attribute2 = 101;

// Custom attribute 3 of the product.

optional string product_custom_attribute3 = 102;

// Custom attribute 4 of the product.

optional string product_custom_attribute4 = 103;

// Feed label of the product.

optional string product_feed_label = 147;

// Item ID of the product.

optional string product_item_id = 104;

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

optional string product_language = 105;

// Merchant ID of the product.

optional int64 product_merchant_id = 133;

// Store ID of the product.

optional string product_store_id = 106;

// Title of the product.

optional string product_title = 107;

// Type (level 1) of the product.

optional string product_type_l1 = 108;

// Type (level 2) of the product.

optional string product_type_l2 = 109;

// Type (level 3) of the product.

optional string product_type_l3 = 110;

// Type (level 4) of the product.

optional string product_type_l4 = 111;

// Type (level 5) of the product.

optional string product_type_l5 = 112;

// Quarter as represented by the date of the first day of a quarter.

// Uses the calendar year for quarters, for example, the second quarter of

// 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.

optional string quarter = 128;

// The city the user is searching for at query time.

optional string travel_destination_city = 193;

// The country the user is searching for at query time.

optional string travel_destination_country = 194;

// The region the user is searching for at query time.

optional string travel_destination_region = 195;

// Recommendation type.

google.ads.googleads.v22.enums.RecommendationTypeEnum.RecommendationType

recommendation_type = 140;

// Type of the search engine results page.

google.ads.googleads.v22.enums.SearchEngineResultsPageTypeEnum

.SearchEngineResultsPageType search_engine_results_page_type = 70;

// A search term subcategory. An empty string denotes the catch-all

// subcategory for search terms that didn't fit into another subcategory.

optional string search_subcategory = 155;

// A search term.

optional string search_term = 156;

// Match type of the keyword that triggered the ad. This segment is for use

// with keyword_view. For other resources, use match_type. While match_type is

// filtered to Broad, Exact, Phrase and Ai Max, search_term_match_type

// includes variants like Near Exact and Near Phrase.

google.ads.googleads.v22.enums.SearchTermMatchTypeEnum.SearchTermMatchType

search_term_match_type = 22;

// The match type of the keyword that triggered the ad. This segment is for

// use with keyword_view. For other resources, use search_term_match_type.

// While match_type is filtered to Broad, Exact, Phrase and Ai Max,

// search_term_match_type includes variants like Near Exact, Near Phrase.

google.ads.googleads.v22.enums.MatchTypeEnum.MatchType match_type = 199;

// Position of the ad.

google.ads.googleads.v22.enums.SlotEnum.Slot slot = 23;

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

google.ads.googleads.v22.enums.ConversionValueRulePrimaryDimensionEnum

.ConversionValueRulePrimaryDimension

conversion_value_rule_primary_dimension = 138;

// Resource name of the ad group criterion that represents webpage criterion.

optional string webpage = 129;

// Week as defined as Monday through Sunday, and represented by the date of

// Monday. Formatted as yyyy-MM-dd.

optional string week = 130;

// Year, formatted as yyyy.

optional int32 year = 131;

// iOS Store Kit Ad Network conversion value.

// Null value means this segment is not applicable, for example, non-iOS

// campaign.

optional int64 sk_ad_network_fine_conversion_value = 137;

// iOS Store Kit Ad Network redistributed fine conversion value.

//

// Google uses modeling on observed conversion values(obtained

// from Apple) to calculate conversions from SKAN postbacks where

// NULLs are returned. This column represents the sum of the modeled

// conversion values and the observed conversion values. See

// https://support.google.com/google-ads/answer/14892597

// to lean more.

optional int64 sk_ad_network_redistributed_fine_conversion_value = 190;

// iOS Store Kit Ad Network user type.

google.ads.googleads.v22.enums.SkAdNetworkUserTypeEnum.SkAdNetworkUserType

sk_ad_network_user_type = 141;

// iOS Store Kit Ad Network ad event type.

google.ads.googleads.v22.enums.SkAdNetworkAdEventTypeEnum

.SkAdNetworkAdEventType sk_ad_network_ad_event_type = 142;

// App where the ad that drove the iOS Store Kit Ad Network install was

// shown. Null value means this segment is not applicable, for example,

// non-iOS campaign, or was not present in any postbacks sent by Apple.

optional SkAdNetworkSourceApp sk_ad_network_source_app = 143;

// iOS Store Kit Ad Network attribution credit

google.ads.googleads.v22.enums.SkAdNetworkAttributionCreditEnum

.SkAdNetworkAttributionCredit sk_ad_network_attribution_credit = 144;

// iOS Store Kit Ad Network coarse conversion value.

google.ads.googleads.v22.enums.SkAdNetworkCoarseConversionValueEnum

.SkAdNetworkCoarseConversionValue sk_ad_network_coarse_conversion_value =

151;

// Website where the ad that drove the iOS Store Kit Ad Network install was

// shown. Null value means this segment is not applicable, for example,

// non-iOS campaign, or was not present in any postbacks sent by Apple.

optional string sk_ad_network_source_domain = 152;

// The source type where the ad that drove the iOS Store Kit Ad Network

// install was shown. Null value means this segment is not applicable, for

// example, non-iOS campaign, or neither source domain nor source app were

// present in any postbacks sent by Apple.

google.ads.googleads.v22.enums.SkAdNetworkSourceTypeEnum.SkAdNetworkSourceType

sk_ad_network_source_type = 153;

// iOS Store Kit Ad Network postback sequence index.

optional int64 sk_ad_network_postback_sequence_index = 154;

// The version of the SKAdNetwork API used.

optional string sk_ad_network_version = 192;

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

// Interactions (for example, clicks) are counted across all the parts of the

// served ad (for example, Ad itself and other components like Sitelinks) when

// they are served together. When interaction_on_this_asset is true, it means

// the interactions are on this specific asset and when

// interaction_on_this_asset is false, it means the interactions is not on

// this specific asset but on other parts of the served ad this asset is

// served with.

optional AssetInteractionTarget asset_interaction_target = 139;

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

google.ads.googleads.v22.enums

.ConvertingUserPriorEngagementTypeAndLtvBucketEnum

.ConvertingUserPriorEngagementTypeAndLtvBucket

new_versus_returning_customers = 160;

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

google.ads.googleads.v22.enums.AgeRangeTypeEnum.AgeRangeType

adjusted_age_range = 196;

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

google.ads.googleads.v22.enums.GenderTypeEnum.GenderType adjusted_gender =

197;

// Specifies the source for how the search term was matched, which reveals the

// type of ad campaign responsible. Use this to distinguish between automated

// campaigns (like AI Max, Dynamic Search Ads) and keyword-based campaigns

// (Standard).

google.ads.googleads.v22.enums.SearchTermMatchSourceEnum.SearchTermMatchSource

search_term_match_source = 198;

// Indicates whether the search term is currently one of your targeted or

// excluded keywords.

google.ads.googleads.v22.enums.SearchTermTargetingStatusEnum

.SearchTermTargetingStatus search_term_targeting_status = 201;

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

optional bool ad_using_product_data = 202;

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

optional bool ad_using_video = 203;

}

// A Keyword criterion segment.

message Keyword {

// The AdGroupCriterion resource name.

optional string ad_group_criterion = 3;

// Keyword info.

KeywordInfo info = 2;

}

// A BudgetCampaignAssociationStatus segment.

message BudgetCampaignAssociationStatus {

// The campaign resource name.

optional string campaign = 1;

// Budget campaign association status.

google.ads.googleads.v22.enums.BudgetCampaignAssociationStatusEnum

.BudgetCampaignAssociationStatus status = 2;

}

// An AssetInteractionTarget segment.

message AssetInteractionTarget {

// The asset resource name.

string asset = 1;

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

bool interaction_on_this_asset = 2;

}

// A SkAdNetworkSourceApp segment.

message SkAdNetworkSourceApp {

// App id where the ad that drove the iOS Store Kit Ad Network install was

// shown.

optional string sk_ad_network_source_app_id = 1;

}