Rekomendacje mogą zwiększać skuteczność kampanii na kilka sposobów:
- Wprowadzanie nowych i przydatnych funkcji
- Lepiej wykorzystaj budżet dzięki ulepszonym stawkom, słowom kluczowym i reklamom
- Zwiększanie ogólnej skuteczności i skuteczności kampanii
Aby zwiększyć wyniki optymalizacji, możesz za pomocą metody RecommendationService
pobierać rekomendacje, a potem je stosować lub odrzucać. Od wersji 15 interfejsu Google Ads API możesz też zasubskrybować automatyczne stosowanie rekomendacji za pomocą interfejsu RecommendationSubscriptionService
.
Wynik optymalizacji
Wynik optymalizacji to prognoza skuteczności Twojego konta Google Ads. Jest on dostępny na poziomach Customer
i Campaign
.
Kolumna Customer.optimization_score_weight
jest dostępna tylko na kontach innych niż menedżera i służy do obliczania ogólnego wyniku optymalizacji wielu kont. Pobierz wartości wyniku optymalizacji i wyniku optymalizacji kont oraz pomnóż przez siebie (Customer.optimization_score * Customer.optimization_score_weight
), aby obliczyć ogólny wynik optymalizacji.
W raportach customer
i campaign
dostępne są dane dotyczące optymalizacji:
metrics.optimization_score_url
zawiera precyzyjny link do konta, który pozwala wyświetlać informacje o powiązanych rekomendacjach w interfejsie Google Ads.metrics.optimization_score_uplift
informuje, o ile zwiększyłby się wynik optymalizacji po zastosowaniu wszystkich powiązanych rekomendacji. Jest to szacunkowa wartość obliczona na podstawie wszystkich dostępnych rekomendacji, a nie tylko sumy wyników wzrostu każdej rekomendacji.
Aby pogrupować i uporządkować zwrócone rekomendacje, możesz podzielić je na segmenty według typu rekomendacji, korzystając w zapytaniu z funkcji segments.recommendation_type
.
Typy rekomendacji
W pełni obsługiwane typy rekomendacji
RecommendationType | Opis |
---|---|
CAMPAIGN_BUDGET |
Napraw kampanie ograniczone z powodu budżetu |
KEYWORD |
Dodaj nowe słowa kluczowe |
TEXT_AD |
Dodaj propozycje reklam |
TARGET_CPA_OPT_IN |
Ustalaj stawki z uwzględnieniem docelowego CPA |
MAXIMIZE_CONVERSIONS_OPT_IN |
Ustalaj stawki, korzystając ze strategii Maksymalizacja liczby konwersji |
MAXIMIZE_CONVERSION_VALUE_OPT_IN |
Ustalanie stawek pod kątem maksymalizacji wartości konwersji |
ENHANCED_CPC_OPT_IN |
Ustalaj stawki z użyciem Ulepszonego CPC |
MAXIMIZE_CLICKS_OPT_IN |
Ustalaj stawki, korzystając ze strategii Maksymalizacja liczby kliknięć |
OPTIMIZE_AD_ROTATION |
Użyj zoptymalizowanych rotacji reklam |
MOVE_UNUSED_BUDGET |
Przenieś niewykorzystane budżety do ograniczonych budżetów |
TARGET_ROAS_OPT_IN |
Ustalaj stawki z uwzględnieniem docelowego ROAS |
FORECASTING_CAMPAIGN_BUDGET |
Napraw kampanie, które mogą w przyszłości być ograniczone z powodu budżetu |
RESPONSIVE_SEARCH_AD |
Dodaj nową elastyczną reklamę w wyszukiwarce |
MARGINAL_ROI_CAMPAIGN_BUDGET |
Dostosuj budżet kampanii, by zwiększyć ROI |
USE_BROAD_MATCH_KEYWORD |
W kampaniach opartych na konwersjach z automatycznym określaniem stawek użyj dopasowania przybliżonego |
RESPONSIVE_SEARCH_AD_ASSET |
Dodawanie do reklamy komponentów elastycznych reklam w wyszukiwarce |
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH |
Zwiększanie skuteczności elastycznej reklamy w wyszukiwarce |
DISPLAY_EXPANSION_OPT_IN |
Aktualizowanie kampanii, by korzystać z rozszerzenia na sieć reklamową |
SEARCH_PARTNERS_OPT_IN |
Docieraj do nowych odbiorców dzięki partnerom w sieci wyszukiwania Google |
CUSTOM_AUDIENCE_OPT_IN |
Utwórz niestandardową listę odbiorców |
IMPROVE_DISCOVERY_AD_STRENGTH |
Zwiększanie skuteczności reklam w kampaniach generujących popyt |
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX |
Przekształcanie inteligentnej kampanii produktowej w kampanię Performance Max |
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX |
Przekształcanie starszej kampanii lokalnej w kampanię Performance Max |
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX |
Przenoszenie ofert kierowanych przez zwykłe kampanie produktowe do istniejących kampanii Performance Max |
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX |
Przekształcanie dynamicznych reklam w wyszukiwarce w kampanie Performance Max |
PERFORMANCE_MAX_OPT_IN |
Tworzenie kampanii Performance Max na koncie |
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH |
Zwiększ skuteczność grupy plików w kampanii Performance Max do oceny „Świetna” |
PERFORMANCE_MAX_FINAL_URL_OPT_IN |
Włączanie Rozwinięcia końcowego adresu URL w kampaniach Performance Max |
RAISE_TARGET_CPA_BID_TOO_LOW |
Podnieś docelowy CPA, gdy jest za niski przy niewielkiej liczbie konwersji lub przy ich braku |
FORECASTING_SET_TARGET_ROAS |
Zwiększ budżet przed wydarzeniem sezonowym, które według prognozy ma zwiększyć ruch, i zmień strategię ustalania stawek z Maksymalizacji wartości konwersji na Docelowy ROAS |
LEAD_FORM |
Dodawanie do kampanii komponentów z formularzem kontaktowym |
CALLOUT_ASSET |
Dodaj komponenty z objaśnieniami na poziomie kampanii lub klienta |
SITELINK_ASSET |
Dodaj komponenty z linkami do podstron na poziomie kampanii lub klienta |
CALL_ASSET |
Dodaj komponenty do wykonywania połączeń na poziomie kampanii lub klienta |
SHOPPING_ADD_AGE_GROUP |
Dodaj atrybut grupa wiekowa do ofert, które zostały obniżone z powodu braku grupy wiekowej |
SHOPPING_ADD_COLOR |
Dodaj kolor do ofert, które zostały przesunięte w dół z powodu brakującego koloru |
SHOPPING_ADD_GENDER |
Dodawanie płci do ofert, które zostały obniżone z powodu brakującej płci |
SHOPPING_ADD_GTIN |
Dodaj numer GTIN (globalny numer jednostki handlowej) do ofert, które zostały przesunięte w dół z powodu brakującego numeru GTIN |
SHOPPING_ADD_MORE_IDENTIFIERS |
Dodaj więcej identyfikatorów do ofert, które zostały przesunięte w dół z powodu braku identyfikatorów |
SHOPPING_ADD_SIZE |
Dodaj rozmiar do ofert, które zostały obniżone z powodu brakującego rozmiaru |
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN |
Dodaj produkty do kampanii, które mają się wyświetlać |
SHOPPING_FIX_DISAPPROVED_PRODUCTS |
Popraw odrzucone produkty |
SHOPPING_TARGET_ALL_OFFERS |
Utwórz kampanię zbiorczą kierowaną na wszystkie oferty |
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT |
Rozwiązywanie problemów z zawieszeniem konta Merchant Center |
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING |
Rozwiązywanie problemów związanych z ostrzeżeniami o zawieszeniu konta Merchant Center |
DYNAMIC_IMAGE_EXTENSION_OPT_IN |
Włącz na koncie dynamiczne rozszerzenia graficzne |
RAISE_TARGET_CPA |
Podnieś docelowy CPA |
LOWER_TARGET_ROAS |
Niższy docelowy ROAS |
FORECASTING_SET_TARGET_CPA |
Ustaw docelowy CPA dla kampanii, które nie mają jeszcze wartości, przed wydarzeniem sezonowym, w którym według prognozy zwiększy się ruch |
SET_TARGET_CPA |
Ustawianie docelowego CPA w kampaniach, które nie mają go ustawionego |
SET_TARGET_ROAS |
Ustawianie docelowego ROAS w kampaniach, które go nie mają |
REFRESH_CUSTOMER_MATCH_LIST |
Aktualizowanie listy klientów, która nie była aktualizowana w ciągu ostatnich 90 dni |
IMPROVE_GOOGLE_TAG_COVERAGE |
Wdróż tag Google na większej liczbie stron |
CALLOUT_EXTENSION (wycofano) |
Wycofano, zamiast tego użyj zasady CALLOUT_ASSET |
SITELINK_EXTENSION (wycofano) |
Wycofano, zamiast tego użyj zasady SITELINK_ASSET |
CALL_EXTENSION (wycofano) |
Wycofano, zamiast tego użyj zasady CALL_ASSET |
KEYWORD_MATCH_TYPE (wycofano) |
Wycofano, zamiast tego użyj zasady USE_BROAD_MATCH_KEYWORD |
Więcej informacji w filmie
Obsługa nieobsługiwanych typów
Pobieranie rekomendacji
Podobnie jak większość innych elementów w interfejsie Google Ads API, obiekty Recommendation
są pobierane za pomocą metody GoogleAdsService.SearchStream
w połączeniu z zapytaniem w języku Google Ads Query Language.
Szczegółowe informacje o poszczególnych typach rekomendacji są podane w odpowiednich polach. Na przykład szczegóły rekomendacji CAMPAIGN_BUDGET
znajdują się w polu campaign_budget_recommendation
i są umieszczone w obiekcie CampaignBudgetRecommendation
.
Wszystkie pola dotyczące rekomendacji znajdziesz w polu sumy recommendation
.
Wpływ rekomendacji
Niektóre typy rekomendacji wypełniają pole impact
.
Pole RecommendationImpact
zawiera szacowany wpływ zastosowania rekomendacji na skuteczność konta. W polach impact.base_metrics
i impact.potential_metrics
dostępne są te dane rekomendacji:
impressions
clicks
cost_micros
conversions
all_conversions
(dostępny od wersji 16 interfejsu Google Ads API)video_views
Przykładowy kod
Ten przykładowy kod pobiera z konta wszystkie dostępne i odrzucone rekomendacje typu KEYWORD
i wyświetla niektóre ich szczegóły:
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); });
Podejmij działanie
Każdą pobraną rekomendację można zastosować lub odrzucić.
W zależności od typu rekomendacji mogą się one zmieniać codziennie lub nawet kilka razy dziennie. W takim przypadku resource_name
obiektu rekomendacji może stać się przestarzały po pobraniu rekomendacji.
Warto podjąć działania związane z rekomendacjami tuż po ich pobraniu.
Zastosuj rekomendacje
Wideo: stosowanie rekomendacji
Aktywne lub odrzucone rekomendacje możesz stosować za pomocą metody ApplyRecommendation
RecommendationService
.
Typy rekomendacji mogą mieć parametry obowiązkowe lub opcjonalne. Większość rekomendacji ma zalecane wartości, które są używane domyślnie.
Ustawianie kont na potrzeby automatycznego stosowania rekomendacji nie jest obsługiwane w przypadku niektórych typów rekomendacji. Możesz jednak wdrożyć podobne działanie w przypadku typów rekomendacji, które są w pełni obsługiwane przez interfejs Google Ads API.
Więcej informacji znajdziesz w przykładzie kodu DetectAndApplyRecommendations
.
Aby stosować rekomendacje z określonymi wartościami parametrów, użyj pola sumy apply_parameters
wartości ApplyRecommendationOperation
. Każdy odpowiedni typ rekomendacji ma własne pole.
Żaden typ rekomendacji niewymieniony w polu apply_parameters
nie korzysta z tych wartości parametrów.
Przykładowy kod
Poniższy kod pokazuje, jak utworzyć ApplyRecommendationOperation
i jak zastąpić zalecane wartości, jeśli chcesz je zastąpić własnymi.
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; }
Następny przykład wywołuje funkcję ApplyRecommendation
, wysyłając operacje stosowania rekomendacji, które zostały utworzone w poprzednim kodzie.
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}; }
Obejrzyj te filmy, by dowiedzieć się więcej
Zastosuj parametry
Sprzedaż hurtowa
Błędy
Testy
Odrzucanie rekomendacji
Rekomendacje możesz odrzucać za pomocą RecommendationService
. Struktura kodu jest podobna do stosowania rekomendacji, ale zamiast tego używasz DismissRecommendationOperation
i RecommendationService.DismissRecommendation
.
Obejrzyj te filmy, by dowiedzieć się więcej
Sprzedaż hurtowa
Błędy
Testy
Włącz automatyczne stosowanie rekomendacji
Począwszy od wersji 15 interfejsu Google Ads API, możesz używać interfejsu RecommendationSubscriptionService
do automatycznego stosowania rekomendacji określonego typu.
Aby zasubskrybować konkretny typ rekomendacji, utwórz obiekt RecommendationSubscription
, w polu type
wybierz jeden z obsługiwanych typów rekomendacji, a w polu status
ustaw wartość ENABLED
.
Typy rekomendacji obsługiwane przez subskrypcje
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
Pobierz subskrypcje
Aby uzyskać informacje o subskrypcjach rekomendacji na koncie, wyślij zapytanie do zasobu recommendation_subscription
.
Aby wyświetlić zmiany zastosowane automatycznie, wyślij zapytanie do zasobu change_event
, filtrując change_client_type
według wartości GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
.
Rekomendacje dotyczące tworzenia kampanii
Począwszy od wersji 16 interfejsu Google Ads API, możesz używać narzędzia RecommendationService.GenerateRecommendationsRequest
do generowania rekomendacji podczas tworzenia kampanii dla określonego zestawu typów rekomendacji.
GenerateRecommendations
akceptuje jako dane wejściowe identyfikator klienta, typ kanału reklamowego SEARCH
lub PERFORMANCE_MAX
, listę typów rekomendacji do wygenerowania oraz różne punkty danych zależne od określonych typów. Na podstawie podanych przez Ciebie danych generuje listę obiektów Recommendation
. Jeśli nie ma wystarczającej ilości danych do wygenerowania rekomendacji dotyczącej żądanego elementu recommendation_types
lub jeśli kampania jest już w stanie zalecanym, zestaw wyników nie będzie zawierał rekomendacji dotyczącej tego typu. Upewnij się, że aplikacja obsługuje przypadek, w którym nie są zwracane żadne rekomendacje dotyczące żądanych typów rekomendacji.
W tabeli poniżej opisujemy typy rekomendacji obsługiwane przez GenerateRecommendations
oraz pola, które musisz podać, aby otrzymywać rekomendacje tego typu. Sprawdzoną metodą jest wysłanie żądania GenerateRecommendations
po zgromadzeniu wszystkich informacji związanych z żądanymi typami rekomendacji. Więcej informacji na temat pól wymaganych i opcjonalnych, w tym pól zagnieżdżonych, znajdziesz w dokumentacji referencyjnej.
RecommendationType | Pola wymagane | Pola opcjonalne |
---|---|---|
KEYWORD |
|
|
MAXIMIZE_CLICKS_OPT_IN |
|
|
MAXIMIZE_CONVERSIONS_OPT_IN |
|
|
MAXIMIZE_CONVERSION_VALUE_OPT_IN |
|
|
SET_TARGET_CPA |
|
|
SET_TARGET_ROAS |
|
|
SITELINK_ASSET
Uwaga: zwrócony obiekt SitelinkAssetRecommendation będzie zawierał puste listy. Jeśli odpowiedź GenerateRecommendations zawiera element SitelinkAssetRecommendation , można ją traktować jako sygnał do dodania do kampanii co najmniej 1 komponentu z linkami do podstron. |
|
|
TARGET_CPA_OPT_IN |
|
|
TARGET_ROAS_OPT_IN |
|
Przykładowy przepływ wykorzystania
Załóżmy, że Twoja firma jest agencją reklamową, która zajmuje się tworzeniem kampanii dla użytkowników i chcesz oferować użytkownikom sugestie podczas tego procesu. Za pomocą narzędzia GenerateRecommendationsRequest
możesz generować rekomendacje na żądanie i stosować je w interfejsie tworzenia kampanii.
Proces korzystania może wyglądać tak:
Użytkownik otwiera aplikację, aby utworzyć kampanię Performance Max.
Użytkownik podaje wstępne informacje w trakcie tworzenia kampanii. Podaje na przykład szczegóły potrzebne do utworzenia pojedynczego elementu
SitelinkAsset
i jako strategię inteligentnego określania stawek wybieraTARGET_SPEND
.Wysyłasz
GenerateRecommendationsRequest
, który ustawia te pola:campaign_sitelink_count
: ustaw wartość1
, czyli liczbę komponentów z linkami do podstron w trwającej kampanii.bidding_info
: ustaw zagnieżdżone polebidding_strategy_type
naTARGET_SPEND
.conversion_tracking_status
: ustaw wartośćConversionTrackingStatus
tego klienta. Wskazówki, jak pobrać to pole, znajdziesz w przewodniku zarządzania konwersjami dla początkujących.recommendation_types
: ustaw wartość[SITELINK_ASSET, MAXIMIZE_CLICKS_OPT_IN]
.advertising_channel_type
: ustaw wartośćPERFORMANCE_MAX
.customer_id
: ustaw identyfikator klienta tworzącego kampanię.
Możesz skorzystać z rekomendacji dostępnych w interfejsie
GenerateRecommendationsResponse
(w tym przypadku w językachSitelinkAssetRecommendation
iMaximizeClicksOptInRecommendation
), a potem zaproponować je użytkownikowi, wyświetlając je w interfejsie tworzenia kampanii. Jeśli użytkownik zaakceptuje sugestię, możesz ją uwzględnić w prośbie o utworzenie kampanii, gdy tylko zakończy proces tworzenia kampanii.