Öneriler iyileştirilebilir birkaç şekilde ayarlayabilirsiniz:
- Yeni ve alakalı özellikleri tanıtın
- İyileştirilmiş teklifler, anahtar kelimeler ve reklamlarla bütçenizden daha iyi yararlanın
- Kampanyalarınızın genel performansını ve verimliliğini artırın
Optimizasyon puanlarını artırmak için
Almak için RecommendationService
ve ardından bunları uygun şekilde uygulayın veya reddedin. 15. sürümden itibaren
Google Ads API'sine abone olarak, otomatik olarak uygulama
önerileri görmek için RecommendationSubscriptionService
'yı kullanabilirsiniz.
Optimizasyon puanı
.Optimizasyon puanı,
Google Ads hesabınızın ne kadar iyi performans gösterecek şekilde ayarlandığına ve kullanılabilir olduğuna dair tahmini
Customer
ve
Campaign
düzeyler.
İlgili içeriği oluşturmak için kullanılan
Customer.optimization_score_weight
yalnızca yönetici olmayan hesaplar tarafından kullanılabilir ve genel
birden fazla hesabın optimizasyon puanını Optimizasyon puanını alın ve
hesapların optimizasyon puanı ağırlıklarını birbiriyle çarparak
Hesaplamak için (Customer.optimization_score * Customer.optimization_score_weight
)
ve genel optimizasyon puanını etkiler.
customer
ve campaign
için optimizasyonla ilgili metrikler var.
raporlar:
- İlgili içeriği oluşturmak için kullanılan
metrics.optimization_score_url
hesapla ilgili bilgileri görüntülemek için hesaba bir derin bağlantı sağlar. Google Ads kullanıcı arayüzündeki öneriler. - İlgili içeriği oluşturmak için kullanılan
metrics.optimization_score_uplift
tüm ilgili tüm dönüşümler sağlandığında optimizasyon puanının ne kadar artacağını emin olun. Mevcut tüm tahminlere göre yapılmış bir tahmindir toplam olarak değil, her bir aylık artış puanının öneririz.
Döndürülen önerileri gruplandırmak ve sıralamak için bu önerilerin ikisini de segmentlere ayırabilirsiniz
segments.recommendation_type
kullanarak öneri türüne göre metriklerinizi
emin olun.
Öneri türleri
Tam olarak desteklenen öneri türleri
RecommendationType | Açıklama |
---|---|
CAMPAIGN_BUDGET |
Bütçeyle sınırlı kampanyaları düzeltin |
KEYWORD |
Yeni anahtar kelimeler ekleyin |
TEXT_AD |
Reklam önerileri ekleyin |
TARGET_CPA_OPT_IN |
Hedef EBM ile teklif verin |
MAXIMIZE_CONVERSIONS_OPT_IN |
Dönüşümleri Artırma ile teklif verme |
MAXIMIZE_CONVERSION_VALUE_OPT_IN |
Dönüşüm Değerini Artırma ile Teklif Verin |
ENHANCED_CPC_OPT_IN |
Geliştirilmiş TBM ile teklif verin |
MAXIMIZE_CLICKS_OPT_IN |
Tıklamaları Artırma seçeneğiyle teklif verme |
OPTIMIZE_AD_ROTATION |
Optimize edilmiş reklam rotasyonlarını kullanın |
MOVE_UNUSED_BUDGET |
Kullanılmayan uygulamaları kısıtlanmış bütçelere taşıyın |
TARGET_ROAS_OPT_IN |
Hedef ROAS ile teklif verin |
FORECASTING_CAMPAIGN_BUDGET |
Bütçeyle sınırlı olması beklenen kampanyaları gelecek |
RESPONSIVE_SEARCH_AD |
Yeni duyarlı arama ağı reklamı ekle |
MARGINAL_ROI_CAMPAIGN_BUDGET |
Yatırım getirisini artırmak için kampanya bütçesini ayarlayın |
USE_BROAD_MATCH_KEYWORD |
Geniş kullan eşlemeyi otomatik teklif ile dönüşüme dayalı kampanyalar için |
RESPONSIVE_SEARCH_AD_ASSET |
Bir reklama duyarlı arama ağı reklamı öğeleri ekleme |
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH |
Duyarlı arama ağı reklamının gücünü artırın |
DISPLAY_EXPANSION_OPT_IN |
Görüntülü Reklam Ağı Opsiyonlu özelliğini kullanmak için bir kampanyayı güncelleme |
SEARCH_PARTNERS_OPT_IN |
Google Arama Ağı iş ortaklarıyla erişimi genişletin |
CUSTOM_AUDIENCE_OPT_IN |
Özel kitle oluşturun |
IMPROVE_DISCOVERY_AD_STRENGTH |
Talep Yaratma kampanyalarında reklamların gücünü artırın |
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX |
Akıllı Alışveriş kampanyalarını Maksimum Performans kampanyasına yükseltme |
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX |
Eski bir yerel kampanyayı Maksimum Performans kampanyasına yükseltme |
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX |
Normal Alışveriş Kampanyaları tarafından hedeflenen teklifleri mevcut kampanyalara taşıyın Maksimum Performans kampanyaları |
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX |
Dinamik Arama Ağı Reklamları kampanyalarını Maksimum Performans kampanyalarına taşıma |
PERFORMANCE_MAX_OPT_IN |
Hesabınızda Maksimum Performans kampanyaları oluşturun |
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH |
Maksimum Performans kampanyasının öğe grubu gücünü "Mükemmel" puan |
PERFORMANCE_MAX_FINAL_URL_OPT_IN |
Maksimum Performans kampanyalarınız için nihai URL genişletmesi özelliğini etkinleştirin |
RAISE_TARGET_CPA_BID_TOO_LOW |
Hedef EBM çok düşük olduğunda ve yüksek olduğunda veya hiç dönüşüm yok |
FORECASTING_SET_TARGET_ROAS |
Mevsimsel bir etkinlikten önce bütçeyi artırmak ve teklif stratejisini değiştireceği tahmin edilen dönüşüm değerini artırma stratejisinden hedef ROAS'a |
LEAD_FORM |
Bir kampanyaya potansiyel müşteri formu öğeleri ekleme |
CALLOUT_ASSET |
Kampanya veya müşteri düzeyine açıklama metni öğeleri ekleme |
SITELINK_ASSET |
Kampanya veya müşteri düzeyine site bağlantısı öğeleri ekleme |
CALL_ASSET |
Kampanya veya müşteri düzeyine telefon öğeleri ekleme |
SHOPPING_ADD_AGE_GROUP |
Şunun nedeniyle düşürülen tekliflere yaş grubu özelliğini ekleyin: eksik yaş grubu |
SHOPPING_ADD_COLOR |
Eksik bilgi nedeniyle sıralaması düşürülen tekliflere renk ekleyin renk |
SHOPPING_ADD_GENDER |
Öğe sayısı eksik olduğundan sıralaması düşürülen tekliflere cinsiyet ekleyin cinsiyet |
SHOPPING_ADD_GTIN |
Sıralaması düşürülen tekliflere GTIN (Global Ticari Öğe Numarası) ekleyin bir GTIN eksik olduğundan |
SHOPPING_ADD_MORE_IDENTIFIERS |
Eksik nedeniyle sıralaması düşürülen tekliflere daha fazla tanımlayıcı ekleyin tanımlayıcılar |
SHOPPING_ADD_SIZE |
Eksik olması nedeniyle sıralaması düşürülen tekliflere bedeni ekleyin. beden |
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN |
Bir kampanyanın yayınlanacağı ürünleri ekleyin |
SHOPPING_FIX_DISAPPROVED_PRODUCTS |
Onaylanmayan ürünleri düzeltin |
SHOPPING_TARGET_ALL_OFFERS |
Tüm teklifleri hedefleyen bir tümünü yakala kampanyası oluşturun |
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT |
Merchant Center hesabının askıya alınmasıyla ilgili sorunları düzeltin |
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING |
Merchant Center hesabının askıya alınmasıyla ilgili uyarı sorunlarını düzeltme |
DYNAMIC_IMAGE_EXTENSION_OPT_IN |
Hesapta dinamik resim uzantılarını etkinleştirin |
RAISE_TARGET_CPA |
Hedef EBM'yi artırın |
LOWER_TARGET_ROAS |
Daha düşük Hedef ROAS |
FORECASTING_SET_TARGET_CPA |
Belirtilmemiş kampanyalar için bir hedef EBM belirleyin: trafiği artırması tahmin edilen mevsimsel bir etkinliğin başlangıcı |
SET_TARGET_CPA |
Belirtilmemiş kampanyalar için bir hedef EBM belirleyin |
SET_TARGET_ROAS |
Belirtilmemiş kampanyalar için bir hedef ROAS belirleyin |
REFRESH_CUSTOMER_MATCH_LIST |
Son 90 yıldır güncellenmemiş bir müşteri listesini güncellemek gün |
IMPROVE_GOOGLE_TAG_COVERAGE |
Google etiketini daha fazla sayfaya dağıtın |
CALLOUT_EXTENSION (desteği sonlandırılmış) |
Kullanımdan kaldırıldı, bunun yerine CALLOUT_ASSET politikasını kullanın |
SITELINK_EXTENSION (desteği sonlandırılmış) |
Kullanımdan kaldırıldı, bunun yerine SITELINK_ASSET politikasını kullanın |
CALL_EXTENSION (desteği sonlandırılmış) |
Kullanımdan kaldırıldı, bunun yerine CALL_ASSET politikasını kullanın |
KEYWORD_MATCH_TYPE (desteği sonlandırılmış) |
Kullanımdan kaldırıldı, bunun yerine USE_BROAD_MATCH_KEYWORD politikasını kullanın |
Daha fazla bilgi edinmek için bu videoyu izleyin
Desteklenmeyen türleri işleyin
Önerileri al
.Google Ads API'deki diğer birçok varlık gibi, Recommendation
nesneleri
GoogleAdsService.SearchStream
Google Ads Sorgu Dili sorgusuyla çalışabilirsiniz.
Her öneri türü için ayrıntılar bir
belirli bir alan adı kullanabilirsiniz. Örneğin, CAMPAIGN_BUDGET
önerisi
ayrıntılara
campaign_budget_recommendation
alanı içine alır ve bir
CampaignBudgetRecommendation
nesnesini tanımlayın.
Öneriye özel tüm alanları
recommendation
birleşim alanı.
Öneri etkisi
Bazı öneri türleri,
impact
alanında görünür.
RecommendationImpact
bilgi edinmenin bir sonucu olarak hesap performansı üzerindeki
geri dönelim. Aşağıdakiler
öneri metriklerinin
impact.base_metrics
ve impact.potential_metrics
alanlarında kullanılabilir:
impressions
clicks
cost_micros
conversions
all_conversions
(Google Ads API'nin 16 sürümünden itibaren kullanılabilir)video_views
Kod örneği
Aşağıdaki örnek kod mevcut ve reddedilen tüm önerileri alır
bir hesaptan KEYWORD
türünü kullanır ve bu verilerin bir kısmını yazdırır:
Java
try (GoogleAdsServiceClient googleAdsServiceClient = googleAdsClient.getLatestVersion().createGoogleAdsServiceClient(); RecommendationServiceClient recommendationServiceClient = googleAdsClient.getLatestVersion().createRecommendationServiceClient()) { // Creates a query that retrieves keyword recommendations. String query = "SELECT recommendation.resource_name, " + " recommendation.campaign, " + " recommendation.keyword_recommendation " + "FROM recommendation " + "WHERE recommendation.type = KEYWORD"; // Constructs the SearchGoogleAdsStreamRequest. SearchGoogleAdsStreamRequest request = SearchGoogleAdsStreamRequest.newBuilder() .setCustomerId(Long.toString(customerId)) .setQuery(query) .build(); // Issues the search stream request to detect keyword recommendations that exist for the // customer account. ServerStream<SearchGoogleAdsStreamResponse> stream = googleAdsServiceClient.searchStreamCallable().call(request); // Creates apply operations for all the recommendations found. List<ApplyRecommendationOperation> applyRecommendationOperations = new ArrayList<>(); for (SearchGoogleAdsStreamResponse response : stream) { for (GoogleAdsRow googleAdsRow : response.getResultsList()) { Recommendation recommendation = googleAdsRow.getRecommendation(); System.out.printf( "Keyword recommendation '%s' was found for campaign '%s'%n", recommendation.getResourceName(), recommendation.getCampaign()); KeywordInfo keyword = recommendation.getKeywordRecommendation().getKeyword(); System.out.printf("\tKeyword = '%s'%n", keyword.getText()); System.out.printf("\tMatch type = '%s'%n", keyword.getMatchType()); // Creates an ApplyRecommendationOperation that will apply this recommendation, and adds // it to the list of operations. applyRecommendationOperations.add(buildRecommendationOperation(recommendation)); } }
C#
// Get the GoogleAdsServiceClient. GoogleAdsServiceClient googleAdsService = client.GetService( Services.V17.GoogleAdsService); // Creates a query that retrieves keyword recommendations. string query = "SELECT recommendation.resource_name, " + "recommendation.campaign, recommendation.keyword_recommendation " + "FROM recommendation WHERE " + $"recommendation.type = KEYWORD"; List<ApplyRecommendationOperation> operations = new List<ApplyRecommendationOperation>(); try { // Issue a search request. googleAdsService.SearchStream(customerId.ToString(), query, delegate (SearchGoogleAdsStreamResponse resp) { Console.WriteLine($"Found {resp.Results.Count} recommendations."); foreach (GoogleAdsRow googleAdsRow in resp.Results) { Recommendation recommendation = googleAdsRow.Recommendation; Console.WriteLine("Keyword recommendation " + $"{recommendation.ResourceName} was found for campaign " + $"{recommendation.Campaign}."); if (recommendation.KeywordRecommendation != null) { KeywordInfo keyword = recommendation.KeywordRecommendation.Keyword; Console.WriteLine($"Keyword = {keyword.Text}, type = " + "{keyword.MatchType}"); } operations.Add( BuildApplyRecommendationOperation(recommendation.ResourceName) ); } } ); } catch (GoogleAdsException e) { Console.WriteLine("Failure:"); Console.WriteLine($"Message: {e.Message}"); Console.WriteLine($"Failure: {e.Failure}"); Console.WriteLine($"Request ID: {e.RequestId}"); throw; }
PHP
$googleAdsServiceClient = $googleAdsClient->getGoogleAdsServiceClient(); // Creates a query that retrieves keyword recommendations. $query = 'SELECT recommendation.resource_name, recommendation.campaign, ' . 'recommendation.keyword_recommendation ' . 'FROM recommendation ' . 'WHERE recommendation.type = KEYWORD '; // Issues a search request to detect keyword recommendations that exist for the // customer account. $response = $googleAdsServiceClient->search(SearchGoogleAdsRequest::build($customerId, $query)); $operations = []; // Iterates over all rows in all pages and prints the requested field values for // the recommendation in each row. foreach ($response->iterateAllElements() as $googleAdsRow) { /** @var GoogleAdsRow $googleAdsRow */ $recommendation = $googleAdsRow->getRecommendation(); printf( "Keyword recommendation with resource name '%s' was found for campaign " . "with resource name '%s':%s", $recommendation->getResourceName(), $recommendation->getCampaign(), PHP_EOL ); if (!is_null($recommendation->getKeywordRecommendation())) { $keyword = $recommendation->getKeywordRecommendation()->getKeyword(); printf( "\tKeyword = '%s'%s\ttype = '%s'%s", $keyword->getText(), PHP_EOL, KeywordMatchType::name($keyword->getMatchType()), PHP_EOL ); } // Creates an ApplyRecommendationOperation that will be used to apply this // recommendation, and adds it to the list of operations. $operations[] = self::buildRecommendationOperation($recommendation->getResourceName()); }
Python
googleads_service = client.get_service("GoogleAdsService") query = f""" SELECT recommendation.campaign, recommendation.keyword_recommendation FROM recommendation WHERE recommendation.type = KEYWORD""" # Detects keyword recommendations that exist for the customer account. response = googleads_service.search(customer_id=customer_id, query=query) operations = [] for row in response.results: recommendation = row.recommendation print( f"Keyword recommendation ('{recommendation.resource_name}') " f"was found for campaign '{recommendation.campaign}." ) keyword = recommendation.keyword_recommendation.keyword print( f"\tKeyword = '{keyword.text}'\n" f"\tType = '{keyword.match_type}'" ) # Create an ApplyRecommendationOperation that will be used to apply # this recommendation, and add it to the list of operations. operations.append( build_recommendation_operation(client, recommendation.resource_name) )
Ruby
query = <<~QUERY SELECT recommendation.resource_name, recommendation.campaign, recommendation.keyword_recommendation FROM recommendation WHERE recommendation.type = KEYWORD QUERY google_ads_service = client.service.google_ads response = google_ads_service.search( customer_id: customer_id, query: query, ) operations = response.each do |row| recommendation = row.recommendation puts "Keyword recommendation ('#{recommendation.resource_name}') was found for "\ "campaign '#{recommendation.campaign}'." if recommendation.keyword_recommendation keyword = recommendation.keyword_recommendation.keyword puts "\tKeyword = '#{keyword.text}'" puts "\ttype = '#{keyword.match_type}'" end build_recommendation_operation(client, recommendation.resource_name) end
Perl
# Create the search query. my $search_query = "SELECT recommendation.resource_name, " . "recommendation.campaign, recommendation.keyword_recommendation " . "FROM recommendation " . "WHERE recommendation.type = KEYWORD"; # Get the GoogleAdsService. my $google_ads_service = $api_client->GoogleAdsService(); my $search_stream_handler = Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({ service => $google_ads_service, request => { customerId => $customer_id, query => $search_query }}); # Create apply operations for all the recommendations found. my $apply_recommendation_operations = (); $search_stream_handler->process_contents( sub { my $google_ads_row = shift; my $recommendation = $google_ads_row->{recommendation}; printf "Keyword recommendation '%s' was found for campaign '%s'.\n", $recommendation->{resourceName}, $recommendation->{campaign}; my $keyword = $recommendation->{keywordRecommendation}{keyword}; printf "\tKeyword = '%s'\n", $keyword->{text}; printf "\tMatch type = '%s'\n", $keyword->{matchType}; # Creates an ApplyRecommendationOperation that will apply this recommendation, and adds # it to the list of operations. push @$apply_recommendation_operations, build_recommendation_operation($recommendation); });
Harekete geçin
Alınan öneriler uygulanabilir veya reddedilebilir.
Öneri türüne bağlı olarak, öneriler günlük olarak değişebilir.
hatta günde birkaç kez. Bu durumda bir öneri
resource_name
öneri alındıktan sonra geçerliliğini yitirir.
Önerileri aldıktan kısa bir süre sonra gerekli işlemleri yapmak iyi bir uygulamadır.
Önerileri uygula
.Etkin veya reddedilmiş önerileri
ApplyRecommendation
yöntemindeki
RecommendationService
.
Öneri türlerinde zorunlu veya isteğe bağlı parametreler olabilir. En sık öneriler, varsayılan olarak kullanılan önerilen değerlerle birlikte sunulur.
Önerilerin otomatik olarak uygulanması için hesap oluşturulamaz
tüm öneri türleri için desteklenir. Ancak, daha fazla bilgi edinmek için
Google Ads API tarafından tam olarak desteklenen öneri türleri için geçerlidir.
DetectAndApplyRecommendations
koduna bakın.
örnek bölümüne bakın.
Şunu kullanın:
apply_parameters
önerilerin uygulanacağı ApplyRecommendationOperation
birlik alanı
belirli parametre değerleri. Her uygun öneri türünün kendi alanı vardır.
apply_parameters
alanında listelenmeyen hiçbir öneri türünde kullanılmaz
bu parametre değerlerini içerir.
Kod örneği
Aşağıdaki kod,
ApplyRecommendationOperation
ve
önerilen değerleri
sahip olmalıdır.
Java
/** Creates and returns an ApplyRecommendationOperation to apply the given recommendation. */ private ApplyRecommendationOperation buildRecommendationOperation(Recommendation recommendation) { // If you have a recommendation ID instead of a resource name, you can create a resource name // like this: // String resourceName = ResourceNames.recommendation(customerId, recommendationId); // Creates a builder to construct the operation. Builder operationBuilder = ApplyRecommendationOperation.newBuilder(); // Each recommendation type has optional parameters to override the recommended values. Below is // an example showing how to override a recommended ad when a TextAdRecommendation is applied. // operationBuilder.getTextAdBuilder().getAdBuilder().setResourceName("INSERT_AD_RESOURCE_NAME"); // Sets the operation's resource name to the resource name of the recommendation to apply. operationBuilder.setResourceName(recommendation.getResourceName()); return operationBuilder.build(); }
C#
private ApplyRecommendationOperation BuildApplyRecommendationOperation( string recommendationResourceName ) { // If you have a recommendation_id instead of the resource_name you can create a // resource name from it like this: // string recommendationResourceName = // ResourceNames.Recommendation(customerId, recommendationId) // Each recommendation type has optional parameters to override the recommended values. // This is an example to override a recommended ad when a TextAdRecommendation is // applied. // For details, please read // https://developers.google.com/google-ads/api/reference/rpc/latest/ApplyRecommendationOperation. /* Ad overridingAd = new Ad() { Id = "INSERT_AD_ID_AS_LONG_HERE" }; applyRecommendationOperation.TextAd = new TextAdParameters() { Ad = overridingAd }; */ ApplyRecommendationOperation applyRecommendationOperation = new ApplyRecommendationOperation() { ResourceName = recommendationResourceName }; return applyRecommendationOperation; }
PHP
private static function buildRecommendationOperation( string $recommendationResourceName ): ApplyRecommendationOperation { // If you have a recommendation_id instead of the resource name, you can create a resource // name from it like this: /* $recommendationResourceName = ResourceNames::forRecommendation($customerId, $recommendationId); */ // Each recommendation type has optional parameters to override the recommended values. // This is an example to override a recommended ad when a TextAdRecommendation is applied. // For details, please read // https://developers.google.com/google-ads/api/reference/rpc/latest/ApplyRecommendationOperation. /* $overridingAd = new Ad([ 'id' => 'INSERT_AD_ID_AS_INTEGER_HERE' ]); $applyRecommendationOperation->setTextAd(new TextAdParameters(['ad' => $overridingAd])); */ // Issues a mutate request to apply the recommendation. $applyRecommendationOperation = new ApplyRecommendationOperation(); $applyRecommendationOperation->setResourceName($recommendationResourceName); return $applyRecommendationOperation; }
Python
def build_recommendation_operation(client, recommendation): """Creates a ApplyRecommendationOperation to apply the given recommendation. Args: client: an initialized GoogleAdsClient instance. customer_id: a client customer ID. recommendation: a resource name for the recommendation to be applied. """ # If you have a recommendation ID instead of a resource name, you can create # a resource name like this: # # googleads_service = client.get_service("GoogleAdsService") # resource_name = googleads_service.recommendation_path( # customer_id, recommendation.id # ) operation = client.get_type("ApplyRecommendationOperation") # Each recommendation type has optional parameters to override the # recommended values. Below is an example showing how to override a # recommended ad when a TextAdRecommendation is applied. # # operation.text_ad.ad.resource_name = "INSERT_AD_RESOURCE_NAME" # # For more details, see: # https://developers.google.com/google-ads/api/reference/rpc/latest/ApplyRecommendationOperation#apply_parameters operation.resource_name = recommendation return operation
Ruby
def build_recommendation_operation(client, recommendation) # If you have a recommendation_id instead of the resource_name # you can create a resource name from it like this: # recommendation_resource = # client.path.recommendation(customer_id, recommendation_id) operations = client.operation.apply_recommendation operations.resource_name = recommendation_resource # Each recommendation type has optional parameters to override the recommended # values. This is an example to override a recommended ad when a # TextAdRecommendation is applied. # # text_ad_parameters = client.resource.text_ad_parameters do |tap| # tap.ad = client.resource.ad do |ad| # ad.id = "INSERT_AD_ID_AS_INTEGER_HERE" # end # end # operation.text_ad = text_ad_parameters # # For more details, see: # https://developers.google.com/google-ads/api/reference/rpc/latest/ApplyRecommendationOperation#apply_parameters return operation end
Perl
sub build_recommendation_operation { my ($recommendation) = @_; # If you have a recommendation ID instead of a resource name, you can create a resource # name like this: # my $recommendation_resource_name = # Google::Ads::GoogleAds::V17::Utils::ResourceNames::recommendation( # $customer_id, $recommendation_id); # Each recommendation type has optional parameters to override the recommended values. # Below is an example showing how to override a recommended ad when a TextAdRecommendation # is applied. # my $overriding_ad = Google::Ads::GoogleAds::V17::Resources::Ad->new({ # id => "INSERT_AD_ID_AS_INTEGER_HERE" # }); # my $text_ad_parameters = # Google::Ads::GoogleAds::V17::Services::RecommendationService::TextAdParameters # ->new({ad => $overriding_ad}); # $apply_recommendation_operation->{textAd} = $text_ad_parameters; # Create an apply recommendation operation. my $apply_recommendation_operation = Google::Ads::GoogleAds::V17::Services::RecommendationService::ApplyRecommendationOperation ->new({ resourceName => $recommendation->{resourceName}}); return $apply_recommendation_operation; }
Bir sonraki örnek
ApplyRecommendation
önceki adımda oluşturulan öneri uygulama işlemlerini göndererek
girin.
Java
// Issues a mutate request to apply the recommendations. ApplyRecommendationResponse applyRecommendationsResponse = recommendationServiceClient.applyRecommendation( Long.toString(customerId), applyRecommendationOperations); for (ApplyRecommendationResult applyRecommendationResult : applyRecommendationsResponse.getResultsList()) { System.out.printf( "Applied recommendation with resource name: '%s'.%n", applyRecommendationResult.getResourceName()); }
C#
private void ApplyRecommendation(GoogleAdsClient client, long customerId, List<ApplyRecommendationOperation> operations) { // Get the RecommendationServiceClient. RecommendationServiceClient recommendationService = client.GetService( Services.V17.RecommendationService); ApplyRecommendationRequest applyRecommendationRequest = new ApplyRecommendationRequest() { CustomerId = customerId.ToString(), }; applyRecommendationRequest.Operations.AddRange(operations); ApplyRecommendationResponse response = recommendationService.ApplyRecommendation(applyRecommendationRequest); foreach (ApplyRecommendationResult result in response.Results) { Console.WriteLine("Applied a recommendation with resource name: " + result.ResourceName); } }
PHP
private static function applyRecommendations( GoogleAdsClient $googleAdsClient, int $customerId, array $operations ): void { // Issues a mutate request to apply the recommendations. $recommendationServiceClient = $googleAdsClient->getRecommendationServiceClient(); $response = $recommendationServiceClient->applyRecommendation( ApplyRecommendationRequest::build($customerId, $operations) ); foreach ($response->getResults() as $appliedRecommendation) { /** @var Recommendation $appliedRecommendation */ printf( "Applied a recommendation with resource name: '%s'.%s", $appliedRecommendation->getResourceName(), PHP_EOL ); } }
Python
def apply_recommendations(client, customer_id, operations): """Applies a batch of recommendations. Args: client: an initialized GoogleAdsClient instance. customer_id: a client customer ID. operations: a list of ApplyRecommendationOperation messages. """ # Issues a mutate request to apply the recommendations. recommendation_service = client.get_service("RecommendationService") response = recommendation_service.apply_recommendation( customer_id=customer_id, operations=operations ) for result in response.results: print( "Applied a recommendation with resource name: " f"'{result[0].resource_name}'." )
Ruby
def apply_recommendations(client, customer_id, operations) # Issues a mutate request to apply the recommendation. recommendation_service = client.service.recommendation response = recommendation_service.apply_recommendation( customer_id: customer_id, operations: [operations], ) response.results.each do |applied_recommendation| puts "Applied recommendation with resource name: '#{applied_recommendation.resource_name}'." end end
Perl
# Issue a mutate request to apply the recommendations. my $apply_recommendation_response = $api_client->RecommendationService()->apply({ customerId => $customer_id, operations => $apply_recommendation_operations }); foreach my $result (@{$apply_recommendation_response->{results}}) { printf "Applied recommendation with resource name: '%s'.\n", $result->{resourceName}; }
Daha fazla bilgi edinmek için bu videoları izleyin
Parametreleri uygula
Toplu
Hatalar
Testler
Önerileri kapatma
.Önerileri
RecommendationService
. Kod
yapısı, önerileri uygulamaya benzer ancak bunun yerine
DismissRecommendationOperation
ve
RecommendationService.DismissRecommendation
.
Daha fazla bilgi edinmek için bu videoları izleyin
Toplu
Hatalar
Testler
Önerileri otomatik olarak uygulayın
Google Ads API'nin 15. sürümünden itibaren,
RecommendationSubscriptionService
özelliğini kullanabilirsiniz.
Belirli bir öneri türüne abone olmak için
RecommendationSubscription
nesne,
type
alanını şu değerlerden birine ayarlayın:
desteklenen öneri
türlerini belirleyin ve
status
alanını ENABLED
olarak ayarlayın.
Abonelik tarafından desteklenen öneri türleri
ENHANCED_CPC_OPT_IN
KEYWORD
KEYWORD_MATCH_TYPE
LOWER_TARGET_ROAS
MAXIMIZE_CLICKS_OPT_IN
OPTIMIZE_AD_ROTATION
RAISE_TARGET_CPA
RESPONSIVE_SEARCH_AD
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH
SEARCH_PARTNERS_OPT_IN
SEARCH_PLUS_OPT_IN
SET_TARGET_CPA
SET_TARGET_ROAS
TARGET_CPA_OPT_IN
TARGET_ROAS_OPT_IN
USE_BROAD_MATCH_KEYWORD
Abonelikleri alma
Bir hesabın öneri abonelikleri hakkında bilgi edinmek için
recommendation_subscription
kaynağı.
Otomatik olarak uygulanan değişiklikleri görüntülemek için
change_event
kaynağını filtreler.
change_client_type
-
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
.
Kampanya oluştururken öneriler
Google Ads API'nin 16. sürümünden itibaren,
RecommendationService.GenerateRecommendationsRequest
kampanya oluşturma sırasında belirli bir grup için öneriler
yardımcı olur.
GenerateRecommendations
; müşteri kimliği veya reklam kanalı olarak kabul eder.
veya olmalıdır.
SEARCH
veya
PERFORMANCE_MAX
,
oluşturulacak öneri türlerinin listesi ve bunlara bağlı çeşitli veri noktaları
belirtilen türlerde. Şuna dayalı olarak Recommendation
nesnenin bir listesini çıkarır:
bu kapsamdadır. Öneri oluşturmak için yeterli veri yoksa
istenen
recommendation_types
Kampanya zaten önerilen durumdaysa sonuç kümesi
o tür için bir öneri içerir. Uygulamanızın şu gereksinimleri karşıladığından emin olun:
istenen öneri için hiçbir önerinin döndürülmediği durum
bulunur.
Aşağıdaki tabloda, Google'ın kitle hedefleme özelliğini
GenerateRecommendations
tarafından desteklenen alanlar ve bu verileri almak için
size yardımcı olabilir. En iyi uygulama olarak
Tüm bilgiler toplandıktan sonra GenerateRecommendations
isteği
alakalı olması gerekir. Ayrıntılı bilgi için
iç içe geçmiş alanlar dahil olmak üzere zorunlu ve isteğe bağlı alanlar için
referans belgeleri.
RecommendationType | Zorunlu alanlar | İsteğe bağlı alanlar |
---|---|---|
KEYWORD |
|
|
MAXIMIZE_CLICKS_OPT_IN |
|
|
MAXIMIZE_CONVERSIONS_OPT_IN |
|
|
MAXIMIZE_CONVERSION_VALUE_OPT_IN |
|
|
SET_TARGET_CPA |
|
|
SET_TARGET_ROAS |
|
|
SITELINK_ASSET .
Not: Döndürülen SitelinkAssetRecommendation
nesnesi boş listeler içerecek. GenerateRecommendations
yanıt SitelinkAssetRecommendation içeriyorsa
Kampanyaya en az bir site bağlantısı öğesi eklemeye yönelik bir sinyal olarak değerlendiriliyor. |
|
|
TARGET_CPA_OPT_IN |
|
|
TARGET_ROAS_OPT_IN |
|
Örnek kullanım akışı
Şirketinizin bir reklam ajansı olduğunu varsayalım.
kullanıcılara inşaat iş akışı sunar ve kullanıcılara
bu akışta geri dönüyor. Tekliflerinizi otomatikleştirmek ve optimize etmek için
GenerateRecommendationsRequest
isteğe bağlı öneriler oluşturmak ve bu önerileri uygulamak için
kullanıcı arayüzünüze entegre edebilirsiniz.
Kullanım akışı aşağıdaki gibi görünebilir:
Bir kullanıcı, Maksimum Performans kampanyası oluşturmak için uygulamanıza gelir.
Kullanıcı, kampanya kapsamında bazı başlangıç bilgileri sağlar en iyi yöntemin ne olduğunu öğreneceğiz. Örneğin, tek bir web sitesi için
SitelinkAsset
veTARGET_SPEND
Akıllı Teklif olarak kullanıyor. üzerine konuşacağız.Aşağıdaki alanları ayarlayan bir
GenerateRecommendationsRequest
gönderirsiniz:campaign_sitelink_count
:1
olarak ayarlanmıştır. Bu sayı, devam eden çalışmalardaki site bağlantısı öğelerinin sayısı pek de iyi olmadığını unutmayın.bidding_info
: iç içe yerleştirilmişbidding_strategy_type
alanınıTARGET_SPEND
olarak ayarlayın.conversion_tracking_status
: değerine ayarlayınConversionTrackingStatus
. Bu alanın nasıl alınacağıyla ilgili yardım için şu sayfayı ziyaret edin: Başlarken rehberini okuyun.recommendation_types
:[SITELINK_ASSET, MAXIMIZE_CLICKS_OPT_IN]
olarak ayarlandı.advertising_channel_type
:PERFORMANCE_MAX
olarak ayarlandı.customer_id
: Kampanyayı oluşturan müşterinin kimliğine ayarlanır.
Şuradaki önerileri uygulayabilirsiniz:
GenerateRecommendationsResponse
- Bu örnekte,SitelinkAssetRecommendation
veMaximizeClicksOptInRecommendation
ve kampanyanızda görüntüleyerek kullanıcılara bu reklamları önerin inşaat arayüzü. Kullanıcı bir öneriyi kabul ederse şunu yapabilirsiniz: Kullanıcı işlemi tamamladıktan sonra bunu kampanya oluşturma isteğine dahil edebilir adımları uygulayın.