Join us live on
Discord on the Google Advertising and Measurement Community server and on
YouTube on August 20th at 10:00 AM EST! We will discuss the new features added in v25.1 of the Google Ads API.
AggregateMetrics
Stay organized with collections
Save and categorize content based on your preferences.
| Fields |
clicks
|
double
The number of clicks received.
|
cost
|
double
The total cost paid by the customer. Cost is represented in USD by default, if unspecified in the request.
|
engagements
|
double
The number of engagements. Engagements are ad interactions such as expanding a lightbox Ad or clicking on a video teaser. See https://support.google.com/google-ads/answer/2375431 for more information on engagements.
|
impressions
|
double
The number of times the Ad was shown to users.
|
interactions
|
double
The number of interactions. Interactions include physical clicks, engagements, and video views that are logged as clicks. See https://support.google.com/google-ads/answer/2375431 for more information on interactions.
|
video_trueview_views
|
double
The number of video TrueView views. See https://support.google.com/google-ads/answer/2375431 for more information on TrueView Views.
|
viewable_impressions
|
double
The number of impressions that are considered viewable according to the Active View criteria. See https://support.google.com/google-ads/answer/7029393 for more information on Active View.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-08-17 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-08-17 UTC."],[],[]]