Показатель оптимизации и рекомендации

ondemand_video Видео: глубокое погружение

Рекомендации могут улучшить ваши кампании несколькими способами:

• Представляйте новые и актуальные функции
• Получите больше от своего бюджета благодаря улучшенным ставкам, ключевым словам и объявлениям.
• Повысьте общую производительность и эффективность ваших кампаний.

Чтобы повысить показатели оптимизации, вы можете использовать RecommendationService для получения рекомендаций, а затем соответствующим образом применить или отклонить их. Вы также можете подписаться на автоматическое применение рекомендаций, используя RecommendationSubscriptionService .

Показатель оптимизации

ondemand_video Видео: показатель оптимизации

Показатель оптимизации – это оценка того, насколько хорошо настроен ваш аккаунт Google Рекламы и доступен ли он на уровнях Customer и Campaign .

Customer.optimization_score_weight доступен только для аккаунтов, не являющихся управляющими, и используется для расчета общего показателя оптимизации нескольких аккаунтов. Получите показатель оптимизации и вес показателя оптимизации для аккаунтов и умножьте их ( Customer.optimization_score * Customer.optimization_score_weight ), чтобы вычислить общий показатель оптимизации.

Для отчетов customer и campaign доступны метрики, связанные с оптимизацией:

1. metrics.optimization_score_url предоставляет глубокую ссылку на аккаунт для просмотра информации о соответствующих рекомендациях в пользовательском интерфейсе Google Рекламы.
2. Параметр metrics.optimization_score_uplift сообщает, насколько увеличится показатель оптимизации, если будут применены все соответствующие рекомендации. Это оценка, основанная на всех доступных рекомендациях в целом, а не только на сумме оценок повышения для каждой рекомендации.

Чтобы сгруппировать и упорядочить возвращаемые рекомендации, вы можете сегментировать обе эти метрики по типу рекомендаций, используя в своем запросе segments.recommendation_type .

Типы рекомендаций

Получить рекомендации

ondemand_video Видео: живое кодирование

Как и большинство других объектов в API Google Рекламы, объекты Recommendation извлекаются с помощью GoogleAdsService.SearchStream с запросом на языке запросов Google Рекламы.

Для каждого типа рекомендаций подробные сведения предоставляются в специальном поле рекомендации. Например, сведения о рекомендации CAMPAIGN_BUDGET находятся в поле campaign_budget_recommendation и заключены в объект CampaignBudgetRecommendation .

Найдите все поля, относящиеся к рекомендациям, в поле объединения recommendation .

Влияние рекомендаций

Некоторые типы рекомендаций заполняют поле impact рекомендации. RecommendationImpact содержит оценку влияния на эффективность аккаунта в результате применения рекомендации. Следующие метрики рекомендаций доступны в полях impact.base_metrics и impact.potential_metrics :

• impressions

• clicks

• cost_micros

• conversions

• all_conversions (доступно начиная с версии 16 Google Ads API)

• video_views

Пример кода

Следующий пример кода извлекает все доступные и отклоненные рекомендации типа KEYWORD из учетной записи и печатает некоторые их сведения:

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
      

Примите меры

Любую полученную рекомендацию можно применить или отклонить.

В зависимости от типа рекомендаций рекомендации могут меняться ежедневно или даже несколько раз в день. В этом случае resource_name ресурса_объекта рекомендации может устареть после получения рекомендации.

Хорошей практикой является принятие мер по рекомендациям вскоре после их получения.

Применить рекомендации

ondemand_video Видео: применение рекомендаций

Вы можете применить активные или отклоненные рекомендации с помощью метода ApplyRecommendation службы RecommendationService .

Типы рекомендаций могут иметь обязательные или необязательные параметры. Большинство рекомендаций содержат рекомендуемые значения, которые используются по умолчанию.

Настройка аккаунтов для автоматического применения рекомендаций поддерживается не для всех типов рекомендаций. Однако вы можете реализовать аналогичное поведение для типов рекомендаций, которые полностью поддерживаются API Google Рекламы. Чтобы узнать больше, обратитесь к примеру кода DetectAndApplyRecommendations .

Используйте поле объединения apply_parameters метода ApplyRecommendationOperation чтобы применить рекомендации с определенными значениями параметров. Каждый подходящий тип рекомендаций имеет свое поле. Любой тип рекомендаций, не указанный в поле apply_parameters не использует эти значения параметров.

Пример кода

В следующем коде показано, как создать ApplyRecommendationOperation и как переопределить рекомендуемые значения, если вы хотите заменить их своими собственными.

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

В следующем примере вызывается ApplyRecommendation , отправляя операции применения рекомендаций, созданные в предыдущем коде.

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

Отклонить рекомендации

ondemand_video Видео: отклонение рекомендаций

Вы можете отклонить рекомендации с помощью RecommendationService . Структура кода аналогична применению рекомендаций , но вместо этого используются DismissRecommendationOperation RecommendationService.DismissRecommendation .

Автоматически применять рекомендации

Вы можете использовать RecommendationSubscriptionService для автоматического применения рекомендаций определенного типа.

Чтобы подписаться на определенный тип рекомендаций, создайте объект RecommendationSubscription , установите в поле type один из поддерживаемых типов рекомендаций и установите для поля status ENABLED .

Получить подписки

Чтобы получить информацию о подписках на рекомендации учетной записи, запросите ресурс recommendation_subscription .

Чтобы просмотреть изменения, которые были применены автоматически, запросите change_event , отфильтровав для change_client_type значение GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION .

Рекомендации по построению кампании

Начиная с версии 16 API Google Рекламы, вы можете использовать RecommendationService.GenerateRecommendationsRequest для создания рекомендаций во время создания кампании для заданного набора типов рекомендаций.

GenerateRecommendations принимает в качестве входных данных идентификатор клиента, тип рекламного канала, который должен быть SEARCH или PERFORMANCE_MAX , список типов рекомендаций для создания и различные точки данных, зависящие от указанных типов. Он выводит список объектов Recommendation на основе предоставленных вами данных. Если данных недостаточно для создания рекомендации для запрошенных recommendation_types или если кампания уже находится в рекомендованном состоянии, набор результатов не будет содержать рекомендации для этого типа. Убедитесь, что ваше приложение обрабатывает случай, когда рекомендации для запрошенных типов рекомендаций не возвращаются.

В следующей таблице описаны типы рекомендаций, которые поддерживает GenerateRecommendations , а также поля, которые необходимо указать для получения рекомендаций для этого типа. Рекомендуется отправлять запрос GenerateRecommendations после сбора всей информации, связанной с запрошенными типами рекомендаций. Дополнительные сведения об обязательных и необязательных полях, включая вложенные поля, см. в справочной документации .

Пример потока использования

Предположим, ваша компания — рекламное агентство, которое предоставляет пользователям рабочий процесс создания кампании, и вы хотите предлагать пользователям предложения в ходе этого процесса. Вы можете использовать GenerateRecommendationsRequest для генерации рекомендаций по требованию и включать эти рекомендации в пользовательский интерфейс построения кампании.

Схема использования может выглядеть следующим образом:

1. Пользователь заходит в ваше приложение, чтобы создать кампанию с максимальной эффективностью.

2. Пользователь предоставляет некоторую исходную информацию в рамках процесса построения кампании. Например, они предоставляют подробную информацию для создания одного SitelinkAsset и выбирают TARGET_SPEND в качестве стратегии интеллектуального назначения ставок .

3. Вы отправляете GenerateRecommendationsRequest , который устанавливает следующие поля:

   • campaign_sitelink_count : установлено значение 1 , которое представляет собой количество ресурсов дополнительных ссылок в незавершенной кампании.

   • bidding_info : установите для вложенного поля bidding_strategy_type значение TARGET_SPEND .

   • conversion_tracking_status : установлено значение ConversionTrackingStatus этого клиента. Инструкции о том, как получить это поле, см. в руководстве по началу работы с управлением конверсиями.

   • recommendation_types : установлено значение [SITELINK_ASSET, MAXIMIZE_CLICKS_OPT_IN] .

   • advertising_channel_type : установлено значение PERFORMANCE_MAX .

   • customer_id : установлен идентификатор клиента, создавшего кампанию.

4. Вы можете взять рекомендации в GenerateRecommendationsResponse — в данном случае SitelinkAssetRecommendation и MaximizeClicksOptInRecommendation — и предложить их пользователю, отобразив их в интерфейсе создания кампании. Если пользователь принимает предложение, вы можете включить его в запрос на создание кампании, как только пользователь завершит процесс создания кампании.