Metrik perkiraan memberikan
estimasi metrik performa (KeywordForecastMetrics) untuk
kampanye yang diusulkan atau yang sudah ada. Metrik perkiraan yang tersedia bergantung pada versi API dan strategi bidding yang didukung:
- v24 dan yang lebih baru:
clicks(klik): Hanya ditampilkan saat menggunakanManualCpcBiddingStrategyatauMaximizeClicksBiddingStrategy.cost_micros(biaya): Total perkiraan biaya dalam mikro.average_cpc_micros(biaya per klik rata-rata): Hanya ditampilkan saat menggunakanManualCpcBiddingStrategyatauMaximizeClicksBiddingStrategydanclicks > 0.conversions(konversi): Hanya ditampilkan saat menggunakanMaximizeConversionsBiddingStrategy.average_cpa_micros(biaya per akuisisi rata-rata): Hanya ditampilkan saat menggunakanMaximizeConversionsBiddingStrategy(dihitung sebagaicost_micros / conversions).
- v23 dan yang lebih lama:
- Selain
clicks,cost_micros,average_cpc_micros,conversions, danaverage_cpa_micros(ditampilkan di semua strategi bidding),KeywordForecastMetricsjuga menampilkanimpressions(tayangan iklan),click_through_rate(rasio klik-tayang), danconversion_rate(rasio konversi).
- Selain
Bereksperimenlah dengan berbagai konfigurasi kampanye untuk mengoptimalkan setiap metrik ini. Perkiraan menggunakan data seperti histori skor kualitas dan rasio klik-tayang untuk menyimulasikan performa yang diharapkan.
Metrik perkiraan biasanya digunakan setelah menemukan kandidat kata kunci dengan ide kata kunci atau memfilter daftar kata kunci yang ada dengan metrik historis, dan secara opsional mengelompokkan kata kunci tersebut dengan tema grup iklan. Meskipun metrik historis mempersempit kumpulan besar kandidat kata kunci berdasarkan volume penelusuran sebelumnya, metrik perkiraan menyimulasikan performa di masa mendatang sehingga Anda dapat mengoptimalkan bid, anggaran harian, dan penargetan sebelum memperbarui kampanye yang ditayangkan.
Membuat metrik
Untuk membuat metrik perkiraan, selesaikan langkah-langkah berikut:
- Buat objek
CampaignToForecastyang mewakili konfigurasi kampanye, objekForecastAdGroup, dan strategi bidding yang ingin Anda evaluasi. - Panggil
KeywordPlanIdeaService.GenerateKeywordForecastMetricsdenganCampaignToForecasttersebut danforecast_periodopsional (yang tanggal mulainya harus di masa mendatang dan tanggal akhirnya dalam satu tahun dari hari ini; jika dihilangkan, tanggal defaultnya adalah hari Minggu berikutnya hingga hari Sabtu berikutnya dalam zona waktu akun pelanggan). - Baca
KeywordForecastMetricstingkat kampanye dari kolomcampaign_forecast_metricsdiGenerateKeywordForecastMetricsResponse.
Membuat kampanye untuk perkiraan
Berikut beberapa tips saat membuat kampanye untuk memperkirakan:
- Buat grup iklan berdasarkan tema seperti relevansi materi iklan, kategori produk, atau biaya per klik (atau gunakan saran dari
GenerateAdGroupThemes). - Di v23 dan yang lebih lama, sertakan kata kunci negatif umum menggunakan
CampaignToForecast.negative_keywordsatauForecastAdGroup.negative_keywords(misalnya, jika Anda tidak berada di bidang rekrutmen, kecualikan kata kunci'jobs'). Di v24 dan yang lebih baru,negative_keywordsdihapus. - Gunakan akun yang terkait dengan kampanye. Jangan membuat perkiraan dari akun yang tidak terkait. Google mempertimbangkan skor kualitas dan konten materi iklan dalam perkiraan.
- Jika kampanye tidak terkait dengan akun Anda lainnya, gunakan akun baru yang bersih untuk perkiraan.
- Ulangi perkiraan dengan horizon yang berbeda untuk mendapatkan gambaran yang menyeluruh.
Perbedaan versi
Di v24 dan yang lebih baru, CampaignToForecast, ForecastAdGroup, dan
KeywordForecastMetrics menggunakan skema yang disederhanakan dibandingkan dengan v23 dan
yang lebih lama, seperti yang ditunjukkan dalam tabel berikut:
| Fitur | v24 dan yang lebih baru | v23 dan yang lebih lama |
|---|---|---|
| Kata kunci grup iklan | ForecastAdGroup.keywords (repeated KeywordInfo) |
ForecastAdGroup.biddable_keywords (repeated BiddableKeyword) |
| Penargetan lokasi | CampaignToForecast.geo_target_constants (repeated string nama resource) |
CampaignToForecast.geo_modifiers (repeated CriterionBidModifier dengan pengali bid opsional) |
| Penargetan jaringan penelusuran | Tidak ditentukan di CampaignToForecast (defaultnya adalah Google Penelusuran) |
CampaignToForecast.keyword_plan_network yang diperlukan |
| Kata kunci negatif | Tidak didukung di CampaignToForecast atau ForecastAdGroup |
Didukung menggunakan CampaignToForecast.negative_keywords dan ForecastAdGroup.negative_keywords |
| Penggantian bid CPC grup iklan dan kata kunci | Hanya dikonfigurasi di tingkat strategi bidding kampanye (ManualCpcBiddingStrategy.max_cpc_bid_micros atau MaximizeClicksBiddingStrategy.max_cpc_bid_ceiling_micros) |
Dapat juga diganti per grup iklan (ForecastAdGroup.max_cpc_bid_micros) atau per kata kunci (BiddableKeyword.max_cpc_bid_micros) |
| Rasio konversi kustom yang diperkirakan | Tidak didukung di CampaignToForecast |
CampaignToForecast.conversion_rate opsional |
| Metrik perkiraan yang ditampilkan | clicks dan average_cpc_micros (khusus CPC Manual atau Maksimalkan Klik), cost_micros, conversions, dan average_cpa_micros (khusus Maksimalkan Konversi) |
Menampilkan clicks, cost_micros, average_cpc_micros, conversions, dan average_cpa_micros di semua strategi bidding, ditambah impressions, click_through_rate, dan conversion_rate |
Contoh kode
Contoh kode berikutnya membuat permintaan ke
KeywordPlanIdeaService.GenerateKeywordForecastMetrics. Skrip ini
membuat CampaignToForecast inline dengan grup iklan dan kata kunci, lalu
menampilkan campaign_forecast_metrics yang ditampilkan.
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
Memetakan ke UI
Tabel berikut memetakan parameter
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
ke Keyword Planner di UI Google Ads:
| Keyword Planner di UI | Google Ads API |
|---|---|
| Masukkan Kata Kunci |
|
| Lokasi |
|
| Bahasa | CampaignToForecast.language_constants |
| Anggaran Harian | |
| Bid CPC | |
| Rentang Tanggal | GenerateKeywordForecastMetricsRequest.forecast_period |