Чтобы переводить контент на ваш предпочитаемый язык, 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`.
`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.V25.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::V25::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::V25::Resources::Ad->new({
  #   id => "INSERT_AD_ID_AS_INTEGER_HERE"
  # });
  # my $text_ad_parameters =
  #   Google::Ads::GoogleAds::V25::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::V25::Services::RecommendationService::ApplyRecommendationOperation
    ->new({
      resourceName => $recommendation->{resourceName}});

  return $apply_recommendation_operation;
}detect_and_apply_recommendations.pl

curl

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

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

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

Использование 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.V25.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,
#   DEVELOPER_TOKEN,
#   MANAGER_CUSTOMER_ID,
#   OAUTH2_ACCESS_TOKEN:
#     See https://developers.google.com/google-ads/api/rest/auth#request_headers
#     for details.
#
#   RECOMMENDATION_RESOURCE_NAME: The resource name of the recommendation to
#     apply, from the previous request.
curl -f --request POST \
"https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/recommendations:apply" \
--header "Content-Type: application/json" \
--header "developer-token: ${DEVELOPER_TOKEN}" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data @- <<EOF
{
  "operations": [
    {
      "resourceName": "${RECOMMENDATION_RESOURCE_NAME}"
    }
  ]
}
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

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

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

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

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

Как получить информацию о подписках

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

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

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