PlannedProductForecast
Stay organized with collections
Save and categorize content based on your preferences.
Forecasted traffic metrics for a planned product.
| Fields |
on_target_reach
|
int64
Number of unique people reached 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
Number of unique people reached. 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.
|
average_frequency
|
double
The number of times per selected time unit a user will see an ad, averaged over the number of time units in the forecast length. This field will only be populated for a Target Frequency campaign. See https://support.google.com/google-ads/answer/12400225 for more information about Target Frequency campaigns.
|
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[],[],null,["Forecasted traffic metrics for a planned product.\n\n| Fields ||\n|--------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `on_target_reach` | `int64` Number of unique people reached 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` Number of unique people reached. 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| `average_frequency` | `double` The number of times per selected time unit a user will see an ad, averaged over the number of time units in the forecast length. This field will only be populated for a Target Frequency campaign. See \u003chttps://support.google.com/google-ads/answer/12400225\u003e for more information about Target Frequency campaigns. |\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. |"]]
