Forecast
Stay organized with collections
Save and categorize content based on your preferences.
Forecasted traffic metrics for the planned products and targeting.
| Fields |
effective_frequency_breakdowns[]
|
EffectiveFrequencyBreakdown
A list of effective frequency forecasts. The list is ordered starting with 1+ and ending with the value set in GenerateReachForecastRequest.effective_frequency_limit. If no effective_frequency_limit was set, this list will be empty.
|
on_target_reach
|
int64
Number of unique people reached at least GenerateReachForecastRequest.min_effective_frequency or GenerateReachForecastRequest.effective_frequency_limit times that exactly matches the Targeting. Note that a minimum number of unique people must be reached in order for data to be reported. If the minimum number is not met, the on_target_reach value will be rounded to 0.
|
total_reach
|
int64
Total number of unique people reached at least GenerateReachForecastRequest.min_effective_frequency or GenerateReachForecastRequest.effective_frequency_limit times. This includes people that may fall outside the specified Targeting. Note that a minimum number of unique people must be reached in order for data to be reported. If the minimum number is not met, the total_reach value will be rounded to 0.
|
on_target_impressions
|
int64
Number of ad impressions that exactly matches the Targeting.
|
total_impressions
|
int64
Total number of ad impressions. This includes impressions that may fall outside the specified Targeting, due to insufficient information on signed-in users.
|
viewable_impressions
|
int64
Number of times the ad's impressions were considered viewable. See https://support.google.com/google-ads/answer/7029393 for more information about what makes an ad viewable and how viewability is measured.
|
on_target_coview_reach
|
int64
Number of unique people reached that exactly matches the Targeting including co-viewers.
|
total_coview_reach
|
int64
Number of unique people reached including co-viewers. This includes people that may fall outside the specified Targeting.
|
on_target_coview_impressions
|
int64
Number of ad impressions that exactly matches the Targeting including co-viewers.
|
total_coview_impressions
|
int64
Total number of ad impressions including co-viewers. This includes impressions that may fall outside the specified Targeting, due to insufficient information on signed-in users.
|
views
|
int64
Number of ad views forecasted for the specified product and targeting. A view is counted when a viewer views a larger portion or the entirety of an ad beyond an impression. See https://support.google.com/google-ads/answer/2375431 for more information on views.
|
conversions
|
double
The number of conversions. This metric is only available for DEMAND_GEN plannable products. See https://support.google.com/google-ads/answer/2375431 for more information on conversions.
|
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-08-07 UTC.
[null,null,["Last updated 2025-08-07 UTC."],[],[],null,["# Forecasted traffic metrics for the planned products and targeting.\n\n| Fields ||\n|----------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `effective_frequency_breakdowns[]` | [EffectiveFrequencyBreakdown](/google-ads/api/reference/rpc/v19/EffectiveFrequencyBreakdown) A list of effective frequency forecasts. The list is ordered starting with 1+ and ending with the value set in GenerateReachForecastRequest.effective_frequency_limit. If no effective_frequency_limit was set, this list will be empty. |\n| ### `on_target_reach` | `int64` Number of unique people reached at least GenerateReachForecastRequest.min_effective_frequency or GenerateReachForecastRequest.effective_frequency_limit times that exactly matches the Targeting. Note that a minimum number of unique people must be reached in order for data to be reported. If the minimum number is not met, the on_target_reach value will be rounded to 0. |\n| ### `total_reach` | `int64` Total number of unique people reached at least GenerateReachForecastRequest.min_effective_frequency or GenerateReachForecastRequest.effective_frequency_limit times. This includes people that may fall outside the specified Targeting. Note that a minimum number of unique people must be reached in order for data to be reported. If the minimum number is not met, the total_reach value will be rounded to 0. |\n| ### `on_target_impressions` | `int64` Number of ad impressions that exactly matches the Targeting. |\n| ### `total_impressions` | `int64` Total number of ad impressions. This includes impressions that may fall outside the specified Targeting, due to insufficient information on signed-in users. |\n| ### `viewable_impressions` | `int64` Number of times the ad's impressions were considered viewable. See \u003chttps://support.google.com/google-ads/answer/7029393\u003e for more information about what makes an ad viewable and how viewability is measured. |\n| ### `on_target_coview_reach` | `int64` Number of unique people reached that exactly matches the Targeting including co-viewers. |\n| ### `total_coview_reach` | `int64` Number of unique people reached including co-viewers. This includes people that may fall outside the specified Targeting. |\n| ### `on_target_coview_impressions` | `int64` Number of ad impressions that exactly matches the Targeting including co-viewers. |\n| ### `total_coview_impressions` | `int64` Total number of ad impressions including co-viewers. This includes impressions that may fall outside the specified Targeting, due to insufficient information on signed-in users. |\n| ### `views` | `int64` Number of ad views forecasted for the specified product and targeting. A view is counted when a viewer views a larger portion or the entirety of an ad beyond an impression. See \u003chttps://support.google.com/google-ads/answer/2375431\u003e for more information on views. |\n| ### `conversions` | `double` The number of conversions. This metric is only available for DEMAND_GEN plannable products. See \u003chttps://support.google.com/google-ads/answer/2375431\u003e for more information on conversions. |"]]
