미디어 계획의 타겟팅 설정과 제품 조합을 수집한 후에는 ReachPlanService의 GenerateReachForecast 메서드를 사용하여 예산과 잠재적 도달범위의 곡선을 생성할 수 있습니다. 요청 필드에 관한 자세한 내용은 용어집 및 미디어 계획 가이드를 참고하세요.
예측 측정항목
GenerateReachForecast의 응답에는 Forecast 메시지 내의 다양한 측정항목이 포함되어 계획된 캠페인의 잠재적 실적에 대한 유용한 정보를 제공합니다. 해당하는 측정항목은 다음과 같습니다.
- 도달범위 (타겟층 및 총도달범위, 공동 시청 포함)
- 노출수 (타겟층 및 총계, 공동 시청 및 조회 가능 포함)
- 유효 게재빈도 분석 (순 사용자가 최소 특정 횟수 이상 도달한 횟수, 예: 노출수 1회 이상, 2회 이상 또는 3회 이상)
- 사용자 액션 (TrueView 조회수, 전환수, 클릭수)
디맨드젠 캠페인의 도달범위 예측
계획 가능한 제품 DEMAND_GEN개의 곡선을 생성할 때는 각 제품의 예상 전환율도 포함해야 합니다.
지원되는 계획 가능한 제품의 전환율 추천을 가져오려면 GenerateConversionRates 메서드를 사용하세요. 이 메서드는 계정의 이전 실적을 기반으로 한 전환율 추천 또는 모든 광고주의 실적을 기반으로 한 추천 전환율을 반환합니다.
DEMAND_GEN 제품의 경우 GenerateConversionRates에서 동일한 제품에 대해 여러 추천을 반환할 수 있습니다. 일부 추천에는 surface_targeting 필드가 채워져 있으며, 이는 추천이 특정 표시 경로 조합 (예: YouTube Shorts)에만 적용됨을 나타냅니다. surface_targeting가 채워지지 않으면 추천은 해당 제품의 디맨드젠 캠페인 평균입니다. 표면 타겟팅이 있는 디맨드젠 캠페인의 예측을 생성할 때는 사용 가능한 가장 구체적인 전환율 추천을 사용하세요.
디맨드젠 캠페인 사용자는 전환율 외에도 GenerateReachForecast를 사용하여 clicks를 예측할 수 있습니다. 이는 클릭수 최대화 입찰을 사용하는 디맨드젠 캠페인과 같이 클릭수를 최적화하는 캠페인에 특히 유용합니다.
YouTube Select 도달범위 예측
ReachPlanService의 YouTube Select (YTS)는 빠른 예약 가격 책정에서 모든 대상 YTS 위치에 대한 라인업 수준 타겟팅을 지원합니다. ReachPlanService.ListPlannableProducts의 youtube_select_lineup_targeting 필드를 사용하여 사용 가능한 라인업을 식별합니다 (youtube_select_lineup_targeting는 v23에서 지원 중단되고 v24에서 삭제된 youtube_select_lineups 필드를 대체함).
빠른 예약을 사용하면 YTS 예측을 요청할 때 다음과 같은 오류가 발생할 수 있습니다.
곡선 저장
사용자의 편의를 위해 개별 곡선만 저장할 수 있습니다. 곡선을 일괄 캐싱하는 것은 엄격히 금지됩니다. 곡선을 대량으로 생성해야 하는 경우 먼저 Google 계정 담당자에게 문의하세요.
오류 처리
ReachPlanService에 대한 요청은 기본 API 구조를 따라야 하며, 검증에 실패하면 일반적인 오류를 반환할 수 있습니다.
일반적인 오류 외에도 ReachPlanService는 ReachPlanError에 나열된 도달범위 플래너 관련 오류를 반환할 수 있습니다.
코드 예
곡선에는 절대 수치로 표시된 노출수 및 사용자 도달범위와 요청된 인구통계 및 국가의 인구조사 대상 인구 및 YouTube 잠재고객 규모에 해당하는 전체 규모가 포함됩니다.
자바
private void getReachCurve( ReachPlanServiceClient reachPlanServiceClient, GenerateReachForecastRequest request) { GenerateReachForecastResponse response = reachPlanServiceClient.generateReachForecast(request); System.out.println("Reach curve output:"); System.out.println( "Currency, Cost Micros, On-Target Reach, On-Target Imprs, Total Reach, Total Imprs," + " Products"); for (ReachForecast point : response.getReachCurve().getReachForecastsList()) { System.out.printf( "%s, \"", Joiner.on(", ") .join( request.getCurrencyCode(), String.valueOf(point.getCostMicros()), String.valueOf(point.getForecast().getOnTargetReach()), String.valueOf(point.getForecast().getOnTargetImpressions()), String.valueOf(point.getForecast().getTotalReach()), String.valueOf(point.getForecast().getTotalImpressions()))); for (PlannedProductReachForecast product : point.getPlannedProductReachForecastsList()) { System.out.printf("[Product: %s, ", product.getPlannableProductCode()); System.out.printf("Budget Micros: %s]", product.getCostMicros()); } System.out.printf("\"%n"); } }
C#
public void GetReachCurve(ReachPlanServiceClient reachPlanService, GenerateReachForecastRequest request) { GenerateReachForecastResponse response = reachPlanService.GenerateReachForecast( request); Console.WriteLine("Reach curve output:"); Console.WriteLine( "Currency, Cost Micros, On-Target Reach, On-Target Impressions, Total Reach," + " Total Impressions, Products"); foreach (ReachForecast point in response.ReachCurve.ReachForecasts) { Console.Write($"{request.CurrencyCode}, "); Console.Write($"{point.CostMicros}, "); Console.Write($"{point.Forecast.OnTargetReach}, "); Console.Write($"{point.Forecast.OnTargetImpressions}, "); Console.Write($"{point.Forecast.TotalReach}, "); Console.Write($"{point.Forecast.TotalImpressions}, "); Console.Write("\"["); foreach (PlannedProductReachForecast productReachForecast in point.PlannedProductReachForecasts) { Console.Write($"(Product: {productReachForecast.PlannableProductCode}, "); Console.Write($"Budget Micros: {productReachForecast.CostMicros}), "); } Console.WriteLine("]\""); } }
PHP
private static function getReachCurve( GoogleAdsClient $googleAdsClient, int $customerId, array $productMix, string $locationId, string $currencyCode ) { // Valid durations are between 1 and 90 days. $duration = new CampaignDuration(['duration_in_days' => 28]); $targeting = new Targeting([ 'plannable_location_id' => $locationId, 'age_range' => ReachPlanAgeRange::AGE_RANGE_18_65_UP, 'genders' => [ new GenderInfo(['type' => GenderType::FEMALE]), new GenderInfo(['type' => GenderType::MALE]) ], 'devices' => [ new DeviceInfo(['type' => Device::DESKTOP]), new DeviceInfo(['type' => Device::MOBILE]), new DeviceInfo(['type' => Device::TABLET]) ] ]); // See the docs for defaults and valid ranges: // https://developers.google.com/google-ads/api/reference/rpc/latest/GenerateReachForecastRequest $response = $googleAdsClient->getReachPlanServiceClient()->generateReachForecast( GenerateReachForecastRequest::build($customerId, $duration, $productMix) ->setCurrencyCode($currencyCode) ->setTargeting($targeting) ); printf( "Reach curve output:%sCurrency, Cost Micros, On-Target Reach, On-Target Imprs," . " Total Reach, Total Imprs, Products%s", PHP_EOL, PHP_EOL ); foreach ($response->getReachCurve()->getReachForecasts() as $point) { $products = ''; /** @var ReachForecast $point */ foreach ($point->getPlannedProductReachForecasts() as $plannedProductReachForecast) { /** @var PlannedProductReachForecast $plannedProductReachForecast */ $products .= sprintf( '(Product: %s, Budget Micros: %s)', $plannedProductReachForecast->getPlannableProductCode(), $plannedProductReachForecast->getCostMicros() ); } printf( "%s, %d, %d, %d, %d, %d, %s%s", $currencyCode, $point->getCostMicros(), $point->getForecast()->getOnTargetReach(), $point->getForecast()->getOnTargetImpressions(), $point->getForecast()->getTotalReach(), $point->getForecast()->getTotalImpressions(), $products, PHP_EOL ); } }
Python
def request_reach_curve( client: GoogleAdsClient, customer_id: str, product_mix: list[PlannedProduct], location_id: str, currency_code: str, ): """Creates a sample request for a given product mix. Args: client: an initialized GoogleAdsClient instance. customer_id: The customer ID for the reach forecast. product_mix: The product mix for the reach forecast. location_id: The location ID to plan for. currency_code: Three-character ISO 4217 currency code. """ # See the docs for defaults and valid ranges: # https://developers.google.com/google-ads/api/reference/rpc/latest/GenerateReachForecastRequest request: GenerateReachForecastRequest = client.get_type( "GenerateReachForecastRequest" ) request.customer_id = customer_id # Valid durations are between 1 and 90 days. request.campaign_duration.duration_in_days = 28 request.currency_code = currency_code request.cookie_frequency_cap = 0 request.min_effective_frequency = 1 request.planned_products = product_mix request.targeting.plannable_location_id = location_id request.targeting.age_range = ( client.enums.ReachPlanAgeRangeEnum.AGE_RANGE_18_65_UP ) # Add gender targeting to the request. gender_type: GenderTypeEnum for gender_type in [ client.enums.GenderTypeEnum.FEMALE, client.enums.GenderTypeEnum.MALE, ]: gender: GenderInfo = client.get_type("GenderInfo") gender.type_ = gender_type request.targeting.genders.append(gender) # Add device targeting to the request. device_type: DeviceEnum for device_type in [ client.enums.DeviceEnum.DESKTOP, client.enums.DeviceEnum.MOBILE, client.enums.DeviceEnum.TABLET, ]: device: DeviceInfo = client.get_type("DeviceInfo") device.type_ = device_type request.targeting.devices.append(device) reach_plan_service: ReachPlanServiceClient = client.get_service( "ReachPlanService" ) response: GenerateReachForecastResponse = ( reach_plan_service.generate_reach_forecast(request=request) ) print( "Currency, Cost, On-Target Reach, On-Target Imprs, Total Reach," " Total Imprs, Products" ) point: ReachForecast for point in response.reach_curve.reach_forecasts: product_splits = [] p: PlannedProductReachForecast for p in point.planned_product_reach_forecasts: product_splits.append( {p.plannable_product_code: p.cost_micros / ONE_MILLION} ) print( [ currency_code, point.cost_micros / ONE_MILLION, point.forecast.on_target_reach, point.forecast.on_target_impressions, point.forecast.total_reach, point.forecast.total_impressions, product_splits, ] )
Ruby
def get_reach_curve( client, reach_plan_service, customer_id, product_mix, location_id, currency_code) duration = client.resource.campaign_duration do |d| # Valid durations are between 1 and 90 days. d.duration_in_days = 28 end targeting = client.resource.targeting do |t| t.plannable_location_id = location_id t.age_range = :AGE_RANGE_18_65_UP t.genders << client.resource.gender_info do |gender| gender.type = :FEMALE end t.genders << client.resource.gender_info do |gender| gender.type = :MALE end t.devices << client.resource.device_info do |device| device.type = :DESKTOP end t.devices << client.resource.device_info do |device| device.type = :MOBILE end t.devices << client.resource.device_info do |device| device.type = :TABLET end end # See the docs for defaults and valid ranges: # https://developers.google.com/google-ads/api/reference/rpc/latest/GenerateReachForecastRequest response = reach_plan_service.generate_reach_forecast( customer_id: customer_id, campaign_duration: duration, planned_products: product_mix, currency_code: currency_code, targeting: targeting, ) puts "Reach curve output:" puts "Currency, Cost Micros, On-Target Reach, On-Target Imprs, " \ "Total Reach, Total Imprs, Products" response.reach_curve.reach_forecasts.each do |point| products = "" point.planned_product_reach_forecasts.each do |product| products += "(Product: #{product.plannable_product_code}, "\ "Cost Micros: #{product.cost_micros})" end puts "#{currency_code}, #{point.cost_micros}, " \ "#{point.forecast.on_target_reach}, " \ "#{point.forecast.on_target_impressions}, " \ "#{point.forecast.total_reach}, " \ "#{point.forecast.total_impressions}, " \ "#{products}" end end
Perl
sub pull_reach_curve { my ($reach_plan_service, $reach_request) = @_; my $response = $reach_plan_service->generate_reach_forecast($reach_request); print "Reach curve output:\n"; print "Currency,\tCost Micros,\tOn-Target Reach,\tOn-Target Imprs,\t" . "Total Reach,\tTotal Imprs,\tProducts\n"; foreach my $point (@{$response->{reachCurve}{reachForecasts}}) { printf "%s,\t%d,\t%d,\t%d,\t%d,\t%d,\t'[", $reach_request->{currencyCode}, $point->{costMicros}, $point->{forecast}{onTargetReach}, $point->{forecast}{onTargetImpressions}, $point->{forecast}{totalReach}, $point->{forecast}{totalImpressions}; foreach my $productReachForecast (@{$point->{plannedProductReachForecasts}}) { printf "(Product: %s, Budget Micros: %d), ", $productReachForecast->{plannableProductCode}, $productReachForecast->{costMicros}; } print "]'\n"; } }
curl
Google Issue Tracker
Google Issue Tracker를 사용하여 지원 질문을 하거나 버그를 신고하거나 기능 요청을 제출하세요. Google은 Issue Tracker에서 직접 요청을 추적하고 우선순위를 지정하며 업데이트를 게시합니다. 자세한 내용은 Google Issue Tracker에서 문제 만들기를 참조하세요.
다음 Issue Tracker 템플릿 중 하나를 사용하여 문제를 만듭니다.
Google에서 요청을 재현하고 우선순위를 지정할 수 있도록 템플릿의 모든 필드를 자세한 정보로 작성합니다. Google은 불완전한 신고를 종료하고 누락된 세부정보를 포함하여 새로운 문제를 제출하도록 요청할 수 있습니다.