To discuss and provide feedback on our products, join the official Google Ads Discord channel in the Google Advertising and Measurement Community server.

KeywordPlanAggregateMetricResults

AI-generated Key Takeaways

This content describes the aggregated historical metrics for keyword plan keywords.
It includes a table detailing the device_searches[] field.
The device_searches[] field provides aggregate searches segmented by device type (MOBILE, TABLET, DESKTOP) for a specified time.
The device_searches[] field is only set when the DEVICE type is specified in the KeywordPlanAggregateMetrics field of the request.

The aggregated historical metrics for keyword plan keywords.

Fields

Fields
`device_searches[]`	`KeywordPlanDeviceSearches` The aggregate searches for all the keywords segmented by device for the specified time. Supports the following device types: MOBILE, TABLET, DESKTOP. This is only set when KeywordPlanAggregateMetricTypeEnum.DEVICE is set in the KeywordPlanAggregateMetrics field in the request.

The aggregate searches for all the keywords segmented by device for the specified time. Supports the following device types: MOBILE, TABLET, DESKTOP.

This is only set when KeywordPlanAggregateMetricTypeEnum.DEVICE is set in the KeywordPlanAggregateMetrics field in the request.

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 2025-11-14 UTC.