Tahmin metrikleri, önerilen veya mevcut kampanyalar için tahmini performans metrikleri (KeywordForecastMetrics) sağlar. Kullanılabilir tahmin metrikleri, desteklenen API sürümünüze ve teklif stratejinize bağlıdır:
- v24 ve sonraki sürümler:
clicks(tıklama sayısı): YalnızcaManualCpcBiddingStrategyveyaMaximizeClicksBiddingStrategykullanıldığında döndürülür.cost_micros(maliyet): Mikro cinsinden toplam tahmini maliyet.average_cpc_micros(ortalama tıklama başına maliyet): YalnızcaManualCpcBiddingStrategyveyaMaximizeClicksBiddingStrategyveclicks > 0kullanılırken döndürülür.conversions(dönüşümler): YalnızcaMaximizeConversionsBiddingStrategykullanılırken döndürülür.average_cpa_micros(ortalama edinme başına maliyet): YalnızcaMaximizeConversionsBiddingStrategykullanıldığında döndürülür (cost_micros / conversionsolarak hesaplanır).
- v23 ve önceki sürümler:
clicks,cost_micros,average_cpc_micros,conversionsveaverage_cpa_micros(tüm teklif stratejilerinde döndürülür) değerlerine ek olarakKeywordForecastMetrics;impressions(gösterim sayısı),click_through_rate(tıklama oranı) veconversion_rate(dönüşüm oranı) değerlerini de döndürür.
Bu metriklerin her birini optimize etmek için farklı kampanya yapılandırmalarıyla denemeler yapın. Tahmin, beklenen performansı simüle etmek için geçmiş kalite puanı ve tıklama oranı gibi verileri kullanır.
Tahmin metrikleri genellikle anahtar kelime fikirleri ile aday anahtar kelimeler keşfedildikten veya mevcut bir anahtar kelime listesi geçmiş metrikler ile filtrelendikten ve isteğe bağlı olarak bu anahtar kelimeler reklam grubu temaları ile gruplandırıldıktan sonra kullanılır. Geçmiş metrikler, geçmiş arama hacmine göre geniş bir aday anahtar kelime grubunu daraltırken tahmin metrikleri, gelecekteki performansı simüle eder. Böylece, yayınlanan bir kampanyayı güncellemeden önce tekliflerinizi, günlük bütçenizi ve hedeflemenizi optimize edebilirsiniz.
Metrik oluşturma
Tahmin metrikleri oluşturmak için aşağıdaki adımları uygulayın:
- Kampanya yapılandırmasını,
ForecastAdGroupnesnelerini ve değerlendirmek istediğiniz teklif stratejisini temsil eden birCampaignToForecastnesnesi oluşturun. - Bu
CampaignToForecastve isteğe bağlı birforecast_periodileKeywordPlanIdeaService.GenerateKeywordForecastMetricsyöntemini çağırın (başlangıç tarihi gelecekte, bitiş tarihi ise bugünden itibaren bir yıl içinde olmalıdır. Atlanırsa varsayılan olarak müşteri hesabının saat diliminde bir sonraki pazar gününden takip eden cumartesi gününe kadar olan tarih aralığı kullanılır). GenerateKeywordForecastMetricsResponse'ıncampaign_forecast_metricsalanından kampanya düzeyindekiKeywordForecastMetricsdeğerini okuyun.
Tahmin için kampanya oluşturma
Tahmin için kampanyanızı oluştururken yararlanabileceğiniz bazı ipuçları:
- Reklam gruplarını reklam öğesi alaka düzeyi, ürün kategorisi veya tıklama başına maliyet gibi temalara göre oluşturun (veya
GenerateAdGroupThemes'ın önerilerini kullanın). - Sürüm 23 ve önceki sürümlerde,
CampaignToForecast.negative_keywordsveyaForecastAdGroup.negative_keywordskullanarak yaygın negatif anahtar kelimeleri ekleyin (örneğin, işe alım sektöründe değilseniz'jobs'anahtar kelimesini hariç tutun). Sürüm 24 ve sonraki sürümlerdenegative_keywordskaldırılmıştır. - Kampanyayla ilgili bir hesap kullanın. Alakasız bir hesaptan tahmin yapmayın. Google, kalite puanını ve reklam öğesi içeriğini tahmine dahil eder.
- Bir kampanya, hesabınızın geri kalanıyla ilgili değilse tahmin için yeni ve temiz bir hesap kullanın.
- Bütünsel bir resim elde etmek için farklı ufuklarla tahminleri tekrarlayın.
Sürüm farklılıkları
Sürüm 24 ve sonraki sürümlerde CampaignToForecast, ForecastAdGroup ve KeywordForecastMetrics, sürüm 23 ve önceki sürümlere kıyasla aşağıdaki tabloda gösterildiği gibi daha basit bir şema kullanır:
| Özellik | v24 ve sonraki sürümler | v23 ve önceki sürümler |
|---|---|---|
| Reklam grubu anahtar kelimeleri | ForecastAdGroup.keywords (repeated KeywordInfo) |
ForecastAdGroup.biddable_keywords (repeated BiddableKeyword) |
| Yer hedefleme | CampaignToForecast.geo_target_constants (repeated string kaynak adı) |
CampaignToForecast.geo_modifiers (isteğe bağlı teklif çarpanlarıyla repeated CriterionBidModifier) |
| Arama Ağı hedefleme | CampaignToForecast üzerinde belirtilmedi (varsayılan olarak Google Arama'ya ayarlanır) |
Zorunlu CampaignToForecast.keyword_plan_network |
| Negatif anahtar kelimeler | CampaignToForecast veya ForecastAdGroup cihazlarda desteklenmez |
CampaignToForecast.negative_keywords ve ForecastAdGroup.negative_keywords kullanılarak desteklenir |
| Reklam grubu ve anahtar kelime TBM teklifini geçersiz kılma işlemleri | Yalnızca kampanya teklif stratejisi düzeyinde yapılandırılır (ManualCpcBiddingStrategy.max_cpc_bid_micros veya MaximizeClicksBiddingStrategy.max_cpc_bid_ceiling_micros) |
Reklam grubu (ForecastAdGroup.max_cpc_bid_micros) veya anahtar kelime (BiddableKeyword.max_cpc_bid_micros) başına da geçersiz kılınabilir. |
| Özel beklenen dönüşüm oranı | CampaignToForecast üzerinde desteklenmiyor |
İsteğe bağlı CampaignToForecast.conversion_rate |
| Döndürülen tahmin metrikleri | clicks ve average_cpc_micros (yalnızca manuel TBM veya tıklamaları artırma), cost_micros, conversions ve average_cpa_micros (yalnızca dönüşümleri artırma) |
Tüm teklif stratejilerinde clicks, cost_micros, average_cpc_micros, conversions ve average_cpa_micros ile impressions, click_through_rate ve conversion_rate değerlerini döndürür. |
Kod örneği
Bir sonraki kod örneği, KeywordPlanIdeaService.GenerateKeywordForecastMetrics adresine istek gönderir. Reklam grupları ve anahtar kelimelerle satır içi CampaignToForecast oluşturur ve ardından döndürülen campaign_forecast_metrics değerini gösterir.
Java
private void runExample(GoogleAdsClient googleAdsClient, Long customerId) { CampaignToForecast campaignToForecast = createCampaignToForecast(googleAdsClient); GenerateKeywordForecastMetricsRequest request = GenerateKeywordForecastMetricsRequest.newBuilder() .setCustomerId(String.valueOf(customerId)) .setCampaign(campaignToForecast) .setForecastPeriod( DateRange.newBuilder() // Sets the forecast start date to tomorrow. .setStartDate(new DateTime().plusDays(1).toString("yyyy-MM-dd")) // Sets the forecast end date to 30 days from today. .setEndDate(new DateTime().plusDays(30).toString("yyyy-MM-dd"))) .build(); try (KeywordPlanIdeaServiceClient keywordPlanIdeaServiceClient = googleAdsClient.getLatestVersion().createKeywordPlanIdeaServiceClient()) { GenerateKeywordForecastMetricsResponse response = keywordPlanIdeaServiceClient.generateKeywordForecastMetrics(request); KeywordForecastMetrics metrics = response.getCampaignForecastMetrics(); System.out.printf( "Estimated daily clicks: %s%n", metrics.hasClicks() ? metrics.getClicks() : null); System.out.printf( "Estimated average CPC (micros): %s%n", metrics.hasAverageCpcMicros() ? metrics.getAverageCpcMicros() : null); } } /** * Creates the campaign to forecast. A campaign to forecast lets you try out various * configurations and keywords to find the best optimization for your future campaigns. Once * you've found the best campaign configuration, create a serving campaign in your Google Ads * account with similar values and keywords. For more details, see: * * <p>https://support.google.com/google-ads/answer/3022575 */ private CampaignToForecast createCampaignToForecast(GoogleAdsClient googleAdsClient) { CampaignToForecast.Builder campaignToForecastBuilder = CampaignToForecast.newBuilder() .setBiddingStrategy( CampaignBiddingStrategy.newBuilder() .setManualCpcBiddingStrategy( ManualCpcBiddingStrategy.newBuilder().setMaxCpcBidMicros(1_000_000L))); // See https://developers.google.com/google-ads/api/reference/data/geotargets for the list of // geo target IDs. Geo target constant 2840 is for USA. campaignToForecastBuilder.addGeoTargetConstants(ResourceNames.geoTargetConstant(2840)); // See https://developers.google.com/google-ads/api/reference/data/codes-formats#languages for // the list of language criteria IDs. Language constant 1000 is for English. campaignToForecastBuilder.addLanguageConstants(ResourceNames.languageConstant(1000)); // Create forecast ad group based on themes such as creative relevance, product category, or // cost per click. ForecastAdGroup.Builder forecastAdGroupBuilder = ForecastAdGroup.newBuilder(); forecastAdGroupBuilder.addKeywords( KeywordInfo.newBuilder() .setText("mars cruise") .setMatchType(KeywordMatchType.BROAD)); forecastAdGroupBuilder.addKeywords( KeywordInfo.newBuilder() .setText("cheap cruise") .setMatchType(KeywordMatchType.PHRASE)); forecastAdGroupBuilder.addKeywords( KeywordInfo.newBuilder() .setText("jupiter cruise") .setMatchType(KeywordMatchType.BROAD)); campaignToForecastBuilder.addAdGroups(forecastAdGroupBuilder.build()); return campaignToForecastBuilder.build(); }
C#
public void Run(GoogleAdsClient client, long customerId) { CampaignToForecast campaignToForecast = CreateCampaignToForecast(); KeywordPlanIdeaServiceClient keywordPlanIdeaService = client.GetService(Services.V26.KeywordPlanIdeaService); GenerateKeywordForecastMetricsRequest request = new GenerateKeywordForecastMetricsRequest() { CustomerId = customerId.ToString(), Campaign = campaignToForecast, ForecastPeriod = new DateRange() { // Set the forecast start date to tomorrow. StartDate = DateTime.Now.AddDays(1).ToString("yyyy-MM-dd"), // Set the forecast end date to 30 days from today. EndDate = DateTime.Now.AddDays(30).ToString("yyyy-MM-dd"), } }; try { GenerateKeywordForecastMetricsResponse response = keywordPlanIdeaService.GenerateKeywordForecastMetrics(request); KeywordForecastMetrics metrics = response.CampaignForecastMetrics; Console.WriteLine($"Estimated daily clicks: {metrics.Clicks}."); Console.WriteLine($"Estimated average cpc (micros): {metrics.AverageCpcMicros}."); } catch (GoogleAdsException e) { Console.WriteLine("Failure:"); Console.WriteLine($"Message: {e.Message}"); Console.WriteLine($"Failure: {e.Failure}"); Console.WriteLine($"Request ID: {e.RequestId}"); throw; } } /// <summary> /// Creates the campaign to forecast. A campaign to forecast lets you try out /// various configuration and keywords to find the best optimization for your /// future campaigns. Once you've found the best campaign configuration, /// create a serving campaign in your Google Ads account with similar values /// and keywords. For more details, see: /// https://support.google.com/google-ads/answer/3022575 /// </summary> private CampaignToForecast CreateCampaignToForecast() { CampaignToForecast campaignToForecast = new CampaignToForecast() { BiddingStrategy = new CampaignToForecast.Types.CampaignBiddingStrategy() { ManualCpcBiddingStrategy = new ManualCpcBiddingStrategy() { MaxCpcBidMicros = 1_000_000 } } }; // See https://developers.google.com/google-ads/api/reference/data/geotargets // for the list of geo target IDs. // Geo target constant 2840 is for USA. campaignToForecast.GeoTargetConstants.Add( ResourceNames.GeoTargetConstant(2840) ); // See https://developers.google.com/google-ads/api/reference/data/codes-formats#languages // for the list of language criteria IDs. // Language constant 1000 is for English. campaignToForecast.LanguageConstants.Add(ResourceNames.LanguageConstant(1000)); // Create forecast ad group based on themes such as creative relevance, product category, // or cost per click. ForecastAdGroup forecastAdGroup = new ForecastAdGroup(); KeywordInfo keyword1 = new KeywordInfo() { Text = "mars cruise", MatchType = KeywordMatchType.Broad }; forecastAdGroup.Keywords.Add(keyword1); KeywordInfo keyword2 = new KeywordInfo() { Text = "cheap cruise", MatchType = KeywordMatchType.Phrase }; forecastAdGroup.Keywords.Add(keyword2); KeywordInfo keyword3 = new KeywordInfo() { Text = "jupiter cruise", MatchType = KeywordMatchType.Exact }; forecastAdGroup.Keywords.Add(keyword3); campaignToForecast.AdGroups.Add(forecastAdGroup); return campaignToForecast; }
PHP
public static function runExample( GoogleAdsClient $googleAdsClient, int $customerId ): void { $campaignToForecast = self::createCampaignToForecast(); $keywordPlanIdeaServiceClient = $googleAdsClient->getKeywordPlanIdeaServiceClient(); // Generates keyword forecast metrics based on the specified parameters. $response = $keywordPlanIdeaServiceClient->generateKeywordForecastMetrics( new GenerateKeywordForecastMetricsRequest([ 'customer_id' => $customerId, 'campaign' => $campaignToForecast, 'forecast_period' => new DateRange([ // Sets the forecast start date to tomorrow. 'start_date' => date('Ymd', strtotime('+1 day')), // Sets the forecast end date to 30 days from today. 'end_date' => date('Ymd', strtotime('+30 days')) ]) ]) ); $metrics = $response->getCampaignForecastMetrics(); printf( "Estimated daily clicks: %s%s", $metrics->hasClicks() ? sprintf("%.2f", $metrics->getClicks()) : "'none'", PHP_EOL ); printf( "Estimated daily impressions: %s%s", $metrics->hasImpressions() ? sprintf("%.2f", $metrics->getImpressions()) : "'none'", PHP_EOL ); printf( "Estimated average CPC (micros): %s%s", $metrics->hasAverageCpcMicros() ? sprintf("%d", $metrics->getAverageCpcMicros()) : "'none'", PHP_EOL ); } /** * Creates the campaign to forecast. A campaign to forecast lets you try out various * configurations and keywords to find the best optimization for your future campaigns. Once * you've found the best campaign configuration, create a serving campaign in your Google Ads * account with similar values and keywords. For more details, see: * * https://support.google.com/google-ads/answer/3022575 * * @return CampaignToForecast the created campaign to forecast */ private static function createCampaignToForecast(): CampaignToForecast { // Creates a campaign to forecast. $campaignToForecast = new CampaignToForecast([ 'keyword_plan_network' => KeywordPlanNetwork::GOOGLE_SEARCH, 'bidding_strategy' => new CampaignBiddingStrategy([ 'manual_cpc_bidding_strategy' => new ManualCpcBiddingStrategy([ 'max_cpc_bid_micros' => 1_000_000 ]) ]), // See https://developers.google.com/google-ads/api/reference/data/geotargets for the // list of geo target IDs. 'geo_modifiers' => [ new CriterionBidModifier([ // Geo target constant 2840 is for USA. 'geo_target_constant' => ResourceNames::forGeoTargetConstant(2840) ]) ], // See // https://developers.google.com/google-ads/api/reference/data/codes-formats#languages // for the list of language criteria IDs. Language constant 1000 is for English. 'language_constants' => [ResourceNames::forLanguageConstant(1000)], ]); // Creates forecast ad group based on themes such as creative relevance, product category, // or cost per click. $forecastAdGroup = new ForecastAdGroup([ 'biddable_keywords' => [ new BiddableKeyword([ 'max_cpc_bid_micros' => 2_500_000, 'keyword' => new KeywordInfo([ 'text' => 'mars cruise', 'match_type' => KeywordMatchType::BROAD ]) ]), new BiddableKeyword([ 'max_cpc_bid_micros' => 1_500_000, 'keyword' => new KeywordInfo([ 'text' => 'cheap cruise', 'match_type' => KeywordMatchType::PHRASE ]) ]), new BiddableKeyword([ 'max_cpc_bid_micros' => 1_990_000, 'keyword' => new KeywordInfo([ 'text' => 'jupiter cruise', 'match_type' => KeywordMatchType::BROAD ]) ]) ], 'negative_keywords' => [ new KeywordInfo([ 'text' => 'moon walk', 'match_type' => KeywordMatchType::BROAD ]) ] ]); $campaignToForecast->setAdGroups([$forecastAdGroup]); return $campaignToForecast; }
Python
def main(client: GoogleAdsClient, customer_id: str): """The main method that creates all necessary entities for the example. Args: client: an initialized GoogleAdsClient instance. customer_id: a client customer ID. """ campaign_to_forecast: CampaignToForecast = create_campaign_to_forecast( client ) generate_forecast_metrics(client, customer_id, campaign_to_forecast) def create_campaign_to_forecast(client: GoogleAdsClient) -> CampaignToForecast: """Creates the campaign to forecast. A campaign to forecast lets you try out various configurations and keywords to find the best optimization for your future campaigns. Once you've found the best campaign configuration, create a serving campaign in your Google Ads account with similar values and keywords. For more details, see: https://support.google.com/google-ads/answer/3022575 Args: client: an initialized GoogleAdsClient instance. Returns: An CampaignToForecast instance. """ googleads_service: GoogleAdsServiceClient = client.get_service( "GoogleAdsService" ) # Create a campaign to forecast. campaign_to_forecast: CampaignToForecast = client.get_type( "CampaignToForecast" ) # Set the bidding strategy. campaign_to_forecast.bidding_strategy.manual_cpc_bidding_strategy.max_cpc_bid_micros = ( 1000000 ) # For the list of geo target IDs, see: # https://developers.google.com/google-ads/api/reference/data/geotargets # Geo target constant 2840 is for USA. campaign_to_forecast.geo_target_constants.append( googleads_service.geo_target_constant_path("2840") ) # For the list of language criteria IDs, see: # https://developers.google.com/google-ads/api/reference/data/codes-formats#languages # Language criteria 1000 is for English. campaign_to_forecast.language_constants.append( googleads_service.language_constant_path("1000") ) # Create forecast ad groups based on themes such as creative relevance, # product category, or cost per click. forecast_ad_group: ForecastAdGroup = client.get_type("ForecastAdGroup") # Create and configure three KeywordInfo instances. keyword_1: KeywordInfo = client.get_type("KeywordInfo") keyword_1.text = "mars cruise" keyword_1.match_type = client.enums.KeywordMatchTypeEnum.BROAD keyword_2: KeywordInfo = client.get_type("KeywordInfo") keyword_2.text = "cheap cruise" keyword_2.match_type = client.enums.KeywordMatchTypeEnum.PHRASE keyword_3: KeywordInfo = client.get_type("KeywordInfo") keyword_3.text = "cheap cruise" keyword_3.match_type = client.enums.KeywordMatchTypeEnum.EXACT # Add the keywords to the forecast ad group. forecast_ad_group.keywords.extend([keyword_1, keyword_2, keyword_3]) campaign_to_forecast.ad_groups.append(forecast_ad_group) return campaign_to_forecast def generate_forecast_metrics( client: GoogleAdsClient, customer_id: str, campaign_to_forecast: CampaignToForecast, ): """Generates forecast metrics and prints the results. Args: client: an initialized GoogleAdsClient instance. customer_id: a client customer ID. campaign_to_forecast: a CampaignToForecast to generate metrics for. """ keyword_plan_idea_service: KeywordPlanIdeaServiceClient = ( client.get_service("KeywordPlanIdeaService") ) request: GenerateKeywordForecastMetricsRequest = client.get_type( "GenerateKeywordForecastMetricsRequest" ) request.customer_id = customer_id request.campaign = campaign_to_forecast # Set the forecast range. Repeat forecasts with different horizons to get a # holistic picture. # Set the forecast start date to tomorrow. tomorrow = datetime.now() + timedelta(days=1) request.forecast_period.start_date = tomorrow.strftime("%Y-%m-%d") # Set the forecast end date to 30 days from today. thirty_days_from_now = datetime.now() + timedelta(days=30) request.forecast_period.end_date = thirty_days_from_now.strftime("%Y-%m-%d") response: GenerateKeywordForecastMetricsResponse = ( keyword_plan_idea_service.generate_keyword_forecast_metrics( request=request ) ) metrics = response.campaign_forecast_metrics print(f"Estimated daily clicks: {metrics.clicks}") print(f"Estimated daily average CPC: {metrics.average_cpc_micros}")
Ruby
def generate_forecast_metrics(customer_id) # GoogleAdsClient will read a config file from # ENV['HOME']/google_ads_config.rb when called without parameters client = Google::Ads::GoogleAds::GoogleAdsClient.new campaign_to_forecast = create_campaign_to_forecast(client) # Generates forecast metrics and prints the results. keyword_plan_idea_service = client.service.keyword_plan_idea # Set the forecast range. Repeat forecasts with different horizons to get a # holistic picture. forecast_period = client.resource.date_range do |p| tomorrow = Date.today + 1 p.start_date = tomorrow.strftime("%Y-%m-%d") # Set the forecast end date to 30 days from today. thirty_days_from_now = Date.today + 30 p.end_date = thirty_days_from_now.strftime("%Y-%m-%d") end response = keyword_plan_idea_service.generate_keyword_forecast_metrics( customer_id: customer_id, campaign: campaign_to_forecast, forecast_period: forecast_period, ) metrics = response.campaign_forecast_metrics puts "Estimated daily clicks: #{metrics.clicks}" puts "Estimated daily impressions: #{metrics.impressions}" puts "Estimated daily average CPC: #{metrics.average_cpc_micros}" end def create_campaign_to_forecast(client) campaign_to_forecast = client.resource.campaign_to_forecast do |c| c.keyword_plan_network = :GOOGLE_SEARCH c.bidding_strategy = client.resource.campaign_bidding_strategy do |bs| bs.manual_cpc_bidding_strategy = client.resource.manual_cpc_bidding_strategy do |mbs| mbs.max_cpc_bid_micros = 1000000 end end criterion_bid_modifier = client.resource.criterion_bid_modifier # For the list of geo target IDs, see: # https://developers.google.com/google-ads/api/reference/data/geotargets # Geo target constant 2840 is for USA. criterion_bid_modifier.geo_target_constant = client.path.geo_target_constant("2840") c.geo_modifiers << criterion_bid_modifier # For the list of language criteria IDs, see: # https://developers.google.com/google-ads/api/reference/data/codes-formats#languages # Language criteria 1000 is for English. language_constant = client.path.language_constant("1000") # English c.language_constants << language_constant # Create forecast ad groups based on themes such as creative relevance, # product category, or cost per click. forecast_ad_group = client.resource.forecast_ad_group biddable_keyword_1 = client.resource.biddable_keyword do |bk| bk.max_cpc_bid_micros = 1500000 bk.keyword = client.resource.keyword_info do |k| k.text = "mars cruise" k.match_type = :BROAD end end biddable_keyword_2 = client.resource.biddable_keyword do |bk| bk.max_cpc_bid_micros = 2500000 bk.keyword = client.resource.keyword_info do |k| k.text = "cheap cruise" k.match_type = :PHRASE end end biddable_keyword_3 = client.resource.biddable_keyword do |bk| bk.max_cpc_bid_micros = 1990000 bk.keyword = client.resource.keyword_info do |k| k.text = "cheap cruise" k.match_type = :EXACT end end forecast_ad_group.biddable_keywords << biddable_keyword_1 forecast_ad_group.biddable_keywords << biddable_keyword_2 forecast_ad_group.biddable_keywords << biddable_keyword_3 # Create and configure a negative keyword, then add it to the forecast ad # group. negative_keyword = client.resource.keyword_info do |k| k.text = "moon walk" k.match_type = :BROAD end forecast_ad_group.negative_keywords << negative_keyword c.ad_groups << forecast_ad_group end return campaign_to_forecast end
Perl
sub generate_forecast_metrics { my ($api_client, $customer_id) = @_; my $campaign_to_forecast = create_campaign_to_forecast(); my $keyword_forecast_metrics_response = $api_client->KeywordPlanIdeaService()->generate_keyword_forecast_metrics({ customerId => $customer_id, campaign => $campaign_to_forecast, # Set the forecast range. Repeat forecasts with different horizons # to get a holistic picture. forecastPeriod => Google::Ads::GoogleAds::V26::Common::DateRange->new({ # Set the forecast start date to tomorrow. startDate => strftime("%Y-%m-%d", localtime(time + 60 * 60 * 24)), # Set the forecast end date to 30 days from today. endDate => strftime("%Y-%m-%d", localtime(time + 60 * 60 * 24 * 30))}) }); my $metrics = $keyword_forecast_metrics_response->{campaignForecastMetrics}; printf "Estimated daily clicks: %s.\n", defined $metrics->{clicks} ? $metrics->{clicks} : "undef"; printf "Estimated average cpc (micros): %s.\n\n", defined $metrics->{averageCpcMicros} ? $metrics->{averageCpcMicros} : "undef"; return 1; } # Creates the campaign to forecast. A campaign to forecast lets you try out # various configuration and keywords to find the best optimization for your # future campaigns. Once you've found the best campaign configuration, # create a serving campaign in your Google Ads account with similar values # and keywords. For more details, see: # https://support.google.com/google-ads/answer/3022575 sub create_campaign_to_forecast { my ($api_client) = @_; # Create a campaign to forecast. my $campaign_to_forecast = Google::Ads::GoogleAds::V26::Services::KeywordPlanIdeaService::CampaignToForecast ->new(); # Set the bidding strategy. $campaign_to_forecast->{biddingStrategy}->{manualCpcBiddingStrategy} = Google::Ads::GoogleAds::V26::Services::KeywordPlanIdeaService::ManualCpcBiddingStrategy ->new({maxCpcBidMicros => 1000000}); # See https://developers.google.com/google-ads/api/reference/data/geotargets # for the list of geo target IDs. # Geo target constant 2840 is for USA. $campaign_to_forecast->{geoTargetConstants} = [ Google::Ads::GoogleAds::V26::Utils::ResourceNames::geo_target_constant( 2840)]; # See https://developers.google.com/google-ads/api/reference/data/codes-formats#languages # for the list of language criteria IDs. $campaign_to_forecast->{languageConstants} = [ # Language criteria 1000 is for English. Google::Ads::GoogleAds::V26::Utils::ResourceNames::language_constant(1000)]; # Create forecast ad groups based on themes such as creative relevance, # product category, or cost per click. $campaign_to_forecast->{adGroups} = [ Google::Ads::GoogleAds::V26::Services::KeywordPlanIdeaService::ForecastAdGroup ->new({ keywords => [ Google::Ads::GoogleAds::V26::Common::KeywordInfo->new({ text => "mars cruise", matchType => 'BROAD' } ), Google::Ads::GoogleAds::V26::Common::KeywordInfo->new({ text => "cheap cruise", matchType => 'PHRASE' } ), Google::Ads::GoogleAds::V26::Common::KeywordInfo->new({ text => "jupiter cruise", matchType => 'EXACT' })]})]; return $campaign_to_forecast; }
curl
Kullanıcı arayüzüyle eşleme
Aşağıdaki tabloda, KeywordPlanIdeaService.GenerateKeywordForecastMetrics parametreleri Google Ads kullanıcı arayüzündeki Anahtar Kelime Planlayıcı ile eşlenmektedir:
| Kullanıcı arayüzünde Anahtar Kelime Planlayıcı | Google Ads API |
|---|---|
| Anahtar kelime girin |
|
| Konumlar |
|
| Diller | CampaignToForecast.language_constants |
| Günlük Bütçe | |
| TBM Teklifi | |
| Tarih Aralığı | GenerateKeywordForecastMetricsRequest.forecast_period |