PlannedProductForecast

  • On-target reach and impressions represent unique people reached and ad impressions that exactly match the targeting.

  • Total reach and impressions include people and impressions that may fall outside the specified targeting.

  • Co-view metrics (on_target_coview_reach, total_coview_reach, on_target_coview_impressions, total_coview_impressions) account for unique people and impressions including co-viewers.

  • Viewable impressions count the number of times an ad's impressions were considered viewable based on specific criteria.

  • Additional metrics include average frequency for Target Frequency campaigns, views which are counted when a larger portion of an ad is watched, and conversions for DEMAND_GEN products.

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.