Wynik optymalizacji i rekomendacje

ondemand_video Film: szczegółowa analiza

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

• przedstawiać nowe i odpowiednie funkcje;
• Wykorzystaj w pełni swój budżet dzięki ulepszonym stawkom, słowom kluczowym i reklamami
• Zwiększanie ogólnej skuteczności kampanii

Aby zwiększyć wyniki optymalizacji, możesz użyć karty RecommendationService, aby pobrać rekomendacje, a następnie je zastosować lub odrzucić. Możesz też subskrybować automatyczne stosowanie rekomendacji, korzystając z funkcji RecommendationSubscriptionService.

Wynik optymalizacji

ondemand_video Film: wynik optymalizacji

Wynik optymalizacji to prognoza skuteczności Twojego konta Google Ads. Jest on dostępny na poziomach Customer i Campaign.

Wartość 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 dla wielu kont. Pobierz wynik optymalizacji i wagę wyniku optymalizacji z kont, a następnie pomnóż je (Customer.optimization_score * Customer.optimization_score_weight), aby obliczyć ogólny wynik optymalizacji.

W raportach customer i campaign dostępne są dane związane z optymalizacją:

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_upliftpokazuje, o ile wzrośnie wynik optymalizacji po zastosowaniu wszystkich powiązanych rekomendacji. Jest to prognoza oparta na wszystkich dostępnych rekomendacjach jako całości, a nie tylko na sumie wyników wzrostu w przypadku poszczególnych rekomendacji.

Aby pogrupować i posortować zwrócone rekomendacje, możesz podzielić te dane według typu rekomendacji za pomocą parametru segments.recommendation_type w zapytaniu.

Typy rekomendacji

Pobieranie rekomendacji

ondemand_video Wideo: kodowanie na żywo

Podobnie jak w przypadku większości innych elementów w interfejsie Google Ads API, obiekty Recommendation są pobierane za pomocą zapytania w języku zapytań Google Ads (GoogleAdsService.SearchStream).

Szczegóły 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 są zawinięte w obiekt CampaignBudgetRecommendation.

Znajdź wszystkie pola związane z rekomendacjami w polu zjednoczenia 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 dotyczące 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:

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
      

// 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
      

$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
      

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
      

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
      

# 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ą wygenerowaną rekomendację można zastosować lub odrzucić.

W zależności od typu rekomendacje mogą się zmieniać codziennie lub nawet kilka razy dziennie. W takim przypadku wartość resource_name obiektu rekomendacji może się zdezaktualizować po pobraniu rekomendacji.

Zalecamy, aby działania związane z rekomendacjami podejmować tuż po ich pobraniu.

Zastosuj rekomendacje

ondemand_video Film: stosowanie rekomendacji

Możesz stosować aktywne lub odrzucone rekomendacje za pomocą metody ApplyRecommendationRecommendationService.

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 wdrożyć 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 z union apply_parametersApplyRecommendationOperation, aby stosować rekomendacje z określonymi wartościami parametrów. Każdy odpowiedni typ rekomendacji ma własne pole. Typ rekomendacji, który nie jest wymieniony w polu apply_parameters, nie używa tych wartości parametrów.

Przykładowy kod

Poniższy kod pokazuje, jak utworzyć parametr ApplyRecommendationOperation oraz jak zastąpić zalecane wartości, jeśli chcesz użyć własnych.

/** 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
      

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
      

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
      

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
      

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
      

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 zastosowania rekomendacji utworzone w poprzednim kodzie.

// 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
      

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
      

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
      

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
      

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
      

# 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
      

Odrzucanie rekomendacji

ondemand_video Film: odrzucanie rekomendacji

Rekomendacje możesz odrzucić za pomocą przycisku RecommendationService. Struktura kodu jest podobna do zastosowania rekomendacji, ale zamiast tego używasz DismissRecommendationOperation i RecommendationService.DismissRecommendation.

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 pole status na ENABLED.

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, przeprowadź zapytanie do zasobu change_event, filtrując je od change_event.client_type do 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 przyjmuje jako dane wejściowe identyfikator klienta, typ kanału reklamowego, który musi być albo SEARCH, albo PERFORMANCE_MAX, listę typów rekomendacji do wygenerowania oraz różne punkty danych zależne od podanych typów. Wypisuje listę obiektów Recommendation na podstawie podanych przez Ciebie danych. Jeśli nie ma wystarczających danych, aby wygenerować rekomendację dotyczącą żądanego recommendation_types, lub jeśli kampania jest już w zalecanym stanie, zestaw wyników nie będzie zawierać rekomendacji tego typu. Upewnij się, że Twoja aplikacja obsługuje przypadek, w którym nie zwracane są ż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.

Przykładowy proces korzystania

Załóżmy, że Twoja firma to agencja reklamowa, która udostępnia użytkownikom proces tworzenia kampanii. Chcesz, aby użytkownicy mogli otrzymywać podczas tego procesu sugestie. Możesz używać GenerateRecommendationsRequest, aby generować rekomendacje na żądanie i wprowadzać 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. Na przykład podają szczegóły, aby utworzyć pojedynczy SitelinkAsset, i wybierają TARGET_SPEND jako strategię inteligentnego określania stawek.

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

   • campaign_sitelink_count: ustaw na 1, czyli liczbę komponentów z linkami do podstron w kampanii w etapowej fazie realizacji.

   • 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 na identyfikator klienta tworzącego kampanię.

4. Możesz zastosować rekomendacje w GenerateRecommendationsResponse – w tym przypadku SitelinkAssetRecommendationi 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.