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.

Proto definition

Fields

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.

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_coview_impressions

int64

Number of ad impressions that exactly matches the Targeting including co-viewers.

on_target_coview_reach

int64

Number of unique people reached that exactly matches the Targeting including co-viewers.

on_target_impressions

int64

Number of ad impressions that exactly matches the Targeting.

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_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.

total_coview_reach

int64

Number of unique people reached including co-viewers. This includes people that may fall outside the specified 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.

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.

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.

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.