Google Ads Developer Blog: keywords

Simplifying Keyword Forecast Metrics in Google Ads API v24

neljapäev, 23. aprill 2026

To provide a more streamlined and reliable experience, we have unified our forecasting infrastructure. Google Ads API v24 introduces an updated GenerateKeywordForecastMetrics method that simplifies the planning process by focusing on the metrics that most directly impact your performance. 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:

CampaignToForecast.geo_modifiers[] is replaced by CampaignToForecast.geo_target_constants[]

ForecastAdGroup.biddable_keywords[] is replaced by ForecastAdGroup.keywords[].

The following fields are removed:

CampaignToForecast.keyword_plan_network
CampaignToForecast.negative_keywords
ForecastAdGroup.max_cpc_bid_micros
ForecastAdGroup.negative_keywords
CriterionBidModifier

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 v24 reference for the latest usage details. 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.

- Laura Chevalier, Google Ads API Team

Broad match modifier upcoming changes in Google Ads

teisipäev, 29. juuni 2021

changes to phrase match and broad match modifierAugust 2, 2021AdWords APIGoogle Ads APIGoogle Ads scriptsarticleencouragedkeyword matching optionsforum

David Wihl, Google Ads API Team

Changes to phrase match and broad match modifier

neljapäev, 4. veebruar 2021

February 4, 2021changes to phrase match and broad match modifierAdWords APIGoogle Ads APIGoogle Ads scriptsHow does this change affect the AdWords API, Google Ads API and Google Ads scripts?What impact should advertisers expect?

Advertisers predominantly using phrase match are expected to see an incremental increase in clicks and conversions

This is due to the additional queries to which these keywords will now be eligible to match. For example, “holidays in zambia” as a phrase keyword will now begin to match to “holiday spots in zambia”, which was previously only eligible for BMM.

Advertisers predominantly using BMM are expected to see a slight decrease in clicks and conversions

The majority of this loss is from BMMs where the modifier was only applied to part of the keyword, e.g. tennis +shoes.
In addition we are now considering word order when it’s important to the meaning of the keyword, so some matches that previously matched to BMM will be filtered out.

What should I do?the announcementforum

David Wihl, Google Ads API Team

New dates for quality score changes in AdWords scripts

reede, 16. september 2016

We recently announced some changes to the way AdWords scripts returns quality score data for keywords. To give developers more time to review their scripts that rely on Quality Scores in preparation for this update, null Quality Scores will now roll out on the the week of October 10th, 2016.

If you need help updating your script, or have any questions about these changes or AdWords scripts in general, you can post them on our developer forum.

Anash P. Oommen, AdWords Scripts Team

Changes to quality score in AdWords scripts

esmaspäev, 15. august 2016

We are making some changes to the way AdWords scripts returns quality score data for keywords.

We will return a null quality score for keywords that don’t have enough impressions and clicks to determine a Quality Score, such as new keywords or old ones that haven't served a long time. This will impact your scripts in two ways:

Reports: Starting with version v201607, the Critieria Performance and Keywords Performance reports will return a quality score of “--” for these keywords. Past versions (v201605 and earlier) of these reports will remain unchanged.
getQualityScore method: Starting the week of Sep 12, 2016, the getQualityScore method of the Keyword entity will return NULL score for these keywords instead of a numeric value.

If you use use quality score information in your script, please make sure you update it to work with the new changes.

Filtering on quality score

Filtering on quality score will work as follows:

If no filtering conditions are specified on the QualityScore field, all matching keywords are returned, including those with NULL quality score.
If numerical filtering conditions are specified on the QualityScore field, keywords with NULL quality score information are excluded automatically. For example, QualityScore <= 6 will include keywords with quality score from 1 to 6 but exclude keywords with NULL quality score.
To retrieve keywords with NULL quality score, filter using the condition HasQualityScore = FALSE.
To retrieve keywords with NULL quality score along with keywords with specific quality scores, you need to run two separate reports and combine the results locally.

If you have any questions about these changes or AdWords scripts in general, you can post them on our developer forum.

Anash P. Oommen, AdWords Scripts Team

Introducing the Keyword Optimizer sample app for the AdWords API

reede, 4. märts 2016

In AdWords, finding the right keywords to trigger your ads is one of the main drivers of success — yet a major challenge at the same time. You can use our Keyword Planner to browse for new keyword ideas, or utilize the AdWords API services for keyword suggestion and traffic estimation to find and evaluate keywords at scale.

But wait, now there’s more! We’ve just released KeywordOptimizer, a sample app showcasing how to combine these services to find the perfect set of keywords. Starting from an initial set of seed keywords (obtained using a sample URL, business category etc.), the iterative process repeatedly discards low-quality keywords and “reproduces” high-quality ones. With each step, the average quality across all keywords increases, just like evolution!

KeywordOptimizer is designed to provide guidance on how to use the TargetingIdeaService and TrafficEstimatorService. Simply run it from the command-line to get a CSV file with keywords and estimation with minimal effort. Advanced users can easily extend the tool with custom implementations. For example, you can change the calculation for the keyword quality score to combine clicks with impressions, or your own metrics in a way that works best for you.

Get started with Keyword Optimizer’s GitHub repository. Feel free to ask questions or give feedback via the project’s issue tracker, the AdWords API Forum, or our Google+ page.

Timo Bozsolik, AdWords API Team

Ads Developer Blog