Forecast

Forecasted traffic metrics for the planned products and targeting.

Proto definition GitHub

Fields

clicks

int64

The number of clicks, which is the main user action associated with an ad format of bid type CPC (Cost-Per-Click).

See https://support.google.com/google-ads/answer/31799 for more information on clicks.

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.