Metrics
Google Ads metrics via API
Your customer connects their Google Ads account and your product queries 94 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "gads:clicks",
"component": "number_v1",
"metrics": [
"metrics.clicks"
]
}
]
}More Google Ads request examples
The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).
Chart
Clicks by Device
This graph displays the number of clicks on your ads, grouped by the device that the person was using.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "gads:clicks_per_device",
"component": "chart_v1",
"metrics": [
"metrics.clicks"
],
"dimensions": [
"device"
]
}
]
}Table
Ad Group Summary
All of you ad groups, sorted by clicks.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "gads:summary_per_adgroups",
"component": "datatable_v1",
"metrics": [
"metrics.clicks",
"metrics.cost_micros",
"metrics.impressions",
"metrics.conversions",
"metrics.absolute_top_impression_percentage",
"metrics.cost_per_conversion"
],
"dimensions": [
"ad_group"
]
}
]
}Number
Campaigns count
Number of campaigns that had some investment.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "gads:count_campaigns",
"component": "number_v1",
"metrics": [
"metrics.cost_micros"
],
"dimensions": [
"campaign"
]
}
]
}Numbers
57 metrics
Clicks
Number of times someone clicked on your ad.
gads:clicksCampaigns count
Number of campaigns that had some investment.
gads:count_campaignsAds count
Number of ads that had some investment.
gads:count_adsAll Conversions
All conversions includes the data of your "Conversions" column and the conversion actions that you chose not to include in the "Conversions" column. It also shows cross-device conversions, store visits, certain phone calls, and more.
gads:all_conversionsConversions Value
The sum of conversion values for the conversions included in the 'Conversions' column. This metric is only useful if you have entered a value for your conversion actions.
gads:conversions_valueAll Conversions Value
The value of all conversions includes the data of your "Conversions" column and the conversion actions that you chose not to include in the "Conversions" column. It also shows cross-device conversions, store visits, certain phone calls, and more.
gads:all_conversions_valueConversions
An action that counts when someone interacts with your ad or free product listing (for example, clicks on a text ad or watches a video ad) and then takes an action that you’ve defined as valuable ( for example, an online purchase or a call to your business from a smartphone).
gads:conversionsImpressions
Number of times your ad has appeared on a search results page or website on the Google. One ad can appear multiple times to the same user.
gads:impressionsVideo Views
Number of times your videos have been viewed. A view counts when a person watches 30 seconds of your video (or the entire video if shorter) or interacts with it. Qualified interactions vary by ad format and include clicks or taps on CTAs, cards, banners, thumbnails or logos.
gads:video_viewsCTR
The Click Through Rate (CTR) represents the number of total clicks that your ads received divided by the number of time it was shown (impressions).
gads:ctrCost
How much money you have spent on your ad campaign in the specified time period.
gads:cost_microsCost per all conversions
Cost per all conversions tells you how much, on average, each of your conversions costs. It is calculated by dividing the total cost by the number of all conversions. All conversions consider data from all conversion actions, including those you choose not to include under "Conversions". It also covers other special conversion sources.
gads:cost_per_all_conversionsCost Per Conversion
Total cost divided by all conversions.
gads:cost_per_conversionAverage CPM
Cost per Mille (CPM) is the average cost for 1,000 impressions. It is calculated by dividing Spent Amount/(Number of Impressions x 1000). CPM is a common metric used by the online advertising industry to gauge the cost-effectiveness of an ad campaign. It's often used to compare performance among different ad publishers and campaigns.
gads:average_cpmAverage CPC
Cost per Click (CPC) shows how much, on average, each link click costs you. It is calculated by dividing Cost/Number of Clicks. CPC is a metric used in the online advertising industry for benchmarking ad efficiency and performance.
gads:average_cpcAverage CPV
Average cost per view (CPV) is the average amount you pay each time someone views your campaign. CPV is defined by the total cost of all ad views divided by the number of views. A view counts when someone watches 30 seconds of your video (or the full ad if it's less than 30 seconds) or interacts with it, whichever comes first. As a video ad includes call-to-action clicks (CTAs), cards and companion banners.
gads:average_cpvConversion Rate
The conversion rate shows the average frequency with which an ad interaction results in a conversion. This is the number indicated under "Conversions" divided by the number of interactions with your ad. Ad interactions include text ad clicks and video ad views. This metric only includes interactions that can generate conversions.
gads:conversions_from_interactions_rateROAS
Return on Advertising Spend (ROAS) is the profit you make from your ads relative to your advertising investments. It is calculated by dividing the value of conversions by the cost.
gads:roasAll Conversions Value per cost
The value of all conversions by cost measures the ROI of all conversions. It is the value of all conversions divided by the cost of all ad interactions, such as text ad clicks or video ad views. This metric doesn't include interactions that don't lead to conversions, like those that happen when you don't use conversion tracking.
gads:all_conversions_value_per_costConversions Value per cost
The cost-to-cost conversion value measures your return on investment. It reflects the conversion value divided by the cost of all ad interactions. The cost in this metric doesn't include interactions that can't lead to conversions, like those that happen when you don't use conversion tracking.
gads:conversions_value_per_costPhone calls
Number of times people clicked on a phone number displayed in a mobile ad or dialed the Google call forwarding number displayed in an ad on any device.
gads:phone_callsView rate of videos
The "View Rate" metric shows you the percentage of people who watched your videos after viewing the video or thumbnail for the first time. It equals the number of views of your ad divided by the number of impressions, including thumbnail impressions of video discovery ads.
gads:video_view_rateVideo conversions
Number of times viewers took the desired action after watching the video ad during the analyzed period.
gads:video_conversionsVideo conversion rate
Conversion rate shows the average frequency with which an ad interaction results in a conversion. It equals the number indicated under "Conversions" divided by the number of interactions with your ad. Ad interactions include text ad clicks and video ad views. This metric only includes interactions that can lead to conversions.
gads:video_conversions_rateVideos CTR
Click-through rate (CTR) measures how often people click on your ad after viewing it. This can help you understand the effectiveness of the ad. To calculate the CTR, you need to divide the number of clicks your ad receives by the number of times your ad is displayed.
gads:video_ctrVideo impressions
Number of times the video ad was shown to viewers on the YouTube platform during the reporting period. This means that each time a viewer sees the ad, an impression is counted, regardless of whether they watched the entire video or just a portion of it.
gads:video_impressionsVideo clicks
Number of times the viewer clicked on the video ad during its display in the analyzed period.
gads:video_clicksInteraction Rate
The "interaction rate" is the number of interactions divided by total impressions. It measures how often people interact with your ad after being exposed to it. This helps you evaluate the effectiveness of the ad.
gads:interaction_rateInteractions
An interaction is the main action associated with an ad format. It can include clicks on text and Shopping ads, views on video ads, and more. Interactions help you determine whether your ads are meeting your performance goals.
gads:interactions% impressions (top)
Top search impression rate is the percentage of impressions displayed anywhere above the organic search results.
gads:top_impression_percentageEngagements
An engagement occurs when a consumer interacts with an ad, for example, by viewing at least 10 seconds or clicking on a video ad. Thus, it helps to measure the performance of the ad. Highly targeted, relevant ads with compelling content encourage users to more actively interact with your brand.
gads:engagementsEngagement Rate
Engagement rate is used to measure how often people interact with your ad after it's shown to them. Use it to evaluate the effectiveness of your ad. Engagement rate is the number of engagements divided by total impressions.
gads:engagement_rateAverage CPE
Average cost per engagement (CPE) is the average amount charged for an ad engagement. This amount represents the total cost of ad engagements divided by the total number of ad engagements.
gads:cpe% of Impressions (1st Position)
First search impression rate is the percentage of impressions that appear as the first ad above organic search results.
gads:absolute_top_impression_percentageSearch Impression Share
Impression share (IS) is the percentage of impressions that your ads receive compared to the total number of impressions that your ads could get. Values below 10% are shown as 9.99% because Google does not report the exact number in this range.
gads:search_impression_sharePage Views
The number of times a page was viewed after an ad interaction.
gads:conversions_page_viewsAdd to Cart
Number of times products were added to the shopping cart by users after interacting with ads.
gads:conversion_add_to_cartBegin Checkout
The number of times a person started the checkout process after an ad interaction.
gads:conversion_begin_checkoutPurchase
Number of transactions completed through ads, indicating how many Purchases/sales were generated directly by Google Ads campaigns.
gads:conversion_purchaseBook Appointment
The number of times an appointment was booked after an ad interaction.
gads:conversion_book_appointmentContacts
This metric counts the number of contacts made through forms, chats or other forms of communication offered on the website, after interacting with the ads.
gads:conversion_contactDownload
Number of file or application downloads that were made after users clicked on ads during the analyzed period.
gads:conversion_downloadConverted Lead
Number of converted leads in the analyzed period. A converted or "closed" lead helps you track Google-generated leads that have completed a chosen step in the lead conversion process, typically offline (outside of Google Ads). This step can be defined as completing a sale, a transaction closed offline or online, or any step you determine as "conversion."
gads:conversion_converted_leadConversions (Engagement)
The number of times a person engaged with your ad after an ad interaction.
gads:conversion_engagementGet directions
The number of times a person requested directions to your business after an ad interaction.
gads:conversion_get_directionsOutbound Click
The number of times a person clicked on a link to another site after an ad interaction.
gads:conversion_outbound_clickPhone Call Lead
"Phone Call Lead" shows how many times your ad was shown with a Google call forwarding number, or how many times a Google call forwarding number could have been shown to someone on your website.
gads:conversion_phone_call_leadQualified Lead
Number of qualified leads in the analyzed period. A qualified or "interested" lead helps you track Google-generated leads that were also qualified offline (outside of Google Ads) in your customer relationship management (CRM) system or internal lead generation system.
gads:conversion_qualified_leadRequest Quote
The number of times a person requested a quote after an ad interaction.
gads:conversion_request_quoteSubscriptions
Number of times someone signed up for a newsletter or free trial, created an account, or pre-registered.
gads:conversion_sign_upStore Visits
Number of customers who received or clicked on your online ads and then visited your physical store.
gads:conversion_store_visitIn-store sales
Number of offline purchases that occurred after customers interacted with your Google ads.
gads:conversion_store_saleSubmit Lead Form
Number of lead forms submitted after interacting with ads. These forms generally collect information from users interested in products or services, being essential for generating qualified leads.
gads:conversion_submit_lead_formSubmit Lead Form (all conversions)
Total number of lead form conversions submitted after interacting with ads. These forms generally collect information from users interested in products or services, being essential for generating qualified leads. All conversions includes what is set as 'Conversions' plus other data, such as conversions marked as secondary actions.
gads:conversion_submit_lead_form_all_conversionsSubscribe Paid
This metric counts the number of signups or registrations made by users after clicking on an ad.
gads:conversion_subscribe_paidPTR
The total number of calls (phone calls) received divided by the number of times your phone number was displayed (phone number printouts).
gads:ptrCost per Phone Call
The total cost of your ads divided by the number of phone calls received.
gads:cost_per_phone_calls
Charts
13 metrics
Clicks by Device
This graph displays the number of clicks on your ads, grouped by the device that the person was using.
gads:clicks_per_deviceClicks and CTR Over Time
This graph displays the number clicks and percentage of CTR in the time frame specified
gads:clicks_ctr_per_dayConversions by Device
This graph displays the number of conversion that your ads generated, grouped by the device that the person was using.
gads:conversions_by_deviceImpressions by Gender
This graph displays the number of impressions that your ads generated, grouped by the gender.
gads:impressions_by_genderImpressions by Age
This graph displays the number of impressions that your ads generated, grouped by the age range.
gads:impressions_by_ageCost by Device
Cost of your ads, grouped by the device that the person was using.
gads:cost_per_deviceAll conversions and Conversion Rate Over Time
This graph displays the number all conversions and the conversion rate in the time frame specified.
gads:all_conversion_conversion_rate_per_dayConversions and Conversion Rate Over Time
This graph displays the number conversions and the conversion rate in the time frame specified.
gads:conversion_conversion_rate_per_dayCost and Average CPC Over Time
This graph displays the cost and the average CPC in the time frame specified.
gads:cost_average_cpc_per_dayVideo impressions and views
This graph represents the number of times the video ads were displayed (impressions) and how many times they were played (views) during the analyzed time period.
gads:video_impressions_by_timeVideo clicks and CTR
This graph allows you to check the number of clicks that the video ads received (Clicks) and the click-through rate in relation to the number of times the ads were shown (CTR - Click-through Rate) during the analyzed period.
gads:video_clicks_ctr_by_timeConversion and conversion rate of videos
This graph demonstrates the number of desired actions (Conversion) that were taken by the viewer of the ads after watching them, as well as the conversion rate in relation to the number of times the ads were shown (Conversion Rate) during the analyzed period.
gads:video_conversions_by_timeCost and average CPM of videos
This chart shows the total cost of video ad campaigns (Cost) and the average cost to deliver 1,000 impressions (CPM - Cost Per Mille) during the analysis period.
gads:video_cost_by_time
Tables
24 metrics
Ad Group Summary
All of you ad groups, sorted by clicks.
gads:summary_per_adgroupsAll Campaigns
All of your ad campaigns, sorted by clicks.
gads:top_campaignsCampaign Performance by ID
All of your ad campaigns with campaign IDs, sorted by clicks.
gads:campaign_performance_by_idSearch Keywords Summary
All the search keywords that you spent money on, sorted by clicks.
gads:summary_per_keywordsSmart Campaign Search Terms Summary
Summary of performance for each of the search terms for Smart Campaigns for the analyzed period. Search terms are the words or phrases that users type into a Google search that trigger ads to appear.
gads:summary_per_smart_campaign_search_termDestination URL Performance
Summary of how each destination URL performed during the analyzed period.
gads:destination_url_performanceFeatured Videos
This table provides detailed information about each advertising ad video on YouTube. It presents data such as the number of views, clicks, cost, view rate and other important indicators so that you can evaluate the individual performance of each video.
gads:featured_videosConversion Actions
All types of custom conversions the campaign received after ad interactions.
gads:custom_conversion_actionsSearch Terms
Summary of performance of your search terms during the analyzed period. Search terms are the terms used by a significant number of people that resulted in your ad being displayed at the time of search.
gads:search_termFeatured placements
Performance summary of the placements your ads appeared on during the review period. Placements are where your ads appear on YouTube or the Google Display Network. A placement can be a specific website or page, a mobile app, video content, or an individual ad unit.
gads:detail_group_placementFeatured Ads
Summary of the performance of your non-smart ads in the period analyzed.
gads:ads_summary_tableFeatured Text Ads
Summary of the performance of your ads, in the analyzed period.
gads:text_ads_summary_tablePerformance by city
This table details the performance of ads targeted by different cities. It allows you to evaluate how your campaigns are performing in specific cities, helping you identify which cities are generating the most clicks and conversions.
gads:performance_by_cityPerformance by state
This table details the performance of ads targeted by different states. It allows you to evaluate how your campaigns are performing in specific states, helping you identify which states are generating the most clicks and conversions.
gads:performance_by_statePerformance by region
This table details the performance of ads targeted by different states. It allows you to evaluate how your campaigns are performing in specific states, helping you identify which states are generating the most clicks and conversions.
gads:performance_by_regionPerformance by airport
This table details the performance of ads targeted by different airports. It allows you to evaluate how your campaigns are performing in specific airports, helping you identify which airports are generating the most clicks and conversions.
gads:performance_by_airportPerformance by county
This table details the performance of ads targeted by different counties. It allows you to evaluate how your campaigns are performing in specific counties, helping you identify which counties are generating the most clicks and conversions.
gads:performance_by_countyPerformance by district
This table details the performance of ads targeted by different districts. It allows you to evaluate how your campaigns are performing in specific districts, helping you identify which districts are generating the most clicks and conversions.
gads:performance_by_districtPerformance by postal code
This table details the performance of ads targeted by different postal codes. It allows you to evaluate how your campaigns are performing in specific postal codes, helping you identify which postal codes are generating the most clicks and conversions.
gads:performance_by_postal_codePerformance by metro
This table details the performance of ads targeted by different metros. It allows you to evaluate how your campaigns are performing in specific metros, helping you identify which metros are generating the most clicks and conversions.
gads:performance_by_metroPerformance by country
This table details the performance of ads targeted by different countries. It allows you to evaluate how your campaigns are performing in specific countries, helping you identify which countries are generating the most clicks and conversions.
gads:performance_by_countryAsset Group Performance PMAX
Detailed performance by Asset Group
gads:pmax_asset_group_performanceAsset Performance PMAX
Performance of each creative asset
gads:pmax_asset_performanceLocation Performance PMAX
Performance by geographic region
gads:pmax_location_performance
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
