/services/reach_plan_service.proto

  • Introduces PlannableUserListMetadata message to provide relevant metadata for plannable user lists, specifically including the user_list_crm_data_source_type.

  • Replaces the views field with trueview_views in both ForecastedReachForecast and PlannedProductForecastedMetrics messages, along with updated descriptions clarifying they represent TrueView Views.

--- v21/services/reach_plan_service.proto 2025-10-07 23:35:26.000000000 +0000 +++ v22/services/reach_plan_service.proto 2025-10-07 23:35:27.000000000 +0000 @@ -327,8 +328,18 @@   3;   // The plannable status of the user list. - google.ads.googleads.v21.enums.ReachPlanPlannableUserListStatusEnum + google.ads.googleads.v22.enums.ReachPlanPlannableUserListStatusEnum   .ReachPlanPlannableUserListStatus plannable_status = 4; + + // The relevant metadata for this user list. + PlannableUserListMetadata plannable_user_list_metadata = 5; +} + +// The metadata associated with a plannable user list. +message PlannableUserListMetadata { + // The data source type of a CRM based user list. + google.ads.googleads.v22.enums.UserListCrmDataSourceTypeEnum + .UserListCrmDataSourceType user_list_crm_data_source_type = 1;  }  // The targeting for which traffic metrics will be reported. @@ -692,20 +703,20 @@   // insufficient information on signed-in users.   optional int64 total_coview_impressions = 14; - // 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. - optional int64 views = 15; -   // 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.   optional double conversions = 16; + + // 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. + optional int64 trueview_views = 17;  }  // The forecasted allocation and traffic metrics for a specific product @@ -781,20 +792,20 @@   // information about Target Frequency campaigns.   optional double average_frequency = 10; - // 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. - optional int64 views = 11; -   // 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.   optional double conversions = 12; + + // 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. + optional int64 trueview_views = 13;  }  // Audience metrics for the planned products.