Wynik optymalizacji i rekomendacje

Wideo: szczegółowe omówienie

Rekomendacje mogą poprawić skuteczność kampanii na kilka sposobów:

  • Wprowadzanie nowych, przydatnych funkcji
  • Lepsze wykorzystanie budżetu dzięki lepszym stawkom, słowom kluczowym i reklamom
  • Zwiększanie ogólnej skuteczności i skuteczności kampanii

Aby poprawić wyniki optymalizacji, możesz za pomocą polecenia RecommendationService pobierać rekomendacje, a następnie stosować je lub odrzucać. Możesz też subskrybować automatyczne stosowanie rekomendacji, korzystając z funkcji RecommendationSubscriptionService.

Wynik optymalizacji

Film: wynik optymalizacji

Wynik optymalizacji to prognoza skuteczności Twojego konta Google Ads i jej dostępności na poziomach Customer i Campaign.

Tabela Customer.optimization_score_weight jest dostępna tylko na kontach, które nie są kontami menedżera i służy do obliczania ogólnego wyniku optymalizacji wielu kont. Pobierz wynik optymalizacji i wagę wyniku optymalizacji poszczególnych kont, a następnie pomnóż je (Customer.optimization_score * Customer.optimization_score_weight), aby obliczyć ogólny wynik optymalizacji.

W przypadku raportów customer i campaign dostępne są dane dotyczące optymalizacji:

  1. metrics.optimization_score_urlprzekierowuje do precyzyjnego linku na koncie, dzięki któremu możesz wyświetlić w interfejsie Google Ads informacje o powiązanych rekomendacjach.
  2. metrics.optimization_score_uplift informuje, o ile poprawiłby się wynik optymalizacji, gdyby zastosowano wszystkie powiązane rekomendacje. Jest to szacunkowa wartość obliczona na podstawie wszystkich dostępnych rekomendacji, a nie tylko sumy wyników wzrostu poszczególnych rekomendacji.

Aby zgrupować i uporządkować zwrócone rekomendacje, możesz podzielić te dane na segmenty według typu rekomendacji, używając w zapytaniu atrybutu segments.recommendation_type.

Typy rekomendacji

W pełni obsługiwane typy rekomendacji

RecommendationType Opis
CAMPAIGN_BUDGET Popraw kampanie ograniczone z powodu budżetu
KEYWORD Dodaj nowe słowa kluczowe
TEXT_AD Dodaj propozycje reklam
TARGET_CPA_OPT_IN Ustalaj stawki z użyciem docelowego CPA
MAXIMIZE_CONVERSIONS_OPT_IN Ustalanie stawek pod kątem maksymalizacji liczby konwersji
MAXIMIZE_CONVERSION_VALUE_OPT_IN Ustalanie stawek ze strategią Maksymalizacja wartości konwersji
ENHANCED_CPC_OPT_IN Ustalaj stawki z użyciem Ulepszonego CPC
MAXIMIZE_CLICKS_OPT_IN Ustalanie stawek za pomocą strategii Maksymalizacja liczby kliknięć
OPTIMIZE_AD_ROTATION Korzystanie z zoptymalizowanej rotacji reklam
MOVE_UNUSED_BUDGET Przenieś niewykorzystane środki do ograniczonych budżetów
TARGET_ROAS_OPT_IN Ustalaj stawki z użyciem docelowego ROAS
FORECASTING_CAMPAIGN_BUDGET Napraw kampanie, które prawdopodobnie będą w przyszłości ograniczone z powodu budżetu
RESPONSIVE_SEARCH_AD Dodaj nową elastyczną reklamę w wyszukiwarce
MARGINAL_ROI_CAMPAIGN_BUDGET Dostosuj budżet kampanii, aby zwiększyć ROI
USE_BROAD_MATCH_KEYWORD Używanie 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 Jak zaktualizować kampanię, aby 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 Poprawianie 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 Przenieś oferty, na które kierowane są zwykłe kampanie produktowe, do dotychczasowych kampanii Performance Max
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX Przenoszenie kampanii 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 komponentów w kampanii Performance Max do oceny „Excellent”
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 on za niski i generuje mało konwersji lub nie ma ich wcale
FORECASTING_SET_TARGET_ROAS Zwiększ budżet z wyprzedzeniem przed wydarzeniem sezonowym, które ma zwiększyć ruch, a następnie zmień strategię ustalania stawek ze Maksymalizacja wartości konwersji na Docelowy ROAS
LEAD_FORM Dodawanie komponentów z formularzami kontaktowymi do kampanii
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 zdegradowane z powodu braku tej grupy
SHOPPING_ADD_COLOR Dodaj kolor do ofert, które zostały zdegradowane z powodu braku koloru
SHOPPING_ADD_GENDER Dodaj płeć do ofert, które zostały zdegradowane z powodu braku płci.
SHOPPING_ADD_GTIN Dodaj numer GTIN (globalny numer jednostki handlowej) do ofert, które są przesuwane w dół z powodu braku numeru GTIN
SHOPPING_ADD_MORE_IDENTIFIERS Dodaj więcej identyfikatorów do ofert, które zostały zdegradowane z powodu braku identyfikatorów
SHOPPING_ADD_SIZE Dodaj rozmiar do ofert, które zostały zdegradowane z powodu braku rozmiaru
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN Dodawanie produktów do wyświetlania w ramach kampanii
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 zawieszonymi kontami Merchant Center
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING Rozwiązywanie problemów związanych z ostrzeżeniem o zawieszeniu konta Merchant Center
DYNAMIC_IMAGE_EXTENSION_OPT_IN Włączanie dynamicznych rozszerzeń graficznych na koncie
RAISE_TARGET_CPA Zwiększanie 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 sezonowym wydarzeniem, które według prognozy zwiększy natężenie ruchu
SET_TARGET_CPA Ustawianie docelowego CPA w przypadku kampanii, w których nie został on określony
SET_TARGET_ROAS Ustaw docelowy ROAS dla kampanii, które nie mają określonego docelowego ROAS
REFRESH_CUSTOMER_MATCH_LIST Zaktualizuj listę 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 (wycofany) Wycofano. Zamiast niego użyj atrybutu CALLOUT_ASSET
SITELINK_EXTENSION (wycofany) Wycofane. Zamiast tego używaj SITELINK_ASSET
CALL_EXTENSION (wycofany) Wycofano, zamiast niego użyj atrybutu CALL_ASSET
KEYWORD_MATCH_TYPE (wycofany) Wycofane, użyj w zamiast niego USE_BROAD_MATCH_KEYWORD

Aby dowiedzieć się więcej, obejrzyj ten film

Obsługa nieobsługiwanych typów

Pobieranie rekomendacji

Film: kodowanie na żywo

Podobnie jak większość innych elementów w interfejsie Google Ads API, obiekty Recommendation są pobierane za pomocą parametru GoogleAdsService.SearchStream z zapytaniem w języku zapytań Google Ads.

Szczegóły dotyczące każdego typu rekomendacji są podawane w polu dotyczącym rekomendacji. Na przykład szczegóły rekomendacji CAMPAIGN_BUDGET znajdują się w polu campaign_budget_recommendation i znajdują się w obiekcie CampaignBudgetRecommendation.

Wszystkie pola związane z rekomendacjami znajdziesz w polu sumy danych recommendation.

Wpływ rekomendacji

Niektóre typy rekomendacji wypełniają pole impact rekomendacji. RecommendationImpact zawiera szacowany wpływ na skuteczność konta po zastosowaniu rekomendacji. W polach impact.base_metrics i impact.potential_metrics dostępne są te dane rekomendacji:

  • impressions

  • clicks

  • cost_micros

  • conversions

  • all_conversions

  • video_views

Przykładowy kod

Poniższy przykładowy kod pobiera z konta wszystkie dostępne i odrzucone rekomendacje typu KEYWORD oraz 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));
    }
  }
DetectAndApplyRecommendations.java

C#

// Get the GoogleAdsServiceClient.
GoogleAdsServiceClient googleAdsService = client.GetService(
    Services.V18.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;
}
DetectAndApplyRecommendations.cs

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());
}
DetectAndApplyRecommendations.php

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)
    )
detect_and_apply_recommendations.py

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
detect_and_apply_recommendations.rb

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);
  });
detect_and_apply_recommendations.pl

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 w ciągu dnia. W takim przypadku wartość resource_name obiektu rekomendacji może się zdezaktualizować po pobraniu rekomendacji.

Zalecamy podejmowanie działań w związku z rekomendacjami wkrótce 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 wymagane lub opcjonalne. Większość rekomendacji zawiera zalecane wartości, które są używane domyślnie.

Ustawienie kont pod kątem automatycznego stosowania rekomendacji nie jest obsługiwane w przypadku wszystkich typów rekomendacji. Możesz jednak zastosować podobne działanie w przypadku typów rekomendacji, które są w pełni obsługiwane przez interfejs Google Ads API. Aby dowiedzieć się więcej, zapoznaj się z przykladem kodu DetectAndApplyRecommendations.

Używaj pola sumowania apply_parameters ApplyRecommendationOperation, aby stosować rekomendacje z określonymi wartościami parametrów. Każdy odpowiedni typ rekomendacji ma własne pole. Żaden typ rekomendacji, który nie jest wymieniony w polu apply_parameters, nie używa tych wartości parametrów.

Przykładowy kod

Ten 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();
}
DetectAndApplyRecommendations.java

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;
}
DetectAndApplyRecommendations.cs

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;
}
DetectAndApplyRecommendations.php

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
detect_and_apply_recommendations.py

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
detect_and_apply_recommendations.rb

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::V18::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::V18::Resources::Ad->new({
  #   id => "INSERT_AD_ID_AS_INTEGER_HERE"
  # });
  # my $text_ad_parameters =
  #   Google::Ads::GoogleAds::V18::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::V18::Services::RecommendationService::ApplyRecommendationOperation
    ->new({
      resourceName => $recommendation->{resourceName}});

  return $apply_recommendation_operation;
}
detect_and_apply_recommendations.pl

Następny przykład wywołuje funkcję ApplyRecommendation, wysyłając 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());
}
DetectAndApplyRecommendations.java

C#

private void ApplyRecommendation(GoogleAdsClient client, long customerId,
    List<ApplyRecommendationOperation> operations)
{
    // Get the RecommendationServiceClient.
    RecommendationServiceClient recommendationService = client.GetService(
        Services.V18.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);
    }
}
DetectAndApplyRecommendations.cs

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
        );
    }
}
DetectAndApplyRecommendations.php

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}'."
        )
detect_and_apply_recommendations.py

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
detect_and_apply_recommendations.rb

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};
}
detect_and_apply_recommendations.pl

Aby dowiedzieć się więcej, obejrzyj te filmy

Stosowanie parametrów

Zbiorczy

Błędy

Testy

Odrzucanie rekomendacji

Wideo: odrzucanie rekomendacji

Rekomendacje możesz odrzucić za pomocą przycisku RecommendationService. Struktura kodu jest podobna do stosowania rekomendacji, ale korzystasz z DismissRecommendationOperation i RecommendationService.DismissRecommendation.

Aby dowiedzieć się więcej, obejrzyj te filmy

Zbiorczy

Błędy

Testy

Włącz automatyczne stosowanie rekomendacji

Możesz użyć opcji RecommendationSubscriptionService, aby automatycznie stosować rekomendacje określonego typu.

Aby subskrybować określony typ rekomendacji, utwórz obiekt RecommendationSubscription, ustaw pole type na jeden z obsługiwanych typów rekomendacji, a następnie ustaw pole status na ENABLED.

Typy rekomendacji dostępne 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, prześ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 wartość change_event.client_type według parametru GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION.

Rekomendacje dotyczące tworzenia kampanii

Możesz użyć parametru RecommendationService.GenerateRecommendationsRequest do generowania rekomendacji podczas tworzenia kampanii w przypadku danego zbioru typów rekomendacji.

GenerateRecommendations akceptuje jako dane wejściowe identyfikator klienta, czyli typ kanału reklamowego SEARCH lub PERFORMANCE_MAX, listę typów rekomendacji do wygenerowania i różne punkty danych zależne od określonych typów. Na podstawie podanych przez Ciebie danych zwraca listę obiektów Recommendation. Jeśli nie ma wystarczającej ilości danych do wygenerowania rekomendacji dla żądanego typu recommendation_types lub jeśli kampania ma już zalecany stan, zestaw wyników nie będzie zawierał rekomendacji dla tego typu. Sprawdź, czy aplikacja obsługuje przypadek, w którym nie są zwracane żadne rekomendacje dla żądanych typów rekomendacji.

W tabeli poniżej opisano typy rekomendacji obsługiwane przez usługę GenerateRecommendations oraz pola, które musisz podać, aby otrzymywać rekomendacje tego typu. Zgodnie ze sprawdzoną metodą żądanie GenerateRecommendations należy wysłać po zebraniu wszystkich informacji związanych z wymaganymi typami rekomendacji. 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:
  • final_url
  • bidding_strategy_type
W przypadku kampanii w sieci wyszukiwania musisz też wypełnić te pola:
  • country_code
  • language_code
  • positive_location_id lub negative_location_id
  • ad_group_info.keywords
  • bidding_info.
    bidding_strategy_target_info.
    target_impression_share_info    , jeśli strategia ustalania stawek ma ustawioną wartość TARGET_IMPRESSION_SHARE
  • asset_group_info
  • budget_info
KEYWORD
  • seed_info
  • ad_group_info
MAXIMIZE_CLICKS_OPT_IN
  • conversion_tracking_status
  • bidding_info
MAXIMIZE_CONVERSIONS_OPT_IN
  • conversion_tracking_status
  • bidding_info
MAXIMIZE_CONVERSION_VALUE_OPT_IN
  • conversion_tracking_status
  • bidding_info
SET_TARGET_CPA
  • conversion_tracking_status
  • bidding_info
SET_TARGET_ROAS
  • conversion_tracking_status
  • bidding_info
SITELINK_ASSET
Uwaga: zwrócony obiekt SitelinkAssetRecommendation będzie zawierać puste listy. Jeśli odpowiedź GenerateRecommendations zawiera SitelinkAssetRecommendation, może to być traktowane jako sygnał, że do kampanii należy dodać co najmniej 1 komponent linku do podstrony.
  • campaign_sitelink_count
TARGET_CPA_OPT_IN
  • conversion_tracking_status
  • bidding_info
TARGET_ROAS_OPT_IN
  • conversion_tracking_status
  • bidding_info

Przykładowy proces

Załóżmy, że Twoja firma jest agencją reklamową, która zajmuje się tworzeniem kampanii użytkownikom i chcesz w tym czasie oferować użytkownikom sugestie. Za pomocą GenerateRecommendationsRequest możesz generować rekomendacje na żądanie i stosować je w interfejsie tworzenia kampanii.

Proces korzystania może wyglądać tak:

  1. Użytkownik wchodzi do Twojej aplikacji, aby utworzyć kampanię Performance Max.

  2. Użytkownik podaje wstępne informacje w ramach procesu tworzenia kampanii. Podaje np. szczegóły potrzebne do utworzenia pojedynczego SitelinkAsset i wybiera TARGET_SPEND jako strategię inteligentnego określania stawek.

  3. Wysyłasz pole GenerateRecommendationsRequest, które ustawia te pola:

    • campaign_sitelink_count: ustaw na 1, czyli liczbę komponentów z linkami do podstron w kampanii w etapie tworzenia.

    • bidding_info: ustaw zagnieżdżone pole bidding_strategy_type na TARGET_SPEND.

    • conversion_tracking_status: ustaw wartość ConversionTrackingStatus tego klienta. Wskazówki dotyczące uzyskiwania tego pola znajdziesz w przewodniku dotyczącym zarządzania konwersjami.

    • 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ę.

  4. Możesz skorzystać z rekomendacji w GenerateRecommendationsResponse (w tym przypadku w SitelinkAssetRecommendation i MaximizeClicksOptInRecommendation) i 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 użytkownik ukończy proces tworzenia kampanii.