Forecast

  • Effective frequency breakdowns list forecasts ordered by frequency, starting from 1+.

  • On-target reach indicates unique people reached within the targeting criteria.

  • Total reach includes all unique people reached, potentially exceeding the specified targeting.

  • On-target impressions are ad impressions that exactly match the targeting.

  • Total impressions include all ad impressions, including those outside the specified targeting.

  • Viewable impressions represent ad impressions considered viewable according to Google's criteria.

  • Co-view reach metrics account for unique people reached, including co-viewers, both within and outside the targeting.

  • Co-view impressions metrics provide ad impressions including co-viewers, both within and outside the targeting.

  • Conversions track the number of conversions, available only for DEMAND_GEN products.

  • TrueView views are counted when viewers watch a significant portion or the entire ad.

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.

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.

trueview_views

int64

Number of ad views forecasted for the specified product and targeting. A TrueView 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 TrueView Views.