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"
      ]
    }
  ]
}
Example: "Clicks" in October, compared to September.

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:clicks
  • Campaigns count

    Number of campaigns that had some investment.

    gads:count_campaigns
  • Ads count

    Number of ads that had some investment.

    gads:count_ads
  • All 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_conversions
  • Conversions 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_value
  • All 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_value
  • Conversions

    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:conversions
  • Impressions

    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:impressions
  • Video 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_views
  • CTR

    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:ctr
  • Cost

    How much money you have spent on your ad campaign in the specified time period.

    gads:cost_micros
  • Cost 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_conversions
  • Cost Per Conversion

    Total cost divided by all conversions.

    gads:cost_per_conversion
  • Average 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_cpm
  • Average 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_cpc
  • Average 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_cpv
  • Conversion 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_rate
  • ROAS

    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:roas
  • All 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_cost
  • Conversions 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_cost
  • Phone 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_calls
  • View 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_rate
  • Video conversions

    Number of times viewers took the desired action after watching the video ad during the analyzed period.

    gads:video_conversions
  • Video 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_rate
  • Videos 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_ctr
  • Video 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_impressions
  • Video clicks

    Number of times the viewer clicked on the video ad during its display in the analyzed period.

    gads:video_clicks
  • Interaction 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_rate
  • Interactions

    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_percentage
  • Engagements

    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:engagements
  • Engagement 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_rate
  • Average 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_percentage
  • Search 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_share
  • Page Views

    The number of times a page was viewed after an ad interaction.

    gads:conversions_page_views
  • Add to Cart

    Number of times products were added to the shopping cart by users after interacting with ads.

    gads:conversion_add_to_cart
  • Begin Checkout

    The number of times a person started the checkout process after an ad interaction.

    gads:conversion_begin_checkout
  • Purchase

    Number of transactions completed through ads, indicating how many Purchases/sales were generated directly by Google Ads campaigns.

    gads:conversion_purchase
  • Book Appointment

    The number of times an appointment was booked after an ad interaction.

    gads:conversion_book_appointment
  • Contacts

    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_contact
  • Download

    Number of file or application downloads that were made after users clicked on ads during the analyzed period.

    gads:conversion_download
  • Converted 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_lead
  • Conversions (Engagement)

    The number of times a person engaged with your ad after an ad interaction.

    gads:conversion_engagement
  • Get directions

    The number of times a person requested directions to your business after an ad interaction.

    gads:conversion_get_directions
  • Outbound Click

    The number of times a person clicked on a link to another site after an ad interaction.

    gads:conversion_outbound_click
  • Phone 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_lead
  • Qualified 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_lead
  • Request Quote

    The number of times a person requested a quote after an ad interaction.

    gads:conversion_request_quote
  • Subscriptions

    Number of times someone signed up for a newsletter or free trial, created an account, or pre-registered.

    gads:conversion_sign_up
  • Store Visits

    Number of customers who received or clicked on your online ads and then visited your physical store.

    gads:conversion_store_visit
  • In-store sales

    Number of offline purchases that occurred after customers interacted with your Google ads.

    gads:conversion_store_sale
  • Submit 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_form
  • Submit 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_conversions
  • Subscribe Paid

    This metric counts the number of signups or registrations made by users after clicking on an ad.

    gads:conversion_subscribe_paid
  • PTR

    The total number of calls (phone calls) received divided by the number of times your phone number was displayed (phone number printouts).

    gads:ptr
  • Cost 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_device
  • Clicks and CTR Over Time

    This graph displays the number clicks and percentage of CTR in the time frame specified

    gads:clicks_ctr_per_day
  • Conversions 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_device
  • Impressions by Gender

    This graph displays the number of impressions that your ads generated, grouped by the gender.

    gads:impressions_by_gender
  • Impressions by Age

    This graph displays the number of impressions that your ads generated, grouped by the age range.

    gads:impressions_by_age
  • Cost by Device

    Cost of your ads, grouped by the device that the person was using.

    gads:cost_per_device
  • All 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_day
  • Conversions 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_day
  • Cost and Average CPC Over Time

    This graph displays the cost and the average CPC in the time frame specified.

    gads:cost_average_cpc_per_day
  • Video 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_time
  • Video 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_time
  • Conversion 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_time
  • Cost 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_adgroups
  • All Campaigns

    All of your ad campaigns, sorted by clicks.

    gads:top_campaigns
  • Campaign Performance by ID

    All of your ad campaigns with campaign IDs, sorted by clicks.

    gads:campaign_performance_by_id
  • Search Keywords Summary

    All the search keywords that you spent money on, sorted by clicks.

    gads:summary_per_keywords
  • Smart 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_term
  • Destination URL Performance

    Summary of how each destination URL performed during the analyzed period.

    gads:destination_url_performance
  • Featured 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_videos
  • Conversion Actions

    All types of custom conversions the campaign received after ad interactions.

    gads:custom_conversion_actions
  • Search 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_term
  • Featured 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_placement
  • Featured Ads

    Summary of the performance of your non-smart ads in the period analyzed.

    gads:ads_summary_table
  • Featured Text Ads

    Summary of the performance of your ads, in the analyzed period.

    gads:text_ads_summary_table
  • Performance 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_city
  • Performance 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_state
  • Performance 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_region
  • Performance 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_airport
  • Performance 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_county
  • Performance 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_district
  • Performance 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_code
  • Performance 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_metro
  • Performance 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_country
  • Asset Group Performance PMAX

    Detailed performance by Asset Group

    gads:pmax_asset_group_performance
  • Asset Performance PMAX

    Performance of each creative asset

    gads:pmax_asset_performance
  • Location 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.