Dopo aver raccolto le impostazioni di targeting e un mix di prodotti per il tuo piano media, puoi generare una curva dei budget rispetto alla copertura potenziale utilizzando il metodo GenerateReachForecast in ReachPlanService. Per informazioni dettagliate sui campi della richiesta, consulta il glossario e la guida al piano media.
Metriche di previsione
La risposta di GenerateReachForecast include varie metriche all'interno del messaggio Forecast, fornendo informazioni sul potenziale rendimento della campagna pianificata. tra cui:
- Copertura (in linea con il target e totale, inclusa la visualizzazione condivisa)
- Impressioni (in-target e totali, incluse quelle con visualizzazione condivisa e visibili)
- Suddivisioni della frequenza effettiva (quanti utenti unici vengono raggiunti almeno un certo numero di volte, ad esempio 1+, 2+ o 3+ impressioni)
- Azioni degli utenti (visualizzazioni TrueView, conversioni e clic)
Prevedi la copertura per Demand Gen
Quando generi curve per DEMAND_GEN prodotti pianificabili, devi anche includere un tasso di conversione previsto per ogni prodotto.
Per ottenere suggerimenti sul tasso di conversione per i prodotti pianificabili supportati, utilizza il metodo GenerateConversionRates. Questo metodo restituisce suggerimenti sul tasso di conversione in base al rendimento storico del tuo account o ai tassi suggeriti in base al rendimento di tutti gli inserzionisti.
Per i prodotti DEMAND_GEN, GenerateConversionRates potrebbe restituire più suggerimenti per lo stesso prodotto. Alcuni suggerimenti hanno il campo surface_targeting compilato, il che indica che il suggerimento si applica solo a quella specifica combinazione di piattaforme (ad esempio YouTube Shorts). Se
surface_targeting non è compilato, il suggerimento è una media della campagna Demand Gen
per quel prodotto. Quando generi previsioni per le campagne Demand Gen con targeting per piattaforma, utilizza il suggerimento per il tasso di conversione più specifico disponibile.
Oltre ai tassi di conversione, gli utenti di Demand Gen possono utilizzare GenerateReachForecast per prevedere clicks, il che è particolarmente importante per le campagne ottimizzate per i clic, come Demand Gen con l'offerta Massimizza i clic.
Prevedi la copertura per YouTube Select
YouTube Select (YTS) in ReachPlanService supporta il targeting a livello di selezione per tutte le località YTS idonee con i prezzi di Prenotazione istantanea. Utilizza il campo youtube_select_lineup_targeting in ReachPlanService.ListPlannableProducts per identificare le selezioni disponibili (youtube_select_lineup_targeting ha sostituito il campo youtube_select_lineups, che è stato ritirato in v23 e rimosso in v24).
Con Prenotazione istantanea, possono verificarsi i seguenti errori quando richiedi una previsione per YTS:
Salva curve
Puoi salvare solo singole curve per offrire comodità agli utenti. La memorizzazione nella cache di curve in massa è severamente vietata. Se devi generare curve in blocco, contatta prima il tuo rappresentante Google per l'account.
Gestione degli errori
Le richieste a ReachPlanService devono seguire la struttura di base dell'API e potrebbero restituire errori comuni se la convalida non va a buon fine.
Oltre agli errori comuni, ReachPlanService può restituire errori specifici dello Strumento di pianificazione della copertura elencati in ReachPlanError.
Codice di esempio
La curva include la copertura di impressioni e utenti in numeri assoluti, nonché le dimensioni dell'universo corrispondenti alla popolazione censita e alla dimensione del segmento di pubblico di YouTube per i dati demografici e il paese richiesti.
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
Google Issue Tracker
Utilizza Google Issue Tracker per porre domande di assistenza, segnalare bug o inviare richieste di funzionalità. Google monitora, assegna la priorità e pubblica gli aggiornamenti sulle tue richieste direttamente in Issue Tracker. Per saperne di più, consulta Crea un problema in Google Issue Tracker.
Crea un problema utilizzando uno dei seguenti modelli di Issue Tracker:
- Fai una domanda di assistenza generale o invia un feedback sulla documentazione
- Segnala un bug tecnico
- Invia una richiesta di funzionalità API
Compila tutti i campi del modello con informazioni dettagliate in modo che Google possa riprodurre e dare priorità alla tua richiesta. Google potrebbe chiudere le segnalazioni incomplete e chiederti di inviare un nuovo problema con i dettagli mancanti.