GenerateKeywordHistoricalMetrics -> HistoricalMetricsOptions 4 years data

[Lex Bunnetat]

GenerateKeywordHistoricalMetrics  only returns 12 months data, but the documentation says up to 4 years. Is the documentation wrong? 

I did find a post in 2020 to say that there was a feature request to increase it to 4 years, and to look at the blog. But unfortunately I cannot see how to access all the blogs since 2020 , ad only see the latest version.

if 4 years data is not possible with the api, is there a way to create the keyword searches on the UI and view and download the data manually - ie do some of the work automatically using the api, and some manually?

  

[Google Ads API Forum Advisor]

Hi,

Thanks for reaching out to Google Ads API Support.

With regards to your first concern, based on our documentation (https://developers.google.com/google-ads/api/docs/keyword-planning/generate-historical-metrics), the averages monthly searches is 12 months, and the approximate monthly search volume is only per months. You can use historical metrics to reduce a large set of keywords to a more manageable size based on the performance. However, if you already know the keywords you want to use, you can skip historical metrics and go straight to forecast metrics.

Moving forward to your second concern, for automatic keywords searches via Google Ads API, you may refer to the Keyword Ideas documentation. Using the KeywordPlanIdeaService, you can search for new keywords that are relevant to your Google Search campaign, or find historical metrics on keywords. 

However, if you want to create the keyword searches via the Google Ads UI, then I recommend reaching out to the Google Ads Product Support Team for further assistance. They can assist you more appropriately regarding these kinds of inquiries. Since our team provides support to technical implementations via the Google Ads API only. For this type of request in the future, please use this link (https://developers.google.com/google-ads/api/support) to file your issue directly.

Links included in this email:

• Google Ads API - https://developers.google.com/google-ads/api/docs/start 
• forecast metrics - https://developers.google.com/google-ads/api/docs/keyword-planning/generate-forecast-metrics
• Keyword Ideas - https://developers.google.com/google-ads/api/docs/keyword-planning/generate-keyword-ideas
• KeywordPlanIdeaService - https://developers.google.com/google-ads/api/reference/rpc/v14/KeywordPlanIdeaService
• Google Ads product support - https://support.google.com/google-ads/gethelp 

 

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

Thanks,
 

Google Ads API Team

[Lex Bunnetat]

Hi 

thanks very much for the response.

sorry,  can I just clarify, the HistoricalMetricsOptions only allows 12 months then, not 4 years as per the documentation?

I will take a look at the  forecast metrics.  but I do not think have what we need.

The other question was about creating the HistoricalMetricsOptions in a campaign using the  API. Then being able to view the data in the UI. So I understand that you cannot therefore speak to the 2nd part of this process, but is it possible to create the campaign with the APi with 4 years using the API, and then view it in the UI.

So far any campaigns we have created do not seem to be visible in the UI.

thanks again

  

[Google Ads API Forum Advisor]

Hello,

Thank you for getting back to us.

I would like to clarify that, when using the GenerateKeywordHistoricalMetricsRequest, the historical_metrics_options field is the options for historical metrics data. If the year_month_range is not specified, metrics for the past 12 months are returned. Please note that search metrics are available for the past 4 years. If the search volume is not available for the entire year_month_range provided, the subset of the year month range for which search volume is available are returned.

That being said, you may pass year_month_range field in your request.

• GenerateKeywordHistoricalMetricsRequest - https://developers.google.com/google-ads/api/reference/rpc/v14/GenerateKeywordHistoricalMetricsRequest
• historical_metrics_options - https://developers.google.com/google-ads/api/reference/rpc/v14/GenerateKeywordHistoricalMetricsRequest#historical_metrics_options
• year_month_range - https://developers.google.com/google-ads/api/reference/rpc/v14/HistoricalMetricsOptions#year_month_range

I hope this clarifies. Let us know if you have any additional questions.