Google Ads

Field reference and API usage

Field ReferenceGoogle Ads

Google Ads

Advertising

Track Google Ads campaigns, ad groups, keywords, and conversions

https://ads.google.com ↗

2137 metrics346 dimensions21 data viewsoauth2 auth

API Usage

Metrics

107

Basic 17

ID	Name	Symbol
`impressions`	Impressions	number
`clicks`	Clicks	number
`cost_micros`	Cost	currency
`ctr`	CTR	%
`bounce_rate`	Bounce Rate	%
`average_page_views`	Avg. Page Views	number
`average_time_on_site`	Avg. Time On Site	time
`average_cpc`	CPC	currency
`average_cpm`	CPM	currency
`interactions`	Interactions	number
`interaction_rate`	Interaction Rate	%
`engagements`	Engagements	number
`engagement_rate`	Engagement Rate	%
`average_cost`	Avg. Cost	currency
`average_cpe`	Avg. CPE	currency
`average_cpv`	Avg. CPV	currency
`revenue_micros`	Revenue	currency

Quality Score 4

ID	Name	Symbol
`historical_quality_score`	Historical Quality Score	number
`historical_search_predicted_ctr`	Historical Search Predicted CTR	%
`historical_landing_page_quality_score`	Historical Landing Page Quality Score	number
`historical_creative_quality_score`	Historical Creative Quality Score	number

Active View 7

ID	Name	Symbol
`active_view_cpm`	Viewable CPM	currency
`active_view_ctr`	Viewable CTR	%
`active_view_impressions`	Viewable Impressions	number
`active_view_measurability`	Viewable Measurability	number
`active_view_measurable_cost_micros`	Viewable Measurable Cost	currency
`active_view_measurable_impressions`	Viewable Measurable Impressions	number
`active_view_viewability`	Viewability	number

Conversions 27

ID	Name	Symbol
`conversions`	Conversions	number
`cost_per_conversion`	Cost / Conversion	currency
`conversions_from_interactions_rate`	Conversion Rate	%
`conversions_value`	Conversion Value	currency
`conversions_value_per_cost`	ROAS	decimal
`value_per_conversion`	Value Per Conversion	number
`value_per_all_conversions`	Value Per All Conversions	number
`view_through_conversions`	View Through Conversions	number
`all_conversions`	All Conversions	number
`all_conversions_value`	All Conversions Value	currency
`cross_device_conversions`	Cross Device Conversions	number
`cost_per_all_conversions`	Cost Per All Conversions	currency
`all_conversions_from_interactions_rate`	All Conversion Rate	%
`all_conversions_value_per_cost`	All Conversion Value Per Cost	currency
`all_conversions_from_click_to_call`	All Conversions From Click To Call	number
`all_conversions_from_directions`	All Conversions From Directions	number
`all_conversions_from_menu`	All Conversions From Menu	number
`all_conversions_from_order`	All Conversions From Order	number
`all_conversions_from_other_engagement`	All Conversions From Other Engagement	number
`all_conversions_from_store_visit`	All Conversions From Store Visit	number
`all_conversions_from_store_website`	All Conversions From Store Website	number
`conversions_by_conversion_date`	Conversions (by conv. time)	number
`all_conversions_by_conversion_date`	All Conv. (by conv. time)	number
`conversions_value_by_conversion_date`	Conv. Value (by conv. time)	number
`all_conversions_value_by_conversion_date`	All Conv. Value (by conv. time)	number
`value_per_conversions_by_conversion_date`	Value / Conv. (by conv. time)	number
`value_per_all_conversions_by_conversion_date`	Value / All Conv. (by conv. time)	number

Video 6

ID	Name	Symbol
`video_views`	Video Views	number
`video_view_rate`	Video Views Rate	%
`video_quartile_p25_rate`	Watch 25% Rate	%
`video_quartile_p50_rate`	Watch 50% Rate	%
`video_quartile_p75_rate`	Watch 75% Rate	%
`video_quartile_p100_rate`	Watch 100% Rate	%

Calls 3

ID	Name	Symbol
`phone_impressions`	Phone Impressions	number
`phone_calls`	Phone Calls (Deprecated)	number
`phone_through_rate`	Phone Through Rate	%

Gmail 3

ID	Name	Symbol
`gmail_forwards`	Gmail Forwards	number
`gmail_saves`	Gmail Saves	number
`gmail_secondary_clicks`	Gmail Secondary Clicks	number

Click Share 1

	ID	Name	Symbol
	`search_click_share`	Search Click Share	number

Impression Share 8

ID	Name	Symbol
`search_impression_share`	Search Impression Share (IS)	%
`search_exact_match_impression_share`	Search Impression Share (Raw)	%
`search_exact_match_impression_share`	Search Exact Match IS	%
`search_budget_lost_impression_share`	Search Lost IS (Budget)	%
`search_rank_lost_impression_share`	Search Lost IS (Rank)	%
`content_impression_share`	Content Impression Share	%
`content_budget_lost_impression_share`	Lost Impressions due to Budget	%
`content_rank_lost_impression_share`	Lost Impressions due to Rank	%

Landing Page 2

	ID	Name	Symbol
	`mobile_friendly_clicks_percentage`	Mobile-Friendly Click Rate	%
	`valid_accelerated_mobile_pages_clicks_percentage`	Valid AMP Click Rate	%

Hotel 3

ID	Name	Symbol
`hotel_average_lead_value_micros`	Avg. Hotel Leave Value	currency
`hotel_eligible_impressions`	Hotel Eligible Impressions	number
`hotel_price_difference_percentage`	Avg. Hotel Price Difference	number

Auction 6

ID	Name	Symbol
`auction_insight_search_absolute_top_impression_percentage`	Abs. Top Of Page Rate	%
`auction_insight_search_impression_share`	Impression Share	%
`auction_insight_search_outranking_share`	Outranking Share	%
`auction_insight_search_overlap_rate`	Overlap Rate	%
`auction_insight_search_position_above_rate`	Position Above Rate	%
`auction_insight_search_top_impression_percentage`	Top Of Page Rate	%

Other 15

ID	Name	Symbol
`invalid_clicks`	Invalid Clicks	number
`invalid_click_rate`	Invalid Clicks Rate	%
`relative_ctr`	Relative CTR	%
`speed_score`	Speed Score	number
`top_impression_percentage`	Top Impression Percentage	%
`absolute_top_impression_percentage`	Absolute Top Impression Percentage	%
`search_absolute_top_impression_share`	Search Absolute Top Impression Share	%
`search_top_impression_share`	Search Top IS	%
`search_rank_lost_top_impression_share`	Search Lost Top IS (Rank)	%
`search_rank_lost_absolute_top_impression_share`	Search Lost Abs. Top (Rank)	%
`search_budget_lost_absolute_top_impression_share`	Search Lost Abs. Top IS (Budget)	%
`search_budget_lost_top_impression_share`	Search Lost Top IS (Budget)	%
`percent_new_visitors`	First Time Sessions	number
`optimization_score_uplift`	Optimization Score	number
`benchmark_average_max_cpc`	Avg. Max CPC	%

Budget 2

	ID	Name	Symbol
	`campaign_budget`	Budget	currency
	`campaign_total_budget`	Total Budget	currency

Message 3

ID	Name	Symbol
`message_chats`	Message Chats	number
`message_chat_rate`	Message Chat Rate	%
`message_impressions`	Message Impressions	number

Dimensions

Time 3

	ID	Name
	`DATE`	Date
	`MONTH`	Month
	`YEAR`	Year

Basic 4

	ID	Name
	`device`	Device
	`click_type`	Click Type
	`week`	Week
	`day_of_week`	Day of Week

Conversions 4

	ID	Name
	`conversion_action_name`	Conversion Action
	`conversion_action_category`	Conversion Category
	`conversion_adjustment`	Conversion Adjustment
	`external_conversion_source`	External Conversion Source

Auction 1

	ID	Name
	`auction_insight_domain`	Display URL Domain