Medya planınız için hedefleme ayarlarını ve ürün karmasını belirledikten sonra, ReachPlanService içindeki GenerateReachForecast yöntemini kullanarak bütçeler ile potansiyel erişimi karşılaştıran bir eğri oluşturabilirsiniz. İstek alanlarıyla ilgili ayrıntılar için sözlüğe ve medya planı kılavuzuna bakın.
Tahmin metrikleri
GenerateReachForecast tarafından gönderilen yanıt, Forecast mesajında çeşitli metrikler içerir ve planlanan kampanyanızın potansiyel performansıyla ilgili analizler sunar. Bu metrikler şunlardır:
- Erişim (birlikte izleme dahil olmak üzere hedeflenen ve toplam)
- Gösterim sayısı (birlikte izleme ve görüntülenebilir gösterimler dahil olmak üzere hedeflenen ve toplam gösterim sayısı)
- Etkili sıklık dökümleri (kaç tekil kullanıcıya en az belirli bir sayıda erişildiği; örneğin, 1+, 2+ veya 3+ gösterim)
- Kullanıcı işlemleri (TrueView görüntülemeleri, dönüşümler ve tıklamalar)
Talep Yaratma kampanyaları için erişim tahmini yapma
DEMAND_GEN planlanabilir ürün için eğri oluştururken her ürün için beklenen dönüşüm oranını da eklemeniz gerekir.
Desteklenen planlanabilir ürünler için dönüşüm oranı önerileri almak istiyorsanız GenerateConversionRates yöntemini kullanın. Bu yöntem, hesabınızın geçmiş performansına dayalı dönüşüm oranı önerileri veya tüm reklamverenlerin performansına dayalı önerilen oranlar döndürür.
DEMAND_GEN ürünleri için GenerateConversionRates, aynı ürünle ilgili birden fazla öneri döndürebilir. Bazı önerilerde surface_targeting alanı doldurulmuştur. Bu, önerinin yalnızca belirli bir yüzey kombinasyonu (ör. YouTube Shorts) için geçerli olduğunu gösterir. surface_targeting
doldurulmazsa öneri, söz konusu ürün için Talep Yaratma kampanyası ortalamasıdır. Yüzey hedefleme kullanan Talep Yaratma kampanyaları için tahmin oluştururken mevcut en spesifik dönüşüm oranı önerisini kullanın.
Talep Yaratma kullanıcıları, dönüşüm oranlarının yanı sıra GenerateReachForecast kullanarak clicks tahmininde bulunabilir. Bu, özellikle tıklamaları artırma teklifi kullanılan Talep Yaratma kampanyaları gibi tıklamalar için optimizasyon yapan kampanyalarla ilgilidir.
YouTube Select için erişim tahmini yapma
ReachPlanService'da YouTube Select (YTS), Anında Rezervasyon fiyatlandırmasında tüm uygun YTS konumları için kanal listesi düzeyinde hedeflemeyi destekler. Kullanılabilir kanal listelerini tanımlamak için ReachPlanService.ListPlannableProducts içindeki youtube_select_lineup_targeting alanını kullanın (youtube_select_lineup_targeting, v23 tarihinde desteği sonlandırılan ve v24 tarihinde kaldırılan youtube_select_lineups alanının yerini almıştır).
Anında Rezervasyon'da, YTS için tahmin isteğinde bulunurken aşağıdaki hatalar oluşabilir:
Eğrileri kaydetme
Kullanıcılarınıza kolaylık sağlamak için yalnızca tek tek eğrileri kaydedebilirsiniz. Eğrilerin toplu olarak önbelleğe alınması kesinlikle yasaktır. Eğrileri toplu olarak oluşturmanız gerekiyorsa önce Google Hesabı temsilcinizle iletişime geçin.
Hata işleme
ReachPlanService için yapılan istekler temel API yapısına uymalıdır ve doğrulama başarısız olursa yaygın hatalar döndürebilir.
ReachPlanService, yaygın hataların yanı sıra ReachPlanError adresinde listelenen erişim planlamaya özgü hatalar döndürebilir.
Kod örneği
Eğri, mutlak sayılarla gösterim ve kullanıcı erişiminin yanı sıra istenen demografi ve ülke için toplam nüfusa ve YouTube kitle boyutuna karşılık gelen evren boyutlarını içerir.
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
Destekle ilgili sorular sormak, hataları bildirmek veya özellik istekleri göndermek için Google Issue Tracker'ı kullanın. Google, isteklerinizi doğrudan Issue Tracker'da takip eder, önceliklendirir ve isteklerinizle ilgili güncellemeleri yayınlar. Daha fazla bilgi için Google Issue Tracker'da sorun oluşturma başlıklı makaleyi inceleyin.
Aşağıdaki Issue Tracker şablonlarından birini kullanarak sorun oluşturun:
- Genel destek sorusu sorma veya belgelerle ilgili geri bildirim gönderme
- Teknik hata bildirme
- API özellik isteği gönderme
Google'ın isteğinizi yeniden oluşturabilmesi ve önceliklendirebilmesi için şablondaki tüm alanları ayrıntılı bilgilerle doldurun. Google, eksik raporları kapatabilir ve eksik ayrıntıları içeren yeni bir sorun göndermenizi isteyebilir.