To provide a more streamlined and reliable experience, we have unified our forecasting infrastructure. Google Ads API v24 introduces an updated GenerateKeywordForecastMetrics
What's changing?
To streamline our systems and focus on the primary data that drives successful Search planning, Google Ads API v24 introduces the following refinements:
1. Alignment with Bidding Strategies
To provide a more consistent experience across Google Ads tools, forecasts now focus exclusively on the primary metrics that your chosen bidding strategy directly impacts. This alignment ensures that the data you use for planning is synchronized with the high-impact performance indicators for your actual campaigns:
Manual CPC and Maximize Clicks : Forecasts provide clicks, average CPC, and cost.
Maximize Conversions : Forecasts provide conversions, average CPA, and cost.
Metric Focus : To maintain consistency across the platform, forecasts no longer include cross-metric data (such as conversion estimates for click-oriented strategies) or secondary metrics like impressions and conversion value.
2. Streamlined Request Parameters
We have made the following updates to simplify forecasting requests, improve system reliability, and remove inputs which have a minimal effect on overall forecast accuracy:
Timeline
The transition follows our standard release and sunset cycle:
April 2026 : Google Ads API v24 is available with the updated GenerateKeywordForecastMetrics functionality.
February 2027 : Google Ads API v23 is scheduled for sunset . At this time, all versions of the Google Ads API will utilize this unified forecasting infrastructure.
Next Steps
Developers that use GenerateKeywordForecastMetrics should review their integrations to ensure compatibility with the updated parameter set in v24. Review the Generate Forecast Metrics guide and the GenerateKeywordForecastMetrics
If you have any questions about this announcement or want to discuss it with our team and the community, please reach out to us on our Ads and Measurement Community Discord server .
