ad_group.ad_rotation_mode |
Field description | The ad rotation mode of the ad group. |
Category | ATTRIBUTE |
Data Type |
ENUM
OPTIMIZE ROTATE_FOREVER UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.AdGroupAdRotationModeEnum.AdGroupAdRotationMode |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.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. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.base_ad_group |
Field description | Output only. For draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null. For base ad groups, this field equals the ad group resource name. This field is read-only. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.campaign |
Field description | Immutable. The campaign to which the ad group belongs. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group.cpc_bid_micros |
Field description | The maximum CPC (cost-per-click) bid. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.cpm_bid_micros |
Field description | The maximum CPM (cost-per-thousand viewable impressions) bid. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.cpv_bid_micros |
Field description | The CPV (cost-per-view) bid. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.display_custom_bid_dimension |
Field description | Allows advertisers to specify a targeting dimension on which to place absolute bids. This is only applicable for campaigns that target only the display network and not search. |
Category | ATTRIBUTE |
Data Type |
ENUM
AGE_RANGE AUDIENCE GENDER INCOME_RANGE KEYWORD PARENTAL_STATUS PLACEMENT TOPIC UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.TargetingDimensionEnum.TargetingDimension |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.effective_cpc_bid_micros |
Field description | Output only. Value will be same as that of the CPC (cost-per-click) bid value when the bidding strategy is one of manual cpc, enhanced cpc, page one promoted or target outrank share, otherwise the value will be null. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.effective_target_cpa_micros |
Field description | Output only. The effective target CPA (cost-per-acquisition). This field is read-only. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.effective_target_cpa_source |
Field description | Output only. Source of the effective target CPA. This field is read-only. |
Category | ATTRIBUTE |
Data Type |
ENUM
AD_GROUP AD_GROUP_CRITERION CAMPAIGN_BIDDING_STRATEGY UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.BiddingSourceEnum.BiddingSource |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.effective_target_roas |
Field description | Output only. The effective target ROAS (return-on-ad-spend). This field is read-only. |
Category | ATTRIBUTE |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.effective_target_roas_source |
Field description | Output only. Source of the effective target ROAS. This field is read-only. |
Category | ATTRIBUTE |
Data Type |
ENUM
AD_GROUP AD_GROUP_CRITERION CAMPAIGN_BIDDING_STRATEGY UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.BiddingSourceEnum.BiddingSource |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.exclude_demographic_expansion |
Field description | When this value is true, demographics will be excluded from the types of targeting which are expanded when optimized_targeting_enabled is true. When optimized_targeting_enabled is false, this field is ignored. Default is false. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.excluded_parent_asset_field_types |
Field description | The asset field types that should be excluded from this ad group. Asset links with these field types will not be inherited by this ad group from the upper levels. |
Category | ATTRIBUTE |
Data Type |
ENUM
AD_IMAGE BOOK_ON_GOOGLE BUSINESS_LOGO BUSINESS_NAME CALL CALLOUT CALL_TO_ACTION_SELECTION DEMAND_GEN_CAROUSEL_CARD DESCRIPTION HEADLINE HOTEL_CALLOUT HOTEL_PROPERTY LANDSCAPE_LOGO LEAD_FORM LOGO LONG_HEADLINE MANDATORY_AD_TEXT MARKETING_IMAGE MEDIA_BUNDLE MOBILE_APP PORTRAIT_MARKETING_IMAGE PRICE PROMOTION SITELINK SQUARE_MARKETING_IMAGE STRUCTURED_SNIPPET UNKNOWN UNSPECIFIED VIDEO YOUTUBE_VIDEO
|
Type URL | google.ads.googleads.v18.enums.AssetFieldTypeEnum.AssetFieldType |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group.excluded_parent_asset_set_types |
Field description | The asset set types that should be excluded from this ad group. Asset set links with these types will not be inherited by this ad group from the upper levels. 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 ad group, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this ad group. Only LOCATION_SYNC is currently supported. |
Category | ATTRIBUTE |
Data Type |
ENUM
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP CHAIN_DYNAMIC_LOCATION_GROUP DYNAMIC_CUSTOM DYNAMIC_EDUCATION DYNAMIC_FLIGHTS DYNAMIC_HOTELS_AND_RENTALS DYNAMIC_JOBS DYNAMIC_LOCAL DYNAMIC_REAL_ESTATE DYNAMIC_TRAVEL HOTEL_PROPERTY LOCATION_SYNC MERCHANT_CENTER_FEED PAGE_FEED STATIC_LOCATION_GROUP TRAVEL_FEED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.AssetSetTypeEnum.AssetSetType |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group.final_url_suffix |
Field description | URL template for appending params to Final URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.fixed_cpm_micros |
Field description | The fixed amount in micros that the advertiser pays for every thousand impressions of the ad. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.id |
Field description | Output only. The ID of the ad group. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.labels |
Field description | Output only. The resource names of labels attached to this ad group. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group.name |
Field description | The name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.optimized_targeting_enabled |
Field description | True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.percent_cpc_bid_micros |
Field description | The percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction]. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.primary_status |
Field description | Output only. Provides aggregated view into why an ad group is not serving or not serving optimally. |
Category | ATTRIBUTE |
Data Type |
ENUM
ELIGIBLE LIMITED NOT_ELIGIBLE PAUSED PENDING REMOVED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.AdGroupPrimaryStatusEnum.AdGroupPrimaryStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.primary_status_reasons |
Field description | Output only. Provides reasons for why an ad group is not serving or not serving optimally. |
Category | ATTRIBUTE |
Data Type |
ENUM
AD_GROUP_ADS_PAUSED AD_GROUP_INCOMPLETE AD_GROUP_PAUSED AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY AD_GROUP_REMOVED CAMPAIGN_DRAFT CAMPAIGN_ENDED CAMPAIGN_PAUSED CAMPAIGN_PENDING CAMPAIGN_REMOVED HAS_ADS_DISAPPROVED HAS_ADS_LIMITED_BY_POLICY KEYWORDS_PAUSED MOST_ADS_UNDER_REVIEW NO_AD_GROUP_ADS NO_KEYWORDS UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.AdGroupPrimaryStatusReasonEnum.AdGroupPrimaryStatusReason |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group.resource_name |
Field description | Immutable. The resource name of the ad group. Ad group resource names have the form: customers/{customer_id}/adGroups/{ad_group_id} |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
ad_group.status |
Field description | The status of the ad group. |
Category | ATTRIBUTE |
Data Type |
ENUM
ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.AdGroupStatusEnum.AdGroupStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.target_cpa_micros |
Field description | The target CPA (cost-per-acquisition). If the ad group's campaign bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa field set), then this field overrides the target CPA specified in the campaign's bidding strategy. Otherwise, this value is ignored. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.target_cpm_micros |
Field description | Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.target_cpv_micros |
Field description | Average amount in micros that the advertiser is willing to pay for every ad view. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.target_roas |
Field description | The target ROAS (return-on-ad-spend) override. If the ad group's campaign bidding strategy is TargetRoas or MaximizeConversionValue (with its target_roas field set), then this field overrides the target ROAS specified in the campaign's bidding strategy. Otherwise, this value is ignored. |
Category | ATTRIBUTE |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.targeting_setting.target_restrictions |
Field description | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.TargetRestriction |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
ad_group.tracking_url_template |
Field description | The URL template for constructing a tracking URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.type |
Field description | Immutable. The type of the ad group. |
Category | ATTRIBUTE |
Data Type |
ENUM
DISPLAY_STANDARD HOTEL_ADS PROMOTED_HOTEL_ADS SEARCH_DYNAMIC_ADS SEARCH_STANDARD SHOPPING_COMPARISON_LISTING_ADS SHOPPING_PRODUCT_ADS SHOPPING_SMART_ADS SMART_CAMPAIGN_ADS TRAVEL_ADS UNKNOWN UNSPECIFIED VIDEO_BUMPER VIDEO_EFFICIENT_REACH VIDEO_NON_SKIPPABLE_IN_STREAM VIDEO_OUTSTREAM VIDEO_RESPONSIVE VIDEO_TRUE_VIEW_IN_DISPLAY VIDEO_TRUE_VIEW_IN_STREAM
|
Type URL | google.ads.googleads.v18.enums.AdGroupTypeEnum.AdGroupType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
ad_group.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 . |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v18.common.CustomParameter |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
segments.activity_account_id |
Field description | Activity account ID. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.activity_city |
Field description | The city where the travel activity is available. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.activity_country |
Field description | The country where the travel activity is available. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.activity_rating |
Field description | Activity rating. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.activity_state |
Field description | The state where the travel activity is available. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.ad_destination_type |
Field description | Ad Destination type. |
Category | SEGMENT |
Data Type |
ENUM
APP_DEEP_LINK APP_STORE LEAD_FORM LOCATION_LISTING MAP_DIRECTIONS MESSAGE NOT_APPLICABLE PHONE_CALL UNKNOWN UNMODELED_FOR_CONVERSIONS UNSPECIFIED WEBSITE YOUTUBE
|
Type URL | google.ads.googleads.v18.enums.AdDestinationTypeEnum.AdDestinationType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Ad Format type. |
Category | SEGMENT |
Data Type |
ENUM
AUDIO BUMPER INFEED INSTREAM_NON_SKIPPABLE INSTREAM_SKIPPABLE MASTHEAD OTHER OUTSTREAM SHORTS UNKNOWN UNSEGMENTED UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.AdFormatTypeEnum.AdFormatType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.ad_network_type |
Field description | Ad network type. |
Category | SEGMENT |
Data Type |
ENUM
CONTENT GOOGLE_OWNED_CHANNELS GOOGLE_TV MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE
|
Type URL | google.ads.googleads.v18.enums.AdNetworkTypeEnum.AdNetworkType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.asset_interaction_target.asset |
Field description | The asset resource name. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
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. |
Category | SEGMENT |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.auction_insight_domain |
Field description | Domain (visible URL) of a participant in the Auction Insights report. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | False |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.click_type |
Field description | Click type. |
Category | SEGMENT |
Data Type |
ENUM
AD_IMAGE APP_DEEPLINK BREADCRUMBS BROADBAND_PLAN CALLS CALL_TRACKING CLICK_ON_ENGAGEMENT_AD CROSS_NETWORK GET_DIRECTIONS HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION HOTEL_PRICE LOCATION_EXPANSION LOCATION_FORMAT_CALL LOCATION_FORMAT_DIRECTIONS LOCATION_FORMAT_IMAGE LOCATION_FORMAT_LANDING_PAGE LOCATION_FORMAT_MAP LOCATION_FORMAT_STORE_INFO LOCATION_FORMAT_TEXT MOBILE_CALL_TRACKING OFFER_PRINTS OTHER PRICE_EXTENSION PRODUCT_AD_APP_DEEPLINK PRODUCT_EXTENSION_CLICKS PRODUCT_LISTING_ADS_COUPON PRODUCT_LISTING_AD_CLICKS PRODUCT_LISTING_AD_LOCAL PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE PRODUCT_LISTING_AD_TRANSACTABLE PROMOTION_EXTENSION SHOPPING_COMPARISON_LISTING SHOWCASE_AD_CATEGORY_LINK SHOWCASE_AD_LOCAL_PRODUCT_LINK SHOWCASE_AD_LOCAL_STOREFRONT_LINK SHOWCASE_AD_ONLINE_PRODUCT_LINK SITELINKS STORE_LOCATOR SWIPEABLE_GALLERY_AD_HEADLINE SWIPEABLE_GALLERY_AD_SEE_MORE SWIPEABLE_GALLERY_AD_SITELINK_FIVE SWIPEABLE_GALLERY_AD_SITELINK_FOUR SWIPEABLE_GALLERY_AD_SITELINK_ONE SWIPEABLE_GALLERY_AD_SITELINK_THREE SWIPEABLE_GALLERY_AD_SITELINK_TWO SWIPEABLE_GALLERY_AD_SWIPES TRAVEL_ASSETS UNKNOWN UNSPECIFIED URL_CLICKS VIDEO_APP_STORE_CLICKS VIDEO_CALL_TO_ACTION_CLICKS VIDEO_CARD_ACTION_HEADLINE_CLICKS VIDEO_END_CAP_CLICKS VIDEO_WEBSITE_CLICKS VISUAL_SITELINKS WIRELESS_PLAN
|
Type URL | google.ads.googleads.v18.enums.ClickTypeEnum.ClickType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_action |
Field description | Resource name of the conversion action. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_action_category |
Field description | Conversion action category. |
Category | SEGMENT |
Data Type |
ENUM
ADD_TO_CART BEGIN_CHECKOUT BOOK_APPOINTMENT CONTACT CONVERTED_LEAD DEFAULT DOWNLOAD ENGAGEMENT GET_DIRECTIONS IMPORTED_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 URL | google.ads.googleads.v18.enums.ConversionActionCategoryEnum.ConversionActionCategory |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_action_name |
Field description | Conversion action name. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
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. |
Category | SEGMENT |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_attribution_event_type |
Field description | Conversion attribution event type. |
Category | SEGMENT |
Data Type |
ENUM
IMPRESSION INTERACTION UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.ConversionAttributionEventTypeEnum.ConversionAttributionEventType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_lag_bucket |
Field description | An enum value representing the number of days between the impression and the conversion. |
Category | SEGMENT |
Data Type |
ENUM
EIGHT_TO_NINE_DAYS ELEVEN_TO_TWELVE_DAYS FIVE_TO_SIX_DAYS FORTY_FIVE_TO_SIXTY_DAYS FOURTEEN_TO_TWENTY_ONE_DAYS FOUR_TO_FIVE_DAYS LESS_THAN_ONE_DAY NINE_TO_TEN_DAYS ONE_TO_TWO_DAYS SEVEN_TO_EIGHT_DAYS SIXTY_TO_NINETY_DAYS SIX_TO_SEVEN_DAYS TEN_TO_ELEVEN_DAYS THIRTEEN_TO_FOURTEEN_DAYS THIRTY_TO_FORTY_FIVE_DAYS THREE_TO_FOUR_DAYS TWELVE_TO_THIRTEEN_DAYS TWENTY_ONE_TO_THIRTY_DAYS TWO_TO_THREE_DAYS UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.ConversionLagBucketEnum.ConversionLagBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
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. |
Category | SEGMENT |
Data Type |
ENUM
ADJUSTMENT_EIGHT_TO_NINE_DAYS ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS ADJUSTMENT_FIVE_TO_SIX_DAYS ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS ADJUSTMENT_FOUR_TO_FIVE_DAYS ADJUSTMENT_LESS_THAN_ONE_DAY ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS ADJUSTMENT_NINE_TO_TEN_DAYS ADJUSTMENT_ONE_TO_TWO_DAYS ADJUSTMENT_SEVEN_TO_EIGHT_DAYS ADJUSTMENT_SIXTY_TO_NINETY_DAYS ADJUSTMENT_SIX_TO_SEVEN_DAYS ADJUSTMENT_TEN_TO_ELEVEN_DAYS ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS ADJUSTMENT_THREE_TO_FOUR_DAYS ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS ADJUSTMENT_TWO_TO_THREE_DAYS ADJUSTMENT_UNKNOWN CONVERSION_EIGHT_TO_NINE_DAYS CONVERSION_ELEVEN_TO_TWELVE_DAYS CONVERSION_FIVE_TO_SIX_DAYS CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS CONVERSION_FOUR_TO_FIVE_DAYS CONVERSION_LESS_THAN_ONE_DAY CONVERSION_NINE_TO_TEN_DAYS CONVERSION_ONE_TO_TWO_DAYS CONVERSION_SEVEN_TO_EIGHT_DAYS CONVERSION_SIXTY_TO_NINETY_DAYS CONVERSION_SIX_TO_SEVEN_DAYS CONVERSION_TEN_TO_ELEVEN_DAYS CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS CONVERSION_THREE_TO_FOUR_DAYS CONVERSION_TWELVE_TO_THIRTEEN_DAYS CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS CONVERSION_TWO_TO_THREE_DAYS CONVERSION_UNKNOWN UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.ConversionOrAdjustmentLagBucketEnum.ConversionOrAdjustmentLagBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.date |
Field description | Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.day_of_week |
Field description | Day of the week, for example, MONDAY. |
Category | SEGMENT |
Data Type |
ENUM
FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY
|
Type URL | google.ads.googleads.v18.enums.DayOfWeekEnum.DayOfWeek |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.device |
Field description | Device to which metrics apply. |
Category | SEGMENT |
Data Type |
ENUM
CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.DeviceEnum.Device |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.external_activity_id |
Field description | Advertiser supplied activity ID. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.external_conversion_source |
Field description | External conversion source. |
Category | SEGMENT |
Data Type |
ENUM
AD_CALL_METRICS ANALYTICS ANALYTICS_SEARCH_ADS_360 ANDROID_FIRST_OPEN ANDROID_IN_APP APP_UNSPECIFIED CLICK_TO_CALL DISPLAY_AND_VIDEO_360_FLOODLIGHT FIREBASE FIREBASE_SEARCH_ADS_360 FLOODLIGHT GOOGLE_ATTRIBUTION GOOGLE_HOSTED GOOGLE_PLAY IOS_FIRST_OPEN IOS_IN_APP SALESFORCE SEARCH_ADS_360 STORE_SALES STORE_SALES_CRM STORE_SALES_DIRECT_UPLOAD STORE_SALES_PAYMENT_NETWORK STORE_VISITS THIRD_PARTY_APP_ANALYTICS UNKNOWN UNSPECIFIED UPLOAD UPLOAD_CALLS WEBPAGE WEBSITE_CALL_METRICS
|
Type URL | google.ads.googleads.v18.enums.ExternalConversionSourceEnum.ExternalConversionSource |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_airport |
Field description | Resource name of the geo target constant that represents an airport. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_canton |
Field description | Resource name of the geo target constant that represents a canton. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_city |
Field description | Resource name of the geo target constant that represents a city. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_country |
Field description | Resource name of the geo target constant that represents a country. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_county |
Field description | Resource name of the geo target constant that represents a county. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_district |
Field description | Resource name of the geo target constant that represents a district. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_metro |
Field description | Resource name of the geo target constant that represents a metro. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_most_specific_location |
Field description | Resource name of the geo target constant that represents the most specific location. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_postal_code |
Field description | Resource name of the geo target constant that represents a postal code. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_province |
Field description | Resource name of the geo target constant that represents a province. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_region |
Field description | Resource name of the geo target constant that represents a region. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_state |
Field description | Resource name of the geo target constant that represents a state. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_booking_window_days |
Field description | Hotel booking window in days. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_center_id |
Field description | Hotel center ID. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_check_in_date |
Field description | Hotel check-in date. Formatted as yyyy-MM-dd. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_check_in_day_of_week |
Field description | Hotel check-in day of week. |
Category | SEGMENT |
Data Type |
ENUM
FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY
|
Type URL | google.ads.googleads.v18.enums.DayOfWeekEnum.DayOfWeek |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_city |
Field description | Hotel city. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_class |
Field description | Hotel class. |
Category | SEGMENT |
Data Type | INT32 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_country |
Field description | Hotel country. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_date_selection_type |
Field description | Hotel date selection type. |
Category | SEGMENT |
Data Type |
ENUM
DEFAULT_SELECTION UNKNOWN UNSPECIFIED USER_SELECTED
|
Type URL | google.ads.googleads.v18.enums.HotelDateSelectionTypeEnum.HotelDateSelectionType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_length_of_stay |
Field description | Hotel length of stay. |
Category | SEGMENT |
Data Type | INT32 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_price_bucket |
Field description | Hotel price bucket. |
Category | SEGMENT |
Data Type |
ENUM
LOWEST_TIED LOWEST_UNIQUE NOT_LOWEST ONLY_PARTNER_SHOWN UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.HotelPriceBucketEnum.HotelPriceBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_rate_rule_id |
Field description | Hotel rate rule ID. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_rate_type |
Field description | Hotel rate type. |
Category | SEGMENT |
Data Type |
ENUM
PRIVATE_RATE PUBLIC_RATE QUALIFIED_RATE UNAVAILABLE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.HotelRateTypeEnum.HotelRateType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_state |
Field description | Hotel state. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hour |
Field description | Hour of day as a number between 0 and 23, inclusive. |
Category | SEGMENT |
Data Type | INT32 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
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. |
Category | SEGMENT |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.month |
Field description | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.month_of_year |
Field description | Month of the year, for example, January. |
Category | SEGMENT |
Data Type |
ENUM
APRIL AUGUST DECEMBER FEBRUARY JANUARY JULY JUNE MARCH MAY NOVEMBER OCTOBER SEPTEMBER UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.MonthOfYearEnum.MonthOfYear |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
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. |
Category | SEGMENT |
Data Type |
ENUM
NEW NEW_AND_HIGH_LTV RETURNING UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.ConvertingUserPriorEngagementTypeAndLtvBucketEnum.ConvertingUserPriorEngagementTypeAndLtvBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.partner_hotel_id |
Field description | Partner hotel ID. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.placeholder_type |
Field description | Placeholder type. This is only used with feed item metrics. |
Category | SEGMENT |
Data Type |
ENUM
AD_CUSTOMIZER AFFILIATE_LOCATION APP CALL CALLOUT DYNAMIC_CUSTOM DYNAMIC_EDUCATION DYNAMIC_FLIGHT DYNAMIC_HOTEL DYNAMIC_JOB DYNAMIC_LOCAL DYNAMIC_REAL_ESTATE DYNAMIC_TRAVEL IMAGE LOCATION MESSAGE PRICE PROMOTION SITELINK STRUCTURED_SNIPPET UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.PlaceholderTypeEnum.PlaceholderType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_aggregator_id |
Field description | Aggregator ID of the product. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_brand |
Field description | Brand of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_category_level1 |
Field description | Category (level 1) of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
segments.product_category_level2 |
Field description | Category (level 2) of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
segments.product_category_level3 |
Field description | Category (level 3) of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
segments.product_category_level4 |
Field description | Category (level 4) of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
segments.product_category_level5 |
Field description | Category (level 5) of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
segments.product_channel |
Field description | Channel of the product. |
Category | SEGMENT |
Data Type |
ENUM
LOCAL ONLINE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.ProductChannelEnum.ProductChannel |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_channel_exclusivity |
Field description | Channel exclusivity of the product. |
Category | SEGMENT |
Data Type |
ENUM
MULTI_CHANNEL SINGLE_CHANNEL UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_condition |
Field description | Condition of the product. |
Category | SEGMENT |
Data Type |
ENUM
NEW REFURBISHED UNKNOWN UNSPECIFIED USED
|
Type URL | google.ads.googleads.v18.enums.ProductConditionEnum.ProductCondition |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_country |
Field description | Resource name of the geo target constant for the country of sale of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_custom_attribute0 |
Field description | Custom attribute 0 of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_custom_attribute1 |
Field description | Custom attribute 1 of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_custom_attribute2 |
Field description | Custom attribute 2 of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_custom_attribute3 |
Field description | Custom attribute 3 of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_custom_attribute4 |
Field description | Custom attribute 4 of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_feed_label |
Field description | Feed label of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_item_id |
Field description | Item ID of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_language |
Field description | Resource name of the language constant for the language of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_merchant_id |
Field description | Merchant ID of the product. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_store_id |
Field description | Store ID of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_title |
Field description | Title of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_type_l1 |
Field description | Type (level 1) of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_type_l2 |
Field description | Type (level 2) of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_type_l3 |
Field description | Type (level 3) of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_type_l4 |
Field description | Type (level 4) of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_type_l5 |
Field description | Type (level 5) of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.quarter |
Field description | 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. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.search_engine_results_page_type |
Field description | Type of the search engine results page. |
Category | SEGMENT |
Data Type |
ENUM
ADS_AND_ORGANIC ADS_ONLY ORGANIC_ONLY UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.SearchEngineResultsPageTypeEnum.SearchEngineResultsPageType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.slot |
Field description | Position of the ad. |
Category | SEGMENT |
Data Type |
ENUM
CONTENT MIXED SEARCH_OTHER SEARCH_PARTNER_OTHER SEARCH_PARTNER_TOP SEARCH_SIDE SEARCH_TOP UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v18.enums.SlotEnum.Slot |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.travel_destination_city |
Field description | The city the user is searching for at query time. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.travel_destination_country |
Field description | The country the user is searching for at query time. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.travel_destination_region |
Field description | The region the user is searching for at query time. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.week |
Field description | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.year |
Field description | Year, formatted as yyyy. |
Category | SEGMENT |
Data Type | INT32 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.absolute_top_impression_percentage |
Field description | Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_cpm |
Field description | Average cost of viewable impressions (active_view_impressions ). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_ctr |
Field description | Active view measurable clicks divided by active view viewable impressions. This metric is reported only for the Display Network. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_impressions |
Field description | A measurement of how often your ad has become viewable on a Display Network site. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_measurability |
Field description | The ratio of impressions that could be measured by Active View over the number of served impressions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_measurable_cost_micros |
Field description | The cost of the impressions you received that were measurable by Active View. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_measurable_impressions |
Field description | The number of times your ads are appearing on placements in positions where they can be seen. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_viewability |
Field description | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions |
Field description | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_by_conversion_date |
Field description | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_interactions_rate |
Field description | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_interactions_value_per_interaction |
Field description | The value of all conversions from interactions divided by the total number of interactions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_value |
Field description | The value of all conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_value_by_conversion_date |
Field description | The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_value_per_cost |
Field description | The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_new_customer_lifetime_value |
Field description | All of new customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for both biddable and non-biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "all_conversions_value". See https://support.google.com/google-ads/answer/12080169 for more details. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.auction_insight_search_absolute_top_impression_percentage |
Field description | This metric is part of the Auction Insights report, and tells how often the ads of another participant showed in the most prominent position on the search results page. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.auction_insight_search_impression_share |
Field description | This metric is part of the Auction Insights report, and tells the percentage of impressions that another participant obtained, over the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999. This metric is not publicly available. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.auction_insight_search_outranking_share |
Field description | This metric is part of the Auction Insights report, and tells the percentage of impressions that your ads outranked (showed above) another participant in the auction, compared to the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999. This metric is not publicly available. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.auction_insight_search_overlap_rate |
Field description | This metric is part of the Auction Insights report, and tells how often another participant's ad received an impression when your ad also received an impression. This metric is not publicly available. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.auction_insight_search_position_above_rate |
Field description | This metric is part of the Auction Insights report, and tells how often another participant's ad was shown in a higher position than yours, when both of your ads were shown at the same page. This metric is not publicly available. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.auction_insight_search_top_impression_percentage |
Field description | This metric is part of the Auction Insights report, and tells how often the ads of another participant showed adjacent to the top organic search results. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cart_size |
Field description | Average cart size is the average number of products in each order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average cart size is the total number of products sold divided by the total number of orders you received. Example: You received 2 orders, the first included 3 products and the second included 2. The average cart size is 2.5 products = (3+2)/2. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cost |
Field description | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cpc |
Field description | The total cost of all clicks divided by the total number of clicks received. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cpe |
Field description | The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cpm |
Field description | Average cost-per-thousand impressions (CPM). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cpv |
Field description | The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_order_value_micros |
Field description | Average order value is the average revenue you made per order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average order value is the total revenue from your orders divided by the total number of orders. Example: You received 3 orders which made $10, $15 and $20 worth of revenue. The average order value is $15 = ($10 + $15 + $20)/3. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_page_views |
Field description | Average number of pages viewed per session. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_time_on_site |
Field description | Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.benchmark_average_max_cpc |
Field description | An indication of how other advertisers are bidding on similar products. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.biddable_app_install_conversions |
Field description | Number of app installs. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.biddable_app_post_install_conversions |
Field description | Number of in-app actions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.bounce_rate |
Field description | Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.clicks |
Field description | The number of clicks. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.content_budget_lost_impression_share |
Field description | The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.content_impression_share |
Field description | The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.content_rank_lost_impression_share |
Field description | The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions |
Field description | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_by_conversion_date |
Field description | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_from_interactions_rate |
Field description | Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_from_interactions_value_per_interaction |
Field description | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_value |
Field description | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_value_by_conversion_date |
Field description | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_value_per_cost |
Field description | The value of conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_micros |
Field description | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_of_goods_sold_micros |
Field description | Cost of goods sold (COGS) is the total cost of the products you sold in orders attributed to your ads. How it works: You can add a cost of goods sold value to every product in Merchant Center. If you report conversions with cart data, the products you sold are matched with their cost of goods sold value and this can be used to calculate the gross profit you made on each order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cost of goods sold for this order is $8 = $3 + $5. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_per_all_conversions |
Field description | The cost of ad interactions divided by all conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_per_conversion |
Field description | The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_per_current_model_attributed_conversion |
Field description | The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_device_conversions |
Field description | Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_device_conversions_value_micros |
Field description | The sum of the value of cross-device conversions, in micros. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_sell_cost_of_goods_sold_micros |
Field description | Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_sell_gross_profit_micros |
Field description | Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_sell_revenue_micros |
Field description | Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_sell_units_sold |
Field description | Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.ctr |
Field description | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions |
Field description | Shows how your historic conversions data would look under the attribution model you've currently selected. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions_from_interactions_rate |
Field description | Current model attributed conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions_from_interactions_value_per_interaction |
Field description | The value of current model attributed conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions_value |
Field description | The value of current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions_value_per_cost |
Field description | The value of current model attributed conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.engagement_rate |
Field description | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.engagements |
Field description | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gmail_forwards |
Field description | The number of times the ad was forwarded to someone else as a message. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gmail_saves |
Field description | The number of times someone has saved your Gmail ad to their inbox as a message. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gmail_secondary_clicks |
Field description | The number of clicks to the landing page on the expanded state of Gmail ads. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gross_profit_margin |
Field description | Gross profit margin is the percentage gross profit you made from orders attributed to your ads, after taking out the cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. Gross profit margin is the gross profit you made divided by your total revenue and multiplied by 100%. Gross profit margin calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone bought a hat and a shirt in an order on your website. The hat is priced $10 and has a cost of goods sold value of $3. The shirt is priced $20 but has no cost of goods sold value. Gross profit margin for this order will only take into account the hat because it has a cost of goods sold value, so it's 70% = ($10 - $3)/$10 x 100%. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gross_profit_micros |
Field description | Gross profit is the profit you made from orders attributed to your ads minus the cost of goods sold (COGS). How it works: Gross profit is the revenue you made from sales attributed to your ads minus cost of goods sold. Gross profit calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The hat has a cost of goods sold value of $3, but the shirt has no cost of goods sold value. Gross profit for this order will only take into account the hat, so it's $7 = $10 - $3. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.historical_creative_quality_score |
Field description | The creative historical quality score. |
Category | METRIC |
Data Type | ENUM |
Type URL | google.ads.googleads.v18.enums.QualityScoreBucketEnum.QualityScoreBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.historical_landing_page_quality_score |
Field description | The quality of historical landing page experience. |
Category | METRIC |
Data Type | ENUM |
Type URL | google.ads.googleads.v18.enums.QualityScoreBucketEnum.QualityScoreBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.historical_quality_score |
Field description | The historical quality score. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.historical_search_predicted_ctr |
Field description | The historical search predicted click through rate (CTR). |
Category | METRIC |
Data Type | ENUM |
Type URL | google.ads.googleads.v18.enums.QualityScoreBucketEnum.QualityScoreBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.hotel_average_lead_value_micros |
Field description | Average lead value based on clicks. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.hotel_eligible_impressions |
Field description | The number of impressions that hotel partners could have had given their feed performance. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.hotel_price_difference_percentage |
Field description | The average price difference between the price offered by reporting hotel advertiser and the cheapest price offered by the competing advertiser. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.impressions |
Field description | Count of how often your ad has appeared on a search results page or website on the Google Network. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.interaction_event_types |
Field description | The types of payable and free interactions. |
Category | METRIC |
Data Type | ENUM |
Type URL | google.ads.googleads.v18.enums.InteractionEventTypeEnum.InteractionEventType |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
metrics.interaction_rate |
Field description | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.interactions |
Field description | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.lead_cost_of_goods_sold_micros |
Field description | Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.lead_gross_profit_micros |
Field description | Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.lead_revenue_micros |
Field description | Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.lead_units_sold |
Field description | Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.message_chat_rate |
Field description | Number of message chats initiated (message_chats) divided by the number of message impressions (message_impressions). Rate at which a user initiates a message chat from an ad impression with a messaging option and message tracking enabled. Note that this rate can be more than 1.0 for a given message impression. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.message_chats |
Field description | Number of message chats initiated for Click To Message impressions that were message tracking eligible. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.message_impressions |
Field description | Number of Click To Message impressions that were message tracking eligible. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.mobile_friendly_clicks_percentage |
Field description | The percentage of mobile clicks that go to a mobile-friendly page. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.new_customer_lifetime_value |
Field description | New customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "conversions_value" for optimization. See https://support.google.com/google-ads/answer/12080169 for more details. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.orders |
Field description | Orders is the total number of purchase conversions you received attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. If a conversion is attributed to previous interactions with your ads (clicks for text or Shopping ads, views for video ads etc.) it's counted as an order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order on your website. Even though they bought 2 products, this would count as 1 order. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.percent_new_visitors |
Field description | Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.phone_calls |
Field description | Number of offline phone calls. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.phone_impressions |
Field description | Number of offline phone impressions. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.phone_through_rate |
Field description | Number of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.relative_ctr |
Field description | Your clickthrough rate (Ctr) divided by the average clickthrough rate of all advertisers on the websites that show your ads. Measures how your ads perform on Display Network sites compared to other ads on the same sites. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.revenue_micros |
Field description | Revenue is the total amount you made from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Revenue is the total value of all the orders you received attributed to your ads, minus any discount. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The entire order has a $5 discount. The revenue from this order is $25 = ($10 + $20) - $5. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_absolute_top_impression_share |
Field description | The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/google-ads/answer/7501826 for details. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_budget_lost_absolute_top_impression_share |
Field description | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_budget_lost_impression_share |
Field description | The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_budget_lost_top_impression_share |
Field description | The number estimating how often your ad didn't show adjacent to the top organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_click_share |
Field description | The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_exact_match_impression_share |
Field description | The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_impression_share |
Field description | The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_rank_lost_absolute_top_impression_share |
Field description | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_rank_lost_impression_share |
Field description | The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_rank_lost_top_impression_share |
Field description | The number estimating how often your ad didn't show adjacent to the top organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_top_impression_share |
Field description | The impressions you've received among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. Top ads are generally above the top organic results, although they may show below the top organic results on certain queries. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.speed_score |
Field description | A measure of how quickly your page loads after clicks on your mobile ads. The score is a range from 1 to 10, 10 being the fastest. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.top_impression_percentage |
Field description | The percent of your ad impressions that are shown adjacent to the top organic search results. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.units_sold |
Field description | Units sold is the total number of products sold from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Units sold is the total number of products sold from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The units sold in this order is 3. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.valid_accelerated_mobile_pages_clicks_percentage |
Field description | The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_all_conversions |
Field description | The value of all conversions divided by the number of all conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_all_conversions_by_conversion_date |
Field description | The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_conversion |
Field description | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_conversions_by_conversion_date |
Field description | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_current_model_attributed_conversion |
Field description | The value of current model attributed conversions divided by the number of the conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_quartile_p100_rate |
Field description | Percentage of impressions where the viewer watched all of your video. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_quartile_p25_rate |
Field description | Percentage of impressions where the viewer watched 25% of your video. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_quartile_p50_rate |
Field description | Percentage of impressions where the viewer watched 50% of your video. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_quartile_p75_rate |
Field description | Percentage of impressions where the viewer watched 75% of your video. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_view_rate |
Field description | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_views |
Field description | The number of times your video ads were viewed. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.view_through_conversions |
Field description | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|