Google Ads dimensions

Documented dimensions available in the native reporting reference on Google Ads through an AI assistant: 84 in total, 0 of them computed by the gateway…

84 rows

The 84 documented dimensions and report attributes for Google Ads. Each entry distinguishes breakdown selectors from returned attributes and states its constraints.

shopping (26)Link to this section

Key	Name	API field	Notes
`productItemId`	Product Item ID (SKU)	`segments.product_item_id`	The Merchant Center Item ID (SKU) of the product.
`productBrand`	Product Brand	`segments.product_brand`	The brand of the product from the Merchant Center feed.
`productTitle`	Product Title	`segments.product_title`	The title of the product from the Merchant Center feed.
`productCategoryLevel1`	Product Category (L1)	`segments.product_category_level1`	Google product taxonomy level 1 (e.g., Apparel & Accessories)
`productCategoryLevel2`	Product Category (L2)	`segments.product_category_level2`	Google product taxonomy level 2.
`productCategoryLevel3`	Product Category (L3)	`segments.product_category_level3`	Google product taxonomy level 3.
`productCategoryLevel4`	Product Category (L4)	`segments.product_category_level4`	Google product taxonomy level 4.
`productCategoryLevel5`	Product Category (L5)	`segments.product_category_level5`	Google product taxonomy level 5.
`productTypeL1`	Product Type (L1)	`segments.product_type_l1`	Merchant-defined product type level 1.
`productTypeL2`	Product Type (L2)	`segments.product_type_l2`	Merchant-defined product type level 2.
`productTypeL3`	Product Type (L3)	`segments.product_type_l3`	Merchant-defined product type level 3.
`productTypeL4`	Product Type (L4)	`segments.product_type_l4`	Merchant-defined product type level 4.
`productTypeL5`	Product Type (L5)	`segments.product_type_l5`	Merchant-defined product type level 5.
`productCustomAttribute0`	Custom Label 0	`segments.product_custom_attribute0`	Custom label 0 from Merchant Center feed.
`productCustomAttribute1`	Custom Label 1	`segments.product_custom_attribute1`	Custom label 1 from Merchant Center feed.
`productCustomAttribute2`	Custom Label 2	`segments.product_custom_attribute2`	Custom label 2 from Merchant Center feed.
`productCustomAttribute3`	Custom Label 3	`segments.product_custom_attribute3`	Custom label 3 from Merchant Center feed.
`productCustomAttribute4`	Custom Label 4	`segments.product_custom_attribute4`	Custom label 4 from Merchant Center feed.
`productChannel`	Product Channel	`segments.product_channel`	Whether the product is sold online or locally.
`productChannelExclusivity`	Product Channel Exclusivity	`segments.product_channel_exclusivity`	Whether the product is sold exclusively in one channel.
`productCondition`	Product Condition	`segments.product_condition`	Condition of the product from the feed.
`productCountry`	Product Country	`segments.product_country`	The target country of the product in the Merchant Center feed.
`productLanguage`	Product Language	`segments.product_language`	The language of the product listing.
`productStoreId`	Product Store ID	`segments.product_store_id`	The store ID for Local Inventory Ads.
`productAggregatorId`	Product Aggregator ID	`segments.product_aggregator_id`	The aggregator ID of the product (for multi-client accounts)
`productMerchantId`	Product Merchant ID	`segments.product_merchant_id`	The Merchant Center ID of the product.

entity (19)Link to this section

Key	Name	API field	Notes
`campaignId`	Campaign ID	`campaign.id`	Unique identifier for the campaign.
`campaignName`	Campaign Name	`campaign.name`	The name of the campaign.
`campaignStatus`	Campaign Status	`campaign.status`	Current status of the campaign (ENABLED, PAUSED, REMOVED)
`campaignType`	Campaign Type	`campaign.advertising_channel_type`	The advertising channel type of the campaign (SEARCH, DISPLAY, SHOPPING, VIDEO, etc.)
`campaignSubType`	Campaign Sub Type	`campaign.advertising_channel_sub_type`	The advertising channel sub type of the campaign.
`adGroupId`	Ad Group ID	`ad_group.id`	Unique identifier for the ad group.
`adGroupName`	Ad Group Name	`ad_group.name`	The name of the ad group.
`adGroupStatus`	Ad Group Status	`ad_group.status`	Current status of the ad group (ENABLED, PAUSED, REMOVED)
`adId`	Ad ID	`ad_group_ad.ad.id`	Unique identifier for the ad.
`adGroupAdAdId`	Ad Group Ad ID	`ad_group_ad.ad.id`	Alias for ad_group_ad.ad.id. Useful for agents that request fully-qualified ad_group_ad fields.
`adGroupAdAdName`	Ad Group Ad Name	`ad_group_ad.ad.name`	Alias for ad_group_ad.ad.name when available from the Google Ads API.
`adName`	Ad Name	`ad_group_ad.ad.name`	Ad name when available from ad_group_ad.ad.name.
`keywordText`	Keyword Text	`ad_group_criterion.keyword.text`	The text of the keyword criterion (e.g., 'polo ralph lauren')
`keywordMatchType`	Keyword Match Type	`ad_group_criterion.keyword.match_type`	The match type of the keyword (EXACT, PHRASE, BROAD)
`qualityScore`	Quality Score	`ad_group_criterion.quality_info.quality_score`	The current quality score of the keyword (1-10). Only available on keyword_view.
`customerId`	Customer ID	`customer.id`	The Google Ads account (customer) ID.
`customerName`	Customer Name	`customer.descriptive_name`	The descriptive name of the Google Ads account.
`campaignStartDate`	Campaign Start Date	`campaign.start_date_time`	The start date and time of the campaign in the account time zone (YYYY-MM-DD HH:mm:ss).
`campaignEndDate`	Campaign End Date	`campaign.end_date_time`	The end date and time of the campaign in the account time zone (YYYY-MM-DD HH:mm:ss), if set.

bidding (9)Link to this section

Key	Name	API field	Notes
`campaignBiddingStrategy`	Campaign Bidding Strategy	`campaign.bidding_strategy_type`	The bidding strategy type used by the campaign (TARGET_CPA, MAXIMIZE_CONVERSIONS, etc.)
`campaignTargetRoas`	Target ROAS	`campaign.target_roas.target_roas`	Target return on ad spend value. Set when using TARGET_ROAS or MAXIMIZE_CONVERSION_VALUE with target ROAS.
`campaignMaximizeConversionValueTargetRoas`	Max Conv. Value Target ROAS	`campaign.maximize_conversion_value.target_roas`	Target ROAS for MAXIMIZE_CONVERSION_VALUE bidding strategy.
`campaignTargetCpaMicros`	Target CPA	`campaign.target_cpa.target_cpa_micros`	Target cost-per-acquisition in micro-currency. Set when using TARGET_CPA bidding strategy.
`campaignMaximizeConversionsTargetCpaMicros`	Max Conv. Target CPA	`campaign.maximize_conversions.target_cpa_micros`	Optional target CPA for MAXIMIZE_CONVERSIONS bidding strategy in micro-currency.
`campaignTargetImpressionShareLocation`	Target IS Location	`campaign.target_impression_share.location`	Where to target impressions for TARGET_IMPRESSION_SHARE strategy (ANYWHERE_ON_PAGE, TOP_OF_PAGE, ABSOLUTE_TOP_OF_PAGE).
`campaignTargetImpressionShareFraction`	Target IS Fraction	`campaign.target_impression_share.location_fraction_micros`	Target percentage of impressions for TARGET_IMPRESSION_SHARE (in micros, divide by 1,000,000).
`campaignTargetImpressionShareCpcCeiling`	Target IS CPC Ceiling	`campaign.target_impression_share.cpc_bid_ceiling_micros`	Maximum CPC bid ceiling for TARGET_IMPRESSION_SHARE in micro-currency.
`campaignOptimizationScore`	Optimization Score	`campaign.optimization_score`	Campaign optimization score between 0 and 1 (multiply by 100 for percentage).

time (7)Link to this section

Key	Name	API field	Notes
`date`	Date	`segments.date`	The date of the data point (YYYY-MM-DD format)
`dayOfWeek`	Day of Week	`segments.day_of_week`	The day of the week (MONDAY through SUNDAY)
`hour`	Hour of Day	`segments.hour`	The hour of the day (0-23). Requires date segment to be present.
`month`	Month	`segments.month`	The month of the data point (YYYY-MM format)
`week`	Week	`segments.week`	The week of the data point (date of the Monday of the week, YYYY-MM-DD format)
`quarter`	Quarter	`segments.quarter`	The quarter of the data point (first day of the quarter, YYYY-MM-DD format)
`year`	Year	`segments.year`	The year of the data point.

budget (5)Link to this section

Key	Name	API field	Notes
`campaignBudgetAmount`	Daily Budget	`campaign_budget.amount_micros`	Daily budget amount in micro-currency (divide by 1,000,000 for standard currency). Shows the configured daily budget.
`campaignBudgetTotal`	Total Budget (Lifetime)	`campaign_budget.total_amount_micros`	Total lifetime budget in micro-currency. Only set for campaigns with lifetime budgets (period = CUSTOM_PERIOD).
`campaignBudgetPeriod`	Budget Period	`campaign_budget.period`	Whether the budget is daily or lifetime (DAILY or CUSTOM_PERIOD)
`campaignBudgetDeliveryMethod`	Budget Delivery Method	`campaign_budget.delivery_method`	How the budget is spent across the day (STANDARD or ACCELERATED)
`campaignBudgetExplicitlyShared`	Budget Shared	`campaign_budget.explicitly_shared`	Whether this budget is shared across multiple campaigns.

conversion (4)Link to this section

Key	Name	API field	Notes
`conversionAction`	Conversion Action	`segments.conversion_action`	The conversion action resource name. Segments data by individual conversion actions. Incompatible with many impression share metrics. Not with: searchImpressionShare, searchBudgetLostImpressionShare, searchRankLostImpressionShare, searchTopImpressionShare, searchAbsoluteTopImpressionShare, searchExactMatchImpressionShare, contentImpressionShare, contentBudgetLostImpressionShare, contentRankLostImpressionShare.
`conversionActionName`	Conversion Action Name	`segments.conversion_action_name`	The human-readable name of the conversion action. Not with: searchImpressionShare, searchBudgetLostImpressionShare, searchRankLostImpressionShare, searchTopImpressionShare, searchAbsoluteTopImpressionShare, searchExactMatchImpressionShare, contentImpressionShare, contentBudgetLostImpressionShare, contentRankLostImpressionShare.
`conversionActionCategory`	Conversion Action Category	`segments.conversion_action_category`	The category of the conversion action (PURCHASE, LEAD, SIGNUP, etc.) Not with: searchImpressionShare, searchBudgetLostImpressionShare, searchRankLostImpressionShare, searchTopImpressionShare, searchAbsoluteTopImpressionShare, searchExactMatchImpressionShare, contentImpressionShare, contentBudgetLostImpressionShare, contentRankLostImpressionShare.
`externalConversionSource`	External Conversion Source	`segments.external_conversion_source`	The external source of the conversion (GOOGLE_ANALYTICS, FIREBASE, UPLOAD, etc.) Not with: searchImpressionShare, searchBudgetLostImpressionShare, searchRankLostImpressionShare, searchTopImpressionShare, searchAbsoluteTopImpressionShare, searchExactMatchImpressionShare, contentImpressionShare, contentBudgetLostImpressionShare, contentRankLostImpressionShare.

geographic (3)Link to this section

Key	Name	API field	Notes
`geoTargetCountry`	Geo Target Country	`segments.geo_target_country`	The country geo target constant resource name for geographic segmentation.
`geoTargetRegion`	Geo Target Region	`segments.geo_target_region`	The region (state/province) geo target constant resource name for geographic segmentation.
`geoTargetMetro`	Geo Target Metro	`segments.geo_target_metro`	The metro area (DMA) geo target constant resource name for geographic segmentation.

interaction (3)Link to this section

Key	Name	API field	Notes
`clickType`	Click Type	`segments.click_type`	Type of click (headline, sitelink, call, etc.) Not with: conversionAction, conversionActionName, conversionActionCategory, externalConversionSource.
`adDestinationType`	Ad Destination Type	`segments.ad_destination_type`	The destination type that users interact with.
`interactionOnThisExtension`	Interaction on This Extension	`segments.interaction_on_this_extension`	Whether the interaction happened on this specific extension vs. the ad itself.

campaign_type (2)Link to this section

Key	Name	API field	Notes
`advertisingChannelType`	Advertising Channel Type	`campaign.advertising_channel_type`	The advertising channel type of the campaign (SEARCH, SHOPPING, PERFORMANCE_MAX, etc.). Alias for campaignType.
`advertisingChannelSubType`	Advertising Channel Sub Type	`campaign.advertising_channel_sub_type`	The advertising channel sub type of the campaign. Alias for campaignSubType.

demographic (2)Link to this section

Key	Name	API field	Notes
`ageRange`	Age Range	`segments.age_range`	The age range of the user who saw or interacted with the ad.
`gender`	Gender	`segments.gender`	The gender of the user who saw or interacted with the ad.

device (2)Link to this section

Key	Name	API field	Notes
`device`	Device	`segments.device`	The device type where the impression or interaction occurred.
`slot`	Ad Slot	`segments.slot`	The position on the page where the ad was shown.

ad_format (1)Link to this section

Key	Name	API field	Notes
`adType`	Ad Type	`ad_group_ad.ad.type`	The type of the ad (RESPONSIVE_SEARCH_AD, RESPONSIVE_DISPLAY_AD, VIDEO_AD, etc.)

network (1)Link to this section

Key	Name	API field	Notes
`adNetworkType`	Ad Network Type	`segments.ad_network_type`	The ad network where the impression was served (Search, Display, YouTube, etc.)