Po zebraniu ustawień kierowania i zestawu reklam na potrzeby media planu możesz wygenerować krzywą budżetów w stosunku do potencjalnego zasięgu, korzystając z metody GenerateReachForecast w ReachPlanService. Szczegółowe informacje o polach żądania znajdziesz w słowniczku i przewodniku po media planie.
Dane prognozy
Odpowiedź z GenerateReachForecast zawiera różne dane w komunikacie Forecast, które dają wgląd w potencjalną skuteczność planowanej kampanii. Obejmują one:
- zasięg (w grupie docelowej i całkowity, w tym wspólne oglądanie);
- wyświetlenia (wśród docelowych odbiorców i łączne, w tym w ramach wspólnego oglądania, oraz widoczne);
- zestawienia skutecznej częstotliwości (ilu unikalnych użytkowników zobaczyło reklamę co najmniej określoną liczbę razy, np. co najmniej 1, 2 lub 3 razy);
- Działania użytkowników (obejrzenia reklam TrueView, konwersje i kliknięcia)
Prognozowanie zasięgu w kampaniach generujących popyt
Podczas generowania krzywych dla DEMAND_GEN produktów, które można uwzględnić w planie, musisz też podać oczekiwany współczynnik konwersji dla każdego produktu.
Aby uzyskać sugestie dotyczące współczynnika konwersji w przypadku obsługiwanych produktów, które można zaplanować, użyj metody GenerateConversionRates. Ta metoda zwraca sugestie dotyczące współczynnika konwersji na podstawie skuteczności historycznej Twojego konta lub sugerowane stawki na podstawie skuteczności wszystkich reklamodawców.
W przypadku produktów DEMAND_GEN GenerateConversionRates może zwrócić kilka sugestii dotyczących tego samego produktu. Niektóre sugestie mają wypełnione pole surface_targeting, co oznacza, że sugestia dotyczy tylko tej konkretnej kombinacji platform (np. YouTube Shorts). Jeśli parametr surface_targeting nie jest wypełniony, sugestia jest średnią dla tego produktu w kampanii generującej popyt. Podczas generowania prognoz dla kampanii generujących popyt z kierowaniem na platformy używaj najbardziej szczegółowej dostępnej sugestii dotyczącej współczynnika konwersji.
Oprócz współczynników konwersji użytkownicy kampanii generujących popyt mogą używać GenerateReachForecast do prognozowania clicks, co jest szczególnie istotne w przypadku optymalizacji kampanii pod kątem kliknięć, takich jak kampanie generujące popyt z ustalaniem stawek pod kątem maksymalizacji liczby kliknięć.
Prognozowanie zasięgu w przypadku YouTube Select
YouTube Select (YTS) w usłudze ReachPlanService obsługuje kierowanie na poziomie lineupu we wszystkich kwalifikujących się lokalizacjach YTS w ramach cen Szybkiej rezerwacji. Użyj pola youtube_select_lineup_targeting w ReachPlanService.ListPlannableProducts, aby zidentyfikować dostępne składy (pole youtube_select_lineup_targeting zastąpiło pole youtube_select_lineups, które zostało wycofane w v23 i usunięte w v24).
W przypadku Szybkiej rezerwacji podczas wysyłania prośby o prognozę dla YTS mogą wystąpić te błędy:
Zapisywanie krzywych
Możesz zapisywać tylko poszczególne krzywe, aby zapewnić użytkownikom wygodę. Zapisywanie krzywych w pamięci podręcznej na dużą skalę jest surowo zabronione. Jeśli chcesz wygenerować krzywe zbiorczo, najpierw skontaktuj się z opiekunem klienta w Google.
Obsługa błędów
Żądania wysyłane do ReachPlanService muszą być zgodne z podstawową strukturą interfejsu API. Jeśli nie przejdą weryfikacji, mogą zwrócić typowe błędy.
Oprócz typowych błędów ReachPlanService może zwracać błędy związane z planowaniem zasięgu, które są wymienione w ReachPlanError.
Przykładowy kod
Krzywa zawiera wyświetlenia i zasięg wśród użytkowników w liczbach bezwzględnych, a także rozmiary populacji odpowiadające całej populacji i wielkości grupy odbiorców w YouTube w przypadku wybranej grupy demograficznej i wybranego kraju.
Java
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
Narzędzie Google Issue Tracker
Użyj narzędzia Issue Tracker, aby zadać pytania zespołowi pomocy, zgłosić błędy lub przesłać prośby o dodanie funkcji. Google śledzi i priorytetyzuje Twoje zgłoszenia oraz publikuje aktualizacje bezpośrednio w narzędziu Issue Tracker. Więcej informacji znajdziesz w artykule Tworzenie zgłoszenia w narzędziu Google Issue Tracker.
Utwórz zgłoszenie, korzystając z jednego z tych szablonów narzędzia Issue Tracker:
- Zadawanie ogólnych pytań dotyczących pomocy lub przesyłanie opinii o dokumentacji
- Zgłaszanie błędu technicznego
- Przesyłanie prośby o dodanie funkcji interfejsu API
Wypełnij wszystkie pola w szablonie, podając szczegółowe informacje, abyśmy mogli odtworzyć problem i nadać Twojej prośbie odpowiedni priorytet. Google może zamknąć niekompletne zgłoszenia i poprosić Cię o przesłanie nowego zgłoszenia z brakującymi informacjami.