keyword_forecasts field has disappeared in GenerateForecastMetricsResponse

[조경호]

I have used GenerateForecastMetricsRequest.

> https://developers.google.com/google-ads/api/reference/rpc/v13/GenerateForecastMetricsRequest

But Today

GenerateForecastMetricsResponse don't have keyword_forecasts field.

> https://developers.google.com/google-ads/api/reference/rpc/v13/GenerateForecastMetricsResponse#:~:text=ad%20group%20forecasts.-,keyword_forecasts,-%5B%5D

The keyword_forecasts field has disappeared.

What was going on?

Google Ads Status Dashboard is all green.

https://ads.google.com/status/publisher/

I still have a problem.

[Google Ads API Forum Advisor]

Hi,

Thanks for reaching out to Google Ads API Forum.

With regards to your concern, based on our Blog post KeywordPlanAdGroupForecast and KeywordPlanKeywordForecast will be deprecated in the Google Ads API. This change will be effective on June 1, 2023. 

Starting June 1, the GenerateForecastMetricsRequest will still be used to fetch forecasts, but the KeywordPlanAdGroupForecast and KeywordPlanKeywordForecast will be empty. The KeywordPlanCampaignForecast will be returned as usual. If you are using KeywordPlanAdGroupForecast or KeywordPlanKeywordForecast in your applications, update your applications to ensure that they can handle blank responses. 

Links included in this email:

• Blog - https://ads-developers.googleblog.com/2023/04/ad-group-and-keyword-forecasts-being.html 
• GenerateForecastMetricsRequest - https://developers.google.com/google-ads/api/reference/rpc/v13/GenerateForecastMetricsRequest 
• KeywordPlanCampaignForecast - https://developers.google.com/google-ads/api/reference/rpc/v13/KeywordPlanCampaignForecast 
• Generate Forecast Metrics - https://developers.google.com/google-ads/api/docs/keyword-planning/generate-forecast-metrics

 

This message is in relation to case "ref:_00D1U1174p._5004Q2lw59Y:ref"

Thanks,
 

Google Ads API Team

[Aqeel Ashraf]

Hi,

Is there any example available that how to use  KeywordPlanCampaignForecast 

I can't find the like it is available for Generate Forecast Metrics (https://developers.google.com/google-ads/api/docs/keyword-planning/generate-forecast-metrics)

[Mnk]

Hey,

I posting something like you, i follow the answers.

After a lot of hours i didn't find a way for replace the existing code to get a response :(

[Patrick P]

The documented examples Google Ads API Forum Advisor linked in that post / documentation are not functional. They also return null values.

Several of us have had this code in production, are not using the two deprecated calls, and are adhering to Google's documentation but we have been unable to get an acknowledgement / response from Google about it

[Google Ads API Forum Advisor]

Hi all,

Thank you for getting back to us.

Please see my responses for your concerns respectively.

• “Is there any example available of how to use KeywordPlanCampaignForecast. I can't find the like it is available for Generate Forecast Metrics (https://developers.google.com/google-ads/api/docs/keyword-planning/generate-forecast-metrics)”
  • You may check this guide (​​https://developers.google.com/google-ads/api/rest/reference/rest/v13/customers.keywordPlans/generateForecastMetrics#keywordplancampaignforecast) for reference in using KeywordPlanCampaignForecast. You may try using the API explorer (https://developers.google.com/google-ads/api/rest/reference/rest/v13/customers.keywordPlans/generateForecastMetrics?apix=true#KeywordPlanCampaignForecast) for customizing and validating your request body. Please let us know how it goes. 
• “After a lot of hours i didn't find a way for replace the existing code to get a response” and “The documented examples Google Ads API Forum Advisor linked in that post / documentation are not functional. They also return null values.”
  •  Regarding these concerns, as mentioned in our previous response, starting June 1, the GenerateForecastMetricsRequest (https://developers.google.com/google-ads/api/reference/rpc/v13/GenerateForecastMetricsRequest ) will still be used to fetch forecasts, but the KeywordPlanAdGroupForecast and KeywordPlanKeywordForecast will be empty. The KeywordPlanCampaignForecast (https://developers.google.com/google-ads/api/reference/rpc/v13/KeywordPlanCampaignForecast) will be returned as usual. 

There is no example for using KeywordPlanCampaignForecast for now. In the meantime, you may refer to this guide (https://developers.google.com/google-ads/api/docs/keyword-planning/generate-forecast-metrics#generate-metrics). 

[Aqeel Ashraf]

Hi,

I tried but not able to get any help from guide (https://developers.google.com/google-ads/api/docs/keyword-planning/generate-forecast-metrics#generate-metrics). Could you guys please let us know when we will be able to see an example? Thanks

[Google Ads API Forum Advisor]

Hi Aqeel,

Thanks for getting back to us.

There is no definite timeline for the availability for code examples in our documentation. However, you may also check with the Client library owner by opening an issue with the Issue Tracker in GitHub with your chosen client library. 

[Aqeel Ashraf]

Hi,

I generate an issue in GitHub Issue Tracker and finally manage to make it workable. But now, I have an issue with the response. 

I need to get the response against the multiple keywords, but it only returns the response against the last keyword I used. I raised the same issue at GitHub Issue tracker (https://github.com/googleads/google-ads-php/issues/920) but I received following response:

Since it's related to the result of the API server, could you please ask on the Google Ads API forum?
Make sure you also share your request and response log. Thank you.  

Let me explain below:

Please see the keyword that I passed one keyword at a time: 

Keyword: plombier 

Response: A 

--------------------------- 

Keyword: garde meuble 

Response: B 

--------------------------- 

Keyword: location voiture 

Response: C 

--------------------------- 

Like I mentioned above, all 3 keyword shows different response but when I pass all keywords in one request, what I get: 

Keyword: plombier, garde meuble, location voiture 

Response: C (Which is same when I pass single keyword: location voiture) 

--------------------------- 

Keyword: location voiture, plombier, garde meuble 

Response: B (Which is same when I pass single keyword: garde meuble) 

--------------------------- 

Keyword: location voiture, garde meuble, plombier 

Response: A (Which is same when I pass single keyword: plombier) 

--------------------------- 

So, it works fine when I use one keyword but in case of multiple keywords, the response should not be the same as per the last keyword I used. Please let me know if you guys need further details. Log file is also attached. Thanks

[Google Ads API Forum Advisor]

Hi Aqeel, 

Thank you for coming back and for the update. I hope you are doing well today.

With regards to your concern, could you please confirm if you already reached out to the Github where the sample code came from for this concern? If not yet, we recommend confirming this issue to the Github team.

However, since you also mentioned that this is also related to API, if you're encountering Google Ads API issues or errors, for our team to further compare, investigate, and validate why you are encountering issues, can you provide more information?
 

• Provide the complete (request and response with request-id) logs with request ID generated as shown in the respective links.
• Complete or uncropped screenshots from the Google Ads UI (optional)

We do this to check if there’s an error thrown on your side and provide accurate recommendations. 

If you haven't enabled logging yet, it can be enabled by navigating to the Client libraries > Your client library (ex. Java) > Logging documentation, which you can access from this link. For REST interface requests, you can enable logging via the curl command by using the -i flag. This will cause the tool to include the HTTP response headers in the output.

Reference links:

• Logging documentation - https://developers.google.com/google-ads/api/docs/best-practices/logging#client_library_logging
• Request - https://developers.google.com/google-ads/api/docs/concepts/field-service#request
• Response - https://developers.google.com/google-ads/api/docs/concepts/field-service#response
• Request-id - https://developers.google.com/google-ads/api/docs/concepts/call-structure#request-id

Have a great day.
 

[Aqeel Ashraf]

Hi,

Quite disappointed with the reply. I already mentioned all details that includes GitHub issue tracker URL and its reply as well as attached the log file. Looks like I got the generic reply and not even read the details what I mentioned. Please have a look on the details above and provide appropriate response. I am not the only one who is facing the same issue, many peoples facing the same.

[Google Ads API Forum Advisor]

Hi Aqeel,

Thank you for getting back to us. Allow me to raise this concern to the rest of our team and rest assured that we will get back to you as soon as we have some updates.

[Aqeel Ashraf]

Hi,

Thanks for the response. I am eagerly waiting for the solution and hope I will get the good reply.

[Google Ads API Forum Advisor]

Hi,

Thank you for your patience.

Upon checking, we are unable to replicate the behavior your reported. As per testing, we were able to get the expected output. 

Please see further details below:

Keyword: plombier
Response: 

 

 

---------------------------

Keyword: garde meuble
Response: 

 

---------------------------

 

Keyword: location voiture
Response: 

 

---------------------------

 

Combining the 3 keywords:

 

First request:

Keyword: plombier, garde meuble, location voiture
Response: 

 

---------------------------

 

Keyword: location voiture, plombier, garde meuble
Response: 

 

---------------------------

 

Keyword: location voiture, garde meuble, plombier
Response: 

 

---------------------------

As you may have referred to our documentation, the expected response will only contain the data found here.

Let me know if you have any questions or if the issue persists on your end, provide us with the logs for the all of the scenarios you listed which shows the issue in your end so we can further investigate.
 

[Google Ads API Forum Advisor]

Hi Aqeel,

I hope all is well. 

I would like to double check if the issue described on your forum thread "When using multiple keywords, generateKeywordForecastMetrics it only returns the response against the last keyword I used" dated on July 4, 2023 has been resolved on your end or not. I would like to provide my additional insights on your described concern, and I did perform all the steps to check to see if indeed said behavior was observed or not. 

So, let me provide you additional insights with my replications based on your concern description. I tried to use multiple keywords and see the response, then I saw that it had a different response when I used only 1 keyword. 

Also, I tried to put a keyword sequence like how you were added in your request, but still I couldn’t see the observations that you described. You may see below screenshot showing requests with different keywords variations along with responses for each request for better understanding:

If you are still seeing behavior that you mentioned, could you please privately provide the latest full logs(complete request and response logs with request ID and request header) showing the behavior, so that we can investigate the issue further?