**Important:** This feature is available to allowlisted accounts only. Contact your Google representative if you need access to the feature.
[`ReachPlanService`](https://developers.google.com/google-ads/api/reference/rpc/v26/ReachPlanService) enables media agencies and third-party media planning software companies to accurately forecast the commercial reach of video campaigns on YouTube and Google Video Partners. Media planners can use the service to answer questions such as: - How much investment on YouTube would it take to meet a campaign's reach goals? - How much of a target audience could a campaign reach for a given budget? - What is the optimal budget allocation between YouTube and other media channels if I have a campaign optimizing for reach? [Reach Planner](https://ads.google.com/intl/en_in/home/tools/reach-planner/), available from the [Google Ads web interface](https://ads.google.com), contains many of the same features. ## Before you begin Complete the [Get started guide](https://developers.google.com/google-ads/api/docs/get-started/introduction) to ensure that you can connect to the Google Ads API before trying to connect to `ReachPlanService`. This guide also assumes that you're familiar with [Google Ads](https://ads.google.com) and media planning concepts. ## Eligibility requirements `ReachPlanService` is a private component of the Google Ads API offered with a non-exclusive, royalty-free data license. Signed partners can use the standard [Google Ads client libraries](https://developers.google.com/google-ads/api/docs/client-libs) to generate media plans. To be eligible, partners must satisfy the following conditions: - Have a planning tool or user interface that will integrate the API. - Use the API to produce media plans and estimate campaign reach and cost. - Complete a pre-screen assessment as outlined in the following section. - Follow data usage requirements and be willing to undergo periodic data audits. - Accept the Google Ads API [terms of service](https://developers.google.com/google-ads/api/docs/api-policy/terms) and the associated data usage policy. Contact your Google representative for more information. If you attempt to call `ReachPlanService` using a Google Cloud project that hasn't been added to the allowlist to use this service, the API returns an `AuthorizationError.USER_PERMISSION_DENIED` error. ### Pre-screen assessment Partners must complete a pre-screen assessment for each planning tool that would use the API. Google then assesses the data security, methodologies, and outputs of planning tools with questions such as: - How are users authenticated? - How is the usage of your tool tracked? - When building plans, which metrics can users optimize? For example: reach, impact, impressions, frequency. - How does your tool deduplicate channels? - Does your tool apply a default *weight* or *effectiveness score* to each channel in a plan? ## Product mixes and surfaces In the Google Ads API, a product mix represents a combination of ad formats and settings designed to achieve specific reach goals within a media plan. [`ReachPlanService`](https://developers.google.com/google-ads/api/reference/rpc/v26/ReachPlanService) provides granular control and reporting around surfaces, which are key components in defining a product mix. ### Understand surfaces *Surfaces* refer to the different environments where your ads can be shown, such as YouTube In-Stream, YouTube Shorts, and Google Video Partners. When planning, you can define product mixes based on specific surface offerings. The supported surface combinations for each product depend on your target location and currency, and are available through [`ListPlannableProducts`](https://developers.google.com/google-ads/api/reference/rpc/v26/ReachPlanService/ListPlannableProducts) in [`ReachPlanService`](https://developers.google.com/google-ads/api/reference/rpc/v26/ReachPlanService). ### Options for targeting When constructing your product mix, you can also specify detailed targeting. See [Audience targeting](https://developers.google.com/google-ads/api/docs/reach-forecasting/media-plan#audience-targeting) for details. ## Generate a reach forecast A typical reach forecasting workflow follows these steps: 1. Get supported locations using [`ListPlannableLocations`](https://developers.google.com/google-ads/api/reference/rpc/v26/ReachPlanService/ListPlannableLocations). 2. Fetch available products and surfaces for a target location using [`ListPlannableProducts`](https://developers.google.com/google-ads/api/reference/rpc/v26/ReachPlanService/ListPlannableProducts). 3. Request reach estimates using [`GenerateReachForecast`](https://developers.google.com/google-ads/api/reference/rpc/v26/ReachPlanService/GenerateReachForecast) in [`ReachPlanService`](https://developers.google.com/google-ads/api/reference/rpc/v26/ReachPlanService). The forecast provides estimated reach and other metrics for your planned campaign. For details on the forecast output and product-specific considerations, see the [Generate a reach curve](https://developers.google.com/google-ads/api/docs/reach-forecasting/generate-curve) guide. For definitions of metrics like reach and impressions, see the [Glossary of terms](https://developers.google.com/google-ads/api/docs/reach-forecasting/concepts#glossary-of-terms). ## What's next - Review the [Concepts](https://developers.google.com/google-ads/api/docs/reach-forecasting/concepts) behind `ReachPlanService`. - Learn how to handle [Authentication](https://developers.google.com/google-ads/api/docs/reach-forecasting/authentication) for the service. - View [code examples](https://developers.google.com/google-ads/api/docs/reach-forecasting/generate-curve#code-example) for reach planning in your preferred client library language. ## Google Issue Tracker Use Google Issue Tracker to ask support questions, report bugs, or submit feature requests. Google tracks, prioritizes, and posts updates on your requests directly in Issue Tracker. For more information, see [Create an issue in Google Issue Tracker](https://developers.google.com/issue-tracker/guides/create-issue-ui). Create an issue by using one of the following Issue Tracker templates: - [Ask a general support question or submit documentation feedback](https://issuetracker.google.com/issues/new?component=2315943&template=2440256) - [Report a technical bug](https://issuetracker.google.com/issues/new?component=2315943&template=2440158) - [Submit an API feature request](https://issuetracker.google.com/issues/new?component=2315943&template=2440255) Fill out all fields in the template with detailed information so that Google can reproduce and prioritize your request. Google might close incomplete reports and ask you to submit a new issue with the missing details.