Rekomendacje mogą ulepszyć Twoje kampanie na kilka sposobów:
- Wprowadzanie nowych i przydatnych funkcji
- Wykorzystaj pełny potencjał budżetu dzięki ulepszonym stawkom, słowom kluczowym i reklamom
- Zwiększanie ogólnej skuteczności i wydajności kampanii
Aby zwiększyć wyniki optymalizacji, możesz użyć metody RecommendationService
do pobierania rekomendacji, a następnie stosować je lub odrzucać. Możesz też subskrybować automatyczne stosowanie rekomendacji, korzystając z ikonyRecommendationSubscriptionService
.
Wynik optymalizacji
Wynik optymalizacji to prognoza skuteczności Twojego konta Google Ads. Jest on dostępny na poziomach Customer
i Campaign
.
Customer.optimization_score_weight
jest dostępny tylko na kontach innych niż konta menedżera i służy do obliczania ogólnego wyniku optymalizacji wielu kont. Pobierz wynik optymalizacji i wagę wyniku optymalizacji kont, a następnie pomnóż je przez siebie (Customer.optimization_score * Customer.optimization_score_weight
), aby obliczyć ogólny wynik optymalizacji.
W przypadku raportów customer
i campaign
dostępne są te dane związane z optymalizacją:
metrics.optimization_score_url
zawiera precyzyjny link do konta, na którym można wyświetlić informacje o powiązanych rekomendacjach w interfejsie Google Ads.- Wartość
metrics.optimization_score_uplift
określa, o ile wzrośnie wynik optymalizacji po zastosowaniu wszystkich powiązanych rekomendacji. Jest to szacunkowa wartość oparta na wszystkich dostępnych rekomendacjach jako całości, a nie tylko suma wyników wzrostu dla poszczególnych rekomendacji.
Aby pogrupować i uporządkować zwrócone rekomendacje, możesz podzielić oba te rodzaje danych według typu rekomendacji za pomocą symbolu segments.recommendation_type
w zapytaniu.
Typy rekomendacji
W pełni obsługiwane typy rekomendacji
RecommendationType | Opis |
---|---|
CAMPAIGN_BUDGET |
Naprawianie kampanii ograniczonych z powodu budżetu |
KEYWORD |
Dodaj nowe słowa kluczowe |
TEXT_AD |
Dodaj propozycje reklam |
TARGET_CPA_OPT_IN |
Ustalanie stawek za pomocą docelowego CPA |
MAXIMIZE_CONVERSIONS_OPT_IN |
Ustalanie stawek za pomocą strategii Maksymalizacja liczby konwersji |
MAXIMIZE_CONVERSION_VALUE_OPT_IN |
Ustalanie stawek za pomocą strategii Maksymalizacja wartości konwersji |
ENHANCED_CPC_OPT_IN |
Ustalanie stawek za pomocą Ulepszonego CPC |
MAXIMIZE_CLICKS_OPT_IN |
Ustalanie stawek za pomocą strategii Maksymalizacja liczby kliknięć |
OPTIMIZE_AD_ROTATION |
Używanie zoptymalizowanej rotacji reklam |
MOVE_UNUSED_BUDGET |
Przenoszenie niewykorzystanych budżetów do budżetów z ograniczeniami |
TARGET_ROAS_OPT_IN |
Ustalanie stawek za pomocą strategii Docelowy ROAS |
FORECASTING_CAMPAIGN_BUDGET |
Naprawianie kampanii, które w przyszłości mogą być ograniczone z powodu budżetu |
RESPONSIVE_SEARCH_AD |
Dodawanie nowej elastycznej reklamy w wyszukiwarce |
MARGINAL_ROI_CAMPAIGN_BUDGET |
Dostosowywanie budżetu kampanii w celu zwiększenia ROI |
USE_BROAD_MATCH_KEYWORD |
Używaj dopasowania przybliżonego w kampaniach opartych na konwersjach z automatycznym określaniem stawek. |
RESPONSIVE_SEARCH_AD_ASSET |
Dodawanie komponentów elastycznych reklam w wyszukiwarce do reklamy |
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH |
Zwiększanie skuteczności elastycznej reklamy w wyszukiwarce |
DISPLAY_EXPANSION_OPT_IN |
Aktualizowanie kampanii w sieci reklamowej w celu korzystania z rozszerzania zasięgu |
SEARCH_PARTNERS_OPT_IN |
Docieranie do nowych odbiorców dzięki partnerom w sieci wyszukiwania Google |
CUSTOM_AUDIENCE_OPT_IN |
Utwórz niestandardową listę odbiorców |
IMPROVE_DEMAND_GEN_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 standardowe kampanie produktowe do dotychczasowych kampanii Performance Max |
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX |
Przenoszenie dynamicznych reklam w wyszukiwarce do kampanii Performance Max |
PERFORMANCE_MAX_OPT_IN |
Tworzenie kampanii Performance Max na koncie |
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH |
Zwiększ siłę grupy plików w kampanii Performance Max do poziomu „Doskonała”. |
PERFORMANCE_MAX_FINAL_URL_OPT_IN |
Włączanie rozwinięcia końcowego adresu URL w kampaniach Performance Max |
RAISE_TARGET_CPA_BID_TOO_LOW |
Zwiększ docelowy CPA, gdy jest za niski i uzyskujesz bardzo mało lub wcale konwersji. |
FORECASTING_SET_TARGET_ROAS |
Zwiększ budżet przed wydarzeniem sezonowym, które według prognoz spowoduje wzrost natężenia ruchu, i zmień strategię ustalania stawek z Maksymalizacja wartości konwersji na Docelowy ROAS. |
LEAD_FORM_ASSET |
Dodawanie do kampanii komponentów z formularzem kontaktowym |
CALLOUT_ASSET |
Dodawanie komponentów z objaśnieniami na poziomie kampanii lub klienta |
SITELINK_ASSET |
Dodawanie komponentów z linkami do podstron na poziomie kampanii lub klienta |
CALL_ASSET |
Dodawanie komponentów 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 obniżone z powodu braku koloru |
SHOPPING_ADD_GENDER |
Dodawanie płci do ofert, które zostały obniżone z powodu braku płci |
SHOPPING_ADD_GTIN |
Dodawanie numeru GTIN (Global Trade Item Number) do ofert, które są obniżane z powodu braku numeru GTIN |
SHOPPING_ADD_MORE_IDENTIFIERS |
Dodawanie większej liczby identyfikatorów do ofert, które zostały obniżone z powodu braku identyfikatorów |
SHOPPING_ADD_SIZE |
Dodaj rozmiar do ofert, które zostały obniżone z powodu braku rozmiaru. |
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN |
Dodawanie produktów, aby kampania mogła wyświetlać reklamy |
SHOPPING_FIX_DISAPPROVED_PRODUCTS |
Popraw odrzucone produkty |
SHOPPING_TARGET_ALL_OFFERS |
Tworzenie kampanii zbiorczej kierowanej na wszystkie oferty |
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT |
Rozwiązywanie problemów z zawieszonym kontem Merchant Center |
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING |
Rozwiązywanie problemów z ostrzeżeniami o zawieszeniu konta Merchant Center |
DYNAMIC_IMAGE_EXTENSION_OPT_IN |
Włączanie dynamicznych rozszerzeń graficznych na koncie |
RAISE_TARGET_CPA |
Podniesienie docelowego CPA |
LOWER_TARGET_ROAS |
Obniżenie docelowego ROAS |
FORECASTING_SET_TARGET_CPA |
Ustaw docelowy CPA w kampaniach, w których nie jest on określony, przed wydarzeniem sezonowym, które według prognoz spowoduje wzrost natężenia ruchu. |
SET_TARGET_CPA |
Ustaw docelowy CPA w kampaniach, w których nie jest on określony |
SET_TARGET_ROAS |
Ustaw docelowy ROAS w kampaniach, w których nie jest on określony |
REFRESH_CUSTOMER_MATCH_LIST |
Aktualizowanie listy klientów, która nie była aktualizowana w ciągu ostatnich 90 dni |
IMPROVE_GOOGLE_TAG_COVERAGE |
Wdrażanie tagu Google na większej liczbie stron |
KEYWORD_MATCH_TYPE (wycofano) |
Wycofana. Zamiast niej używaj 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, Recommendation
obiekty są pobierane za pomocą metody GoogleAdsService.SearchStream
z zapytaniem w języku zapytań Google Ads.
Szczegółowe informacje o każdym typie rekomendacji są podane w polu dotyczącym konkretnej rekomendacji. Na przykład szczegóły CAMPAIGN_BUDGET
rekomendacji znajdują się w polu campaign_budget_recommendation
i są zawarte w obiekcie CampaignBudgetRecommendation
.
Wszystkie pola związane z rekomendacjami znajdziesz w polu unijnym recommendation
.
Wpływ rekomendacji
Niektóre typy rekomendacji wypełniają pole impact
rekomendacji.
RecommendationImpact
zawiera szacunkowy wpływ zastosowania rekomendacji na skuteczność konta. Te dane dotyczące rekomendacji są dostępne w polach impact.base_metrics
i impact.potential_metrics
:
impressions
clicks
cost_micros
conversions
all_conversions
video_views
Nawet jeśli pole impact
jest wypełnione, dostępność danych zależy m.in. od typu rekomendacji i typu kampanii. Zanim zaczniesz korzystać z poszczególnych danych o wpływie, sprawdź, czy są dostępne.
Przykładowy kod
Ten przykładowy kod pobiera wszystkie dostępne i odrzucone rekomendacje typu KEYWORD
z konta i wyświetla niektóre z nich:
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.V20.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); });
curl
# Gets keyword recommendations. # # Variables: # API_VERSION, # CUSTOMER_ID, # DEVELOPER_TOKEN, # MANAGER_CUSTOMER_ID, # OAUTH2_ACCESS_TOKEN: # See https://developers.google.com/google-ads/api/rest/auth#request_headers # for details. curl -f --request POST \ "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:search" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data @- <<EOF { "query": " SELECT recommendation.campaign, recommendation.keyword_recommendation FROM recommendation WHERE recommendation.type = KEYWORD " } EOF
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 obiekt rekomendacji resource_name
może stać się nieaktualny po pobraniu rekomendacji.
Zalecamy podejmowanie działań na podstawie rekomendacji wkrótce po ich pobraniu.
Zastosuj rekomendacje
Możesz zastosować aktywne lub odrzucone rekomendacje za pomocą metody
ApplyRecommendation
interfejsu
RecommendationService
.
Typy rekomendacji mogą mieć parametry obowiązkowe lub opcjonalne. Większość rekomendacji zawiera zalecane wartości, które są używane domyślnie.
Ustawianie kont pod kątem automatycznego stosowania rekomendacji nie jest obsługiwane w przypadku wszystkich 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 DetectAndApplyRecommendations
przykładzie kodu.
Użyj pola apply_parameters
ApplyRecommendationOperation
, aby zastosować rekomendacje z określonymi wartościami parametrów. Każdy odpowiedni typ rekomendacji ma własne pole.
W przypadku typów rekomendacji, których nie ma na liście w polu apply_parameters
, te wartości parametrów nie są używane.
Przykładowy kod
Poniższy kod pokazuje, jak utworzyć element ApplyRecommendationOperation
i jak zastąpić zalecane wartości 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::V20::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::V20::Resources::Ad->new({ # id => "INSERT_AD_ID_AS_INTEGER_HERE" # }); # my $text_ad_parameters = # Google::Ads::GoogleAds::V20::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::V20::Services::RecommendationService::ApplyRecommendationOperation ->new({ resourceName => $recommendation->{resourceName}}); return $apply_recommendation_operation; }
W następnym przykładzie wywoływana jest funkcja
ApplyRecommendation
, która wysyła operacje stosowania rekomendacji 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.V20.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}; }
curl
# Applies a recommendation. # # Variables: # API_VERSION, # CUSTOMER_ID, # DEVELOPER_TOKEN, # MANAGER_CUSTOMER_ID, # OAUTH2_ACCESS_TOKEN: # See https://developers.google.com/google-ads/api/rest/auth#request_headers # for details. # # RECOMMENDATION_RESOURCE_NAME: The resource name of the recommendation to # apply, from the previous request. curl -f --request POST \ "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/recommendations:apply" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data @- <<EOF { "operations": [ { "resourceName": "${RECOMMENDATION_RESOURCE_NAME}" } ] } EOF
Więcej informacji znajdziesz w tych filmach
Stosowanie parametrów
Zbiorczy
Błędy
Testy
Odrzucanie rekomendacji
Rekomendacje możesz odrzucić za pomocą ikony RecommendationService
. Struktura kodu jest podobna do stosowania rekomendacji, ale zamiast tego używasz elementów DismissRecommendationOperation
i RecommendationService.DismissRecommendation
.
Więcej informacji znajdziesz w tych filmach
Zbiorczy
Błędy
Testy
Włącz automatyczne stosowanie rekomendacji
Możesz użyć ikony
RecommendationSubscriptionService
do automatycznego stosowania rekomendacji określonego typu.
Aby zasubskrybować określony typ rekomendacji, utwórz obiekt RecommendationSubscription
, ustaw pole type
na jeden z obsługiwanych typów rekomendacji, a pole status
ustaw na ENABLED
.
Typy rekomendacji obsługiwane w ramach subskrypcji
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
Pobieranie subskrypcji
Aby uzyskać informacje o subskrypcjach rekomendacji na koncie, wyślij zapytanie do zasobu recommendation_subscription
.
Aby wyświetlić zmiany, które zostały zastosowane automatycznie, wyślij zapytanie do zasobu
change_event
, filtrując
change_event.client_type
na
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
.
Rekomendacje podczas tworzenia kampanii
Możesz użyć
RecommendationService.GenerateRecommendationsRequest
do generowania rekomendacji podczas tworzenia kampanii dla danego zestawu typów rekomendacji.
GenerateRecommendations
przyjmuje jako dane wejściowe identyfikator klienta, typ kanału reklamowego, który musi być równy SEARCH
lub PERFORMANCE_MAX
, listę typów rekomendacji do wygenerowania oraz różne punkty danych zależne od określonych typów. Zwraca listę obiektów Recommendation
na podstawie podanych danych. Jeśli nie ma wystarczających danych, aby wygenerować rekomendację dla żądanego recommendation_types
lub jeśli kampania jest już w rekomendowanym stanie, zestaw wyników nie będzie zawierać rekomendacji tego typu. Sprawdź, czy aplikacja obsługuje sytuację, w której dla żądanych typów rekomendacji nie są zwracane żadne rekomendacje.
W tabeli poniżej znajdziesz typy rekomendacji, które obsługuje GenerateRecommendations
, oraz pola, które musisz podać, aby otrzymywać rekomendacje tego typu. Zgodnie ze sprawdzonymi metodami wysyłaj żądanie GenerateRecommendations
po zebraniu wszystkich informacji związanych z rodzajami rekomendacji, o które prosisz. Więcej informacji o polach wymaganych i opcjonalnych, w tym o polach zagnieżdżonych, znajdziesz w dokumentacji.
RecommendationType | Pola wymagane | Pola opcjonalne |
---|---|---|
CAMPAIGN_BUDGET (od wersji 18) |
W przypadku kampanii w sieci wyszukiwania i kampanii Performance Max wymagane są te pola:
|
|
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 SitelinkAssetRecommendation , można ją traktować jako sygnał do dodania do kampanii co najmniej 1 komponentu linku do podstrony. |
|
|
TARGET_CPA_OPT_IN |
|
|
TARGET_ROAS_OPT_IN |
|
Przykładowy przepływ użycia
Załóżmy, że Twoja firma jest agencją reklamową, która udostępnia użytkownikom przepływ pracy związany z tworzeniem kampanii, i chcesz w jego trakcie wyświetlać użytkownikom sugestie. Możesz używać
GenerateRecommendationsRequest
do generowania rekomendacji na żądanie i integrować je
z interfejsem tworzenia kampanii.
Proces korzystania może wyglądać tak:
Użytkownik wchodzi do aplikacji, aby utworzyć kampanię Performance Max.
Użytkownik podaje wstępne informacje w ramach procesu tworzenia kampanii. Na przykład podają szczegóły, aby utworzyć jedną strategię
SitelinkAsset
, i wybierająTARGET_SPEND
jako strategię inteligentnego określania stawek.Wysyłasz żądanie
GenerateRecommendationsRequest
, w którym ustawiasz te pola:campaign_sitelink_count
: ustawiona na1
, czyli liczbę komponentów z linkami do podstron w kampanii w trakcie tworzenia.bidding_info
: ustaw zagnieżdżone polebidding_strategy_type
naTARGET_SPEND
.conversion_tracking_status
: ustaw naConversionTrackingStatus
tego klienta. Więcej informacji o tym, jak pobrać to pole, znajdziesz w przewodniku dla początkujących dotyczącym zarządzania konwersjami.recommendation_types
: ustaw wartość[SITELINK_ASSET, MAXIMIZE_CLICKS_OPT_IN]
.advertising_channel_type
: ustaw wartośćPERFORMANCE_MAX
.customer_id
: ustawiony na identyfikator klienta, który tworzy kampanię.
Możesz skorzystać z rekomendacji w
GenerateRecommendationsResponse
– w tym przypadku zSitelinkAssetRecommendation
iMaximizeClicksOptInRecommendation
– i zasugerować 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 użytkownik zakończy proces tworzenia kampanii.