Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

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

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

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

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

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

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

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

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

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

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

В таблице ниже перечислены типы рекомендаций, которые поддерживаются в Google Ads API для получения, применения и отклонения рекомендаций. Если в аккаунте есть типы рекомендаций, которые поддерживаются в интерфейсе Google Рекламы, но не поддерживаются в API, вы можете использовать metrics.optimization_score_url, чтобы направлять пользователей непосредственно на страницу рекомендаций в интерфейсе Google Рекламы, где они смогут ознакомиться с рекомендациями и применить их.

Полностью поддерживаемые типы рекомендаций

RecommendationType	Описание
`CAMPAIGN_BUDGET`	Исправьте кампании, ограниченные бюджетом
`KEYWORD`	Добавьте новые ключевые слова
`TEXT_AD`	Добавьте варианты объявлений
`TARGET_CPA_OPT_IN`	Назначение ставок с целевой ценой за конверсию
`MAXIMIZE_CONVERSIONS_OPT_IN`	Используйте стратегию "Максимум конверсий"
`MAXIMIZE_CONVERSION_VALUE_OPT_IN`	Назначение ставок с помощью стратегии "Максимальная ценность конверсий"
`ENHANCED_CPC_OPT_IN`	Назначайте ставки с помощью стратегии "Оптимизированная цена за клик"
`MAXIMIZE_CLICKS_OPT_IN`	Назначение ставок с помощью стратегии "Максимум кликов"
`OPTIMIZE_AD_ROTATION`	Используйте оптимизированную ротацию объявлений
`MOVE_UNUSED_BUDGET`	Перенесите неиспользованные средства в ограниченные бюджеты
`TARGET_ROAS_OPT_IN`	Назначайте ставки с помощью стратегии "Целевая рентабельность инвестиций в рекламу"
`FORECASTING_CAMPAIGN_BUDGET`	Исправьте кампании, которые могут быть ограничены бюджетом в будущем
`RESPONSIVE_SEARCH_AD`	Добавить новое адаптивное поисковое объявление
`MARGINAL_ROI_CAMPAIGN_BUDGET`	Скорректируйте бюджет кампании, чтобы повысить рентабельность инвестиций
`USE_BROAD_MATCH_KEYWORD`	Используйте широкое соответствие в кампаниях, ориентированных на конверсии, с автоматическим назначением ставок.
`RESPONSIVE_SEARCH_AD_ASSET`	Как добавить объекты адаптивных поисковых объявлений в объявление
`RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH`	Как повысить качество адаптивного поискового объявления
`DISPLAY_EXPANSION_OPT_IN`	Как включить расширение на КМС в кампании
`SEARCH_PARTNERS_OPT_IN`	Расширьте охват за счет сайтов поисковых партнеров Google
`CUSTOM_AUDIENCE_OPT_IN`	Создать особую аудиторию
`IMPROVE_DEMAND_GEN_AD_STRENGTH`	Как повысить качество объявлений в кампаниях для создания спроса
`UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX`	Как преобразовать умную торговую кампанию в кампанию с максимальной эффективностью
`UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX`	Как преобразовать устаревшую локальную кампанию в кампанию с максимальной эффективностью
`SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX`	Перенесите предложения, на которые настроен таргетинг в обычных торговых кампаниях, в существующие кампании с максимальной эффективностью.
`MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX`	Как перенести динамические поисковые объявления в кампании с максимальной эффективностью
`PERFORMANCE_MAX_OPT_IN`	Создайте кампании с максимальной эффективностью в своем аккаунте
`IMPROVE_PERFORMANCE_MAX_AD_STRENGTH`	Улучшите качество группы объектов в кампании с максимальной эффективностью до отличного.
`PERFORMANCE_MAX_FINAL_URL_OPT_IN`	Включите дополнение конечного URL в кампаниях с максимальной эффективностью
`RAISE_TARGET_CPA_BID_TOO_LOW`	Повысьте целевую цену за конверсию, если она слишком низкая и конверсий мало или нет совсем.
`FORECASTING_SET_TARGET_ROAS`	Заранее увеличьте бюджет перед сезонным событием, которое должно привести к росту трафика, и измените стратегию назначения ставок с "Максимальная ценность конверсий" на "Целевая рентабельность инвестиций в рекламу".
`LEAD_FORM_ASSET`	Как добавить в кампанию объекты лид-форм
`CALLOUT_ASSET`	Добавьте объекты уточнений на уровне кампании или клиента
`SITELINK_ASSET`	Добавьте объекты дополнительных ссылок на уровне кампании или клиента
`CALL_ASSET`	Добавьте объекты звонков на уровне кампании или клиента
`SHOPPING_ADD_AGE_GROUP`	Добавьте атрибут "возрастная группа" для товаров, рейтинг которых был понижен из-за отсутствия этого атрибута.
`SHOPPING_ADD_COLOR`	Добавьте цвет для товаров, которые понижены в рейтинге из-за отсутствия цвета.
`SHOPPING_ADD_GENDER`	Добавьте значение атрибута "пол" для товаров, которые понижены в рейтинге из-за отсутствия этого атрибута.
`SHOPPING_ADD_GTIN`	Добавьте код GTIN для товаров, рейтинг которых был понижен из-за его отсутствия.
`SHOPPING_ADD_MORE_IDENTIFIERS`	Добавьте больше идентификаторов для предложений, которые были понижены в рейтинге из-за отсутствия идентификаторов.
`SHOPPING_ADD_SIZE`	Добавьте размер в предложения, которые были понижены в рейтинге из-за отсутствия размера.
`SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN`	Добавьте товары, чтобы кампания могла показываться
`SHOPPING_FIX_DISAPPROVED_PRODUCTS`	Исправьте отклоненные товары
`SHOPPING_TARGET_ALL_OFFERS`	Создайте универсальную кампанию с таргетингом на все предложения
`SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT`	Как устранить проблемы, из-за которых заблокирован аккаунт Merchant Center
`SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING`	Как устранить проблемы, связанные с предупреждением о блокировке аккаунта Merchant Center
`DYNAMIC_IMAGE_EXTENSION_OPT_IN`	Включите динамические изображения в аккаунте
`RAISE_TARGET_CPA`	Повысьте целевую цену за конверсию
`LOWER_TARGET_ROAS`	Снизить целевую рентабельность инвестиций в рекламу
`FORECASTING_SET_TARGET_CPA`	Задайте целевую цену за конверсию для кампаний, в которых она не указана, перед сезонным событием, которое, по прогнозам, увеличит трафик.
`SET_TARGET_CPA`	Задайте целевую цену за конверсию для кампаний, в которых она не указана.
`SET_TARGET_ROAS`	Задайте целевую рентабельность инвестиций в рекламу для кампаний, в которых она не указана
`REFRESH_CUSTOMER_MATCH_LIST`	Обновите список клиентов, который не обновлялся в течение последних 90 дней.
`IMPROVE_GOOGLE_TAG_COVERAGE`	Добавьте тег Google на большее количество страниц
`CAMPAIGN_SPECIFIC_APP_GOAL`	Как добавить цель конверсии в приложении на уровне кампании
`RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW`	Повысьте целевую цену за конверсию, если она слишком низкая для поисковых кампаний
`LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW`	Снизьте целевую рентабельность инвестиций в рекламу, если она слишком низкая для поисковых кампаний
`RAISE_BUDGET_PERFORMANCE_TOO_LOW`	Увеличьте бюджет, если он слишком мал для поисковых кампаний. Доступно начиная с v26. Сведения о рекомендациях возвращаются в `Recommendation.raise_budget_performance_too_low_recommendation` и применяются с помощью `ApplyRecommendationOperation.raise_budget_performance_too_low`.
`OPTIMIZE_FOR_NEW_CUSTOMERS`	Задайте дополнительную ценность конверсий для новых клиентов, чтобы оптимизировать кампании для привлечения новых клиентов. Доступно в версии v26.1 и более поздних. Сведения о рекомендациях возвращаются в `Recommendation.optimize_for_new_customers_recommendation` и применяются с помощью `ApplyRecommendationOperation.optimize_for_new_customers`.
`KEYWORD_MATCH_TYPE` (поддержка прекращена)	Устарело, используйте `USE_BROAD_MATCH_KEYWORD`

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

Как и большинство других объектов в Google Ads API, объекты 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
video_views

Даже если поле impact заполнено, доступность показателей зависит от типа рекомендации, типа кампании и других факторов. В целом, проверяйте доступность каждого показателя влияния, прежде чем пытаться его использовать.

Пример кода

Приведенный ниже образец кода позволяет получить все доступные и отклоненные рекомендации типа KEYWORD из аккаунта и выводит некоторые сведения о них.

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.V26.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: str = """
    SELECT
      recommendation.campaign,
      recommendation.keyword_recommendation
    FROM recommendation
    WHERE
      recommendation.type = KEYWORD"""

# Detects keyword recommendations that exist for the customer account.
response: Iterable[GoogleAdsRow] = googleads_service.search(
    customer_id=customer_id, query=query
)

operations: List[ApplyRecommendationOperation] = []
for row in response:
    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)
enddetect_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

curl

# Gets keyword recommendations.
#
# Variables:
#   API_VERSION,
#   CUSTOMER_ID,
#   MANAGER_CUSTOMER_ID,
#   OAUTH2_ACCESS_TOKEN:
#     See https://developers.google.com/google-ads/api/rest/auth#request_headers
#     for details.
curl -f --request POST \
"https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:search" \
--header "Content-Type: application/json" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data @- <<EOF
{
"query": "
  SELECT
    recommendation.campaign,
    recommendation.keyword_recommendation
  FROM recommendation
  WHERE
    recommendation.type = KEYWORD
"
}
EOFdetect_and_apply_recommendations.sh

Принять меры

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

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

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

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

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

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

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

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

Пример кода

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

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: GoogleAdsClient, recommendation: str
) -> ApplyRecommendationOperation:
    """Creates a ApplyRecommendationOperation to apply the given recommendation.

    Args:
        client: an initialized GoogleAdsClient instance.
        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: ApplyRecommendationOperation = 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 operationdetect_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
enddetect_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::V26::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::V26::Resources::Ad->new({
  #   id => "INSERT_AD_ID_AS_INTEGER_HERE"
  # });
  # my $text_ad_parameters =
  #   Google::Ads::GoogleAds::V26::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::V26::Services::RecommendationService::ApplyRecommendationOperation
    ->new({
      resourceName => $recommendation->{resourceName}});

  return $apply_recommendation_operation;
}detect_and_apply_recommendations.pl

curl

Примечание. Хотя здесь не приводится пример кода REST для этого шага, вы можете выполнить его с помощью запроса REST вручную.

Ознакомьтесь с документацией по REST-интерфейсу Google Ads API и справочными страницами по методам. Вам нужно будет создать полезную нагрузку JSON на основе определений proto.

Полезные ресурсы:

Использование REST
Структура интерфейса REST
Сопоставление полей JSON
Ознакомьтесь с документацией по REST API для конкретного сервиса и метода.

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

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.V26.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: GoogleAdsClient,
    customer_id: str,
    operations: List[ApplyRecommendationOperation],
) -> None:
    """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: ApplyRecommendationResult = (
        recommendation_service.apply_recommendation(
            customer_id=customer_id, operations=operations
        )
    )

    for result in response.results:
        print(
            "Applied a recommendation with resource name: "
            f"'{result.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
enddetect_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

curl

# Applies a recommendation.
#
# Variables:
#   API_VERSION,
#   CUSTOMER_ID,
#   MANAGER_CUSTOMER_ID,
#   OAUTH2_ACCESS_TOKEN:
#     See https://developers.google.com/google-ads/api/rest/auth#request_headers
#     for details.
#
#   RECOMMENDATION_RESOURCE_NAME: The resource name of the recommendation to
#     apply, from the previous request.
curl -f --request POST \
"https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/recommendations:apply" \
--header "Content-Type: application/json" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data @- <<EOF
{
  "operations": [
    {
      "resourceName": "${RECOMMENDATION_RESOURCE_NAME}"
    }
  ]
}
EOFdetect_and_apply_recommendations.sh

Как отказаться от рекомендации

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

Массовые операции и обработка ошибок

Оба метода (ApplyRecommendation и DismissRecommendation) принимают до 100 операций на запрос. При отправке нескольких операций в одном запросе учитывайте следующее:

Смешивание типов рекомендаций. По умолчанию (partial_failure = false) все операции в одном запросе должны быть направлены на один и тот же тип рекомендаций. В противном случае API возвращает ошибку RecommendationError.DIFFERENT_TYPES_NOT_SUPPORTED. Чтобы применить или отклонить рекомендации разных типов в одном запросе, задайте для параметра partial_failure значение true, чтобы допустимые операции выполнялись независимо.
Ошибки жизненного цикла. Поскольку рекомендации оцениваются динамически, их статус может измениться между получением и действием. Если рекомендация уже применена, отклонена или больше не применима, API возвращает RECOMMENDATION_ALREADY_APPLIED, RECOMMENDATION_ALREADY_DISMISSED или RECOMMENDATION_INVALIDATED в RecommendationError.

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

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

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

Типы рекомендаций, поддерживаемые подпиской

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
SET_TARGET_CPA
SET_TARGET_ROAS
TARGET_CPA_OPT_IN
TARGET_ROAS_OPT_IN
USE_BROAD_MATCH_KEYWORD

Получение подписок

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

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

RecommendationType	Обязательные поля	Необязательные поля
`CAMPAIGN_BUDGET`	Для кампаний в поисковой сети и кампаний с максимальной эффективностью обязательны следующие поля: `asset_group_info` `final_url` `bidding_strategy_type` Только для поисковых кампаний также обязательны следующие поля: `country_code` `language_code` `positive_location_id` или `negative_location_id` `ad_group_info.keywords` `bidding_info. bidding_strategy_target_info. target_impression_share_info` если для стратегии назначения ставок задано значение `TARGET_IMPRESSION_SHARE`	`budget_info` Для кампаний с максимальной эффективностью укажите значение в поле `merchant_center_account_id`, чтобы `RecommendationsService` создавал рекомендации для розничных, а не стандартных кампаний с максимальной эффективностью.
`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` Примечание. Возвращенный объект `SitelinkAssetRecommendation` будет содержать пустые списки. Если ответ `GenerateRecommendations` содержит `SitelinkAssetRecommendation`, это можно рассматривать как сигнал о том, что в кампанию нужно добавить хотя бы один объект дополнительной ссылки.	`campaign_sitelink_count`
`TARGET_CPA_OPT_IN`	`conversion_tracking_status` `bidding_info`
`TARGET_ROAS_OPT_IN`	`conversion_tracking_status` `bidding_info`

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

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

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

Полностью поддерживаемые типы рекомендаций

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

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

Пример кода

Java

C#

PHP

Python

Ruby

Perl

curl

Принять меры

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

Пример кода

Java

C#

PHP

Python

Ruby

Perl

curl

Java

C#

PHP

Python

Ruby

Perl

curl

Как отказаться от рекомендации

Массовые операции и обработка ошибок

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

Типы рекомендаций, поддерживаемые подпиской

Получение подписок

Рекомендации во время создания кампании

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

Показатель оптимизации и рекомендации Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

Полностью поддерживаемые типы рекомендаций

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

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

Пример кода

Java

C#

PHP

Python

Ruby

Perl

curl

Принять меры

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

Пример кода

Java

C#

PHP

Python

Ruby

Perl

curl

Java

C#

PHP

Python

Ruby

Perl

curl

Как отказаться от рекомендации

Массовые операции и обработка ошибок

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

Типы рекомендаций, поддерживаемые подпиской

Получение подписок

Рекомендации во время создания кампании

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

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