Recommendation

Рекомендация.

JSON-представление 
{
  "resourceName": string,
  "type": enum (RecommendationType),
  "impact": {
    object (RecommendationImpact)
  },
  "campaigns": [
    string
  ],
  "campaignBudget": string,
  "campaign": string,
  "adGroup": string,
  "dismissed": boolean,

  // Union field recommendation can be only one of the following:
  "campaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "forecastingCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "keywordRecommendation": {
    object (KeywordRecommendation)
  },
  "textAdRecommendation": {
    object (TextAdRecommendation)
  },
  "targetCpaOptInRecommendation": {
    object (TargetCpaOptInRecommendation)
  },
  "maximizeConversionsOptInRecommendation": {
    object (MaximizeConversionsOptInRecommendation)
  },
  "enhancedCpcOptInRecommendation": {
    object (EnhancedCpcOptInRecommendation)
  },
  "searchPartnersOptInRecommendation": {
    object (SearchPartnersOptInRecommendation)
  },
  "maximizeClicksOptInRecommendation": {
    object (MaximizeClicksOptInRecommendation)
  },
  "optimizeAdRotationRecommendation": {
    object (OptimizeAdRotationRecommendation)
  },
  "keywordMatchTypeRecommendation": {
    object (KeywordMatchTypeRecommendation)
  },
  "moveUnusedBudgetRecommendation": {
    object (MoveUnusedBudgetRecommendation)
  },
  "targetRoasOptInRecommendation": {
    object (TargetRoasOptInRecommendation)
  },
  "responsiveSearchAdRecommendation": {
    object (ResponsiveSearchAdRecommendation)
  },
  "marginalRoiCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "useBroadMatchKeywordRecommendation": {
    object (UseBroadMatchKeywordRecommendation)
  },
  "responsiveSearchAdAssetRecommendation": {
    object (ResponsiveSearchAdAssetRecommendation)
  },
  "upgradeSmartShoppingCampaignToPerformanceMaxRecommendation": {
    object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)
  },
  "responsiveSearchAdImproveAdStrengthRecommendation": {
    object (ResponsiveSearchAdImproveAdStrengthRecommendation)
  },
  "displayExpansionOptInRecommendation": {
    object (DisplayExpansionOptInRecommendation)
  },
  "upgradeLocalCampaignToPerformanceMaxRecommendation": {
    object (UpgradeLocalCampaignToPerformanceMaxRecommendation)
  },
  "raiseTargetCpaBidTooLowRecommendation": {
    object (RaiseTargetCpaBidTooLowRecommendation)
  },
  "forecastingSetTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  },
  "calloutAssetRecommendation": {
    object (CalloutAssetRecommendation)
  },
  "sitelinkAssetRecommendation": {
    object (SitelinkAssetRecommendation)
  },
  "callAssetRecommendation": {
    object (CallAssetRecommendation)
  },
  "shoppingAddAgeGroupRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddColorRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGenderRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGtinRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddMoreIdentifiersRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddSizeRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddProductsToCampaignRecommendation": {
    object (ShoppingAddProductsToCampaignRecommendation)
  },
  "shoppingFixDisapprovedProductsRecommendation": {
    object (ShoppingFixDisapprovedProductsRecommendation)
  },
  "shoppingTargetAllOffersRecommendation": {
    object (ShoppingTargetAllOffersRecommendation)
  },
  "shoppingFixSuspendedMerchantCenterAccountRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingFixMerchantCenterAccountSuspensionWarningRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation": {
    object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)
  },
  "dynamicImageExtensionOptInRecommendation": {
    object (DynamicImageExtensionOptInRecommendation)
  },
  "raiseTargetCpaRecommendation": {
    object (RaiseTargetCpaRecommendation)
  },
  "lowerTargetRoasRecommendation": {
    object (LowerTargetRoasRecommendation)
  },
  "performanceMaxOptInRecommendation": {
    object (PerformanceMaxOptInRecommendation)
  },
  "improvePerformanceMaxAdStrengthRecommendation": {
    object (ImprovePerformanceMaxAdStrengthRecommendation)
  },
  "migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation": {
    object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)
  },
  "forecastingSetTargetCpaRecommendation": {
    object (ForecastingSetTargetCpaRecommendation)
  },
  "setTargetCpaRecommendation": {
    object (ForecastingSetTargetCpaRecommendation)
  },
  "setTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  },
  "maximizeConversionValueOptInRecommendation": {
    object (MaximizeConversionValueOptInRecommendation)
  },
  "improveGoogleTagCoverageRecommendation": {
    object (ImproveGoogleTagCoverageRecommendation)
  },
  "performanceMaxFinalUrlOptInRecommendation": {
    object (PerformanceMaxFinalUrlOptInRecommendation)
  },
  "refreshCustomerMatchListRecommendation": {
    object (RefreshCustomerMatchListRecommendation)
  },
  "customAudienceOptInRecommendation": {
    object (CustomAudienceOptInRecommendation)
  },
  "leadFormAssetRecommendation": {
    object (LeadFormAssetRecommendation)
  },
  "improveDemandGenAdStrengthRecommendation": {
    object (ImproveDemandGenAdStrengthRecommendation)
  }
  // End of list of possible types for union field recommendation.
}
Поля
resourceName

string

Неизменяемый. Имя ресурса рекомендации.

customers/{customerId}/recommendations/{recommendation_id}

type

enum ( RecommendationType )

Только вывод. Тип рекомендации.

impact

object ( RecommendationImpact )

Только вывод. Влияние на эффективность аккаунта в результате применения рекомендации.

campaigns[]

string

Только вывод. Кампании, на которые распространяется эта рекомендация.

Это поле будет установлено для следующих типов рекомендаций: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET и MOVE_UNUSED_BUDGET.

campaignBudget

string

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

Это поле будет установлено для следующих типов рекомендаций: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET.

campaign

string

Только вывод. Кампания, на которую распространяется эта рекомендация.

Это поле будет установлено для следующих типов рекомендаций: CALL_EXTENSION, CALLOUT_EXTENSION, ENHANCED_CPC_OPT_IN, USE_BROAD_MATCH_KEYWORD, KEYWORD, KEYWORD_MATCH_TYPE, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, SEARCH_PARTNERS_OPT_IN, DISPLAY_EXPANSION_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX, RAISE_TARGET_CPA_BID_TOO_LOW, FORECASTING_SET_TARGET_ROAS, SHOPPING_ADD_AGE_GROUP, SHOPPING_ADD_COLOR, SHOPPING_ADD_GENDER, SHOPPING_ADD_SIZE, SHOPPING_ADD_GTIN, SHOPPING_ADD_MORE_IDENTIFIERS, SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN, SHOPPING_FIX_DISAPPROVED_PRODUCTS, SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX, DYNAMIC_IMAGE_EXTENSION_OPT_IN, RAISE_TARGET_CPA, LOWER_TARGET_ROAS, FORECASTING_SET_TARGET_CPA, SET_TARGET_CPA, SET_TARGET_ROAS, MAXIMIZE_CONVERSION_VALUE_OPT_IN, IMPROVE_GOOGLE_TAG_COVERAGE, PERFORMANCE_MAX_FINAL_URL_OPT_IN

adGroup

string

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

Это поле будет установлено для следующих типов рекомендаций: KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD.

dismissed

boolean

Только вывод. Будет ли рекомендация отклонена или нет.

recommendation по полю Союза. Подробности рекомендации. recommendation может быть только одной из следующих:
campaignBudgetRecommendation

object ( CampaignBudgetRecommendation )

Только вывод. Рекомендации по бюджету кампании.

forecastingCampaignBudgetRecommendation

object ( CampaignBudgetRecommendation )

Только вывод. Рекомендация по прогнозированию бюджета кампании.

keywordRecommendation

object ( KeywordRecommendation )

Только вывод. Рекомендация по ключевому слову.

textAdRecommendation

object ( TextAdRecommendation )

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

targetCpaOptInRecommendation

object ( TargetCpaOptInRecommendation )

Только вывод. Рекомендация по подписке TargetCPA.

maximizeConversionsOptInRecommendation

object ( MaximizeConversionsOptInRecommendation )

Только вывод. Рекомендация о согласии на MaximizeConversions.

enhancedCpcOptInRecommendation

object ( EnhancedCpcOptInRecommendation )

Только вывод. Рекомендация по расширенной цене за клик.

searchPartnersOptInRecommendation

object ( SearchPartnersOptInRecommendation )

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

maximizeClicksOptInRecommendation

object ( MaximizeClicksOptInRecommendation )

Только вывод. Рекомендация MaximizeClicks по согласию.

optimizeAdRotationRecommendation

object ( OptimizeAdRotationRecommendation )

Только вывод. Рекомендация по оптимизации ротации объявлений.

keywordMatchTypeRecommendation

object ( KeywordMatchTypeRecommendation )

Только вывод. Рекомендации по типу соответствия ключевого слова.

moveUnusedBudgetRecommendation

object ( MoveUnusedBudgetRecommendation )

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

targetRoasOptInRecommendation

object ( TargetRoasOptInRecommendation )

Только вывод. Рекомендация о включении целевой рентабельности инвестиций в рекламу.

responsiveSearchAdRecommendation

object ( ResponsiveSearchAdRecommendation )

Только вывод. Рекомендация по добавлению адаптивного поискового объявления.

marginalRoiCampaignBudgetRecommendation

object ( CampaignBudgetRecommendation )

Только вывод. Рекомендуемый бюджет кампании с предельной рентабельностью инвестиций.

useBroadMatchKeywordRecommendation

object ( UseBroadMatchKeywordRecommendation )

Только вывод. Рекомендуется использовать ключевые слова с широким соответствием.

responsiveSearchAdAssetRecommendation

object ( ResponsiveSearchAdAssetRecommendation )

Только вывод. Рекомендация по объектам адаптивных поисковых объявлений.

upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object ( UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation )

Только вывод. Превратите умную торговую кампанию в рекомендацию кампании с максимальной эффективностью.

responsiveSearchAdImproveAdStrengthRecommendation

object ( ResponsiveSearchAdImproveAdStrengthRecommendation )

Только вывод. Адаптивное поисковое объявление повышает рекомендацию по качеству объявления.

displayExpansionOptInRecommendation

object ( DisplayExpansionOptInRecommendation )

Только вывод. Рекомендация по включению расширения дисплея.

upgradeLocalCampaignToPerformanceMaxRecommendation

object ( UpgradeLocalCampaignToPerformanceMaxRecommendation )

Только вывод. Рекомендовать повысить локальную кампанию до кампании с максимальной эффективностью.

raiseTargetCpaBidTooLowRecommendation

object ( RaiseTargetCpaBidTooLowRecommendation )

Только вывод. Рекомендация по повышению целевой цены за конверсию слишком низкая.

forecastingSetTargetRoasRecommendation

object ( ForecastingSetTargetRoasRecommendation )

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

calloutAssetRecommendation

object ( CalloutAssetRecommendation )

Только вывод. Рекомендация по объекту уточнения.

callAssetRecommendation

object ( CallAssetRecommendation )

Только вывод. Рекомендация по активу колл.

shoppingAddAgeGroupRecommendation

object ( ShoppingOfferAttributeRecommendation )

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

shoppingAddColorRecommendation

object ( ShoppingOfferAttributeRecommendation )

Только вывод. Покупки добавляют рекомендации по цвету.

shoppingAddGenderRecommendation

object ( ShoppingOfferAttributeRecommendation )

Только вывод. К покупкам добавляются гендерные рекомендации.

shoppingAddGtinRecommendation

object ( ShoppingOfferAttributeRecommendation )

Только вывод. Покупки добавляют рекомендацию GTIN.

shoppingAddMoreIdentifiersRecommendation

object ( ShoppingOfferAttributeRecommendation )

Только вывод. При покупке рекомендуется добавить больше идентификаторов.

shoppingAddSizeRecommendation

object ( ShoppingOfferAttributeRecommendation )

Только вывод. Покупки добавляют рекомендации по размеру.

shoppingAddProductsToCampaignRecommendation

object ( ShoppingAddProductsToCampaignRecommendation )

Только вывод. Покупки добавляют продукты в рекомендации кампании.

shoppingFixDisapprovedProductsRecommendation

object ( ShoppingFixDisapprovedProductsRecommendation )

Только вывод. Исправление покупок: рекомендация продуктов отклонена.

shoppingTargetAllOffersRecommendation

object ( ShoppingTargetAllOffersRecommendation )

Только вывод. Цель покупок все предлагает рекомендации.

shoppingFixSuspendedMerchantCenterAccountRecommendation

object ( ShoppingMerchantCenterAccountSuspensionRecommendation )

Только вывод. Исправление покупок приостановило рекомендацию аккаунта Merchant Center.

shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object ( ShoppingMerchantCenterAccountSuspensionRecommendation )

Только вывод. Исправление ошибок в покупках. Рекомендации по блокировке аккаунта Merchant Center.

shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object ( ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation )

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

dynamicImageExtensionOptInRecommendation

object ( DynamicImageExtensionOptInRecommendation )

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

raiseTargetCpaRecommendation

object ( RaiseTargetCpaRecommendation )

Только вывод. Рекомендация повысить целевую цену за конверсию.

lowerTargetRoasRecommendation

object ( LowerTargetRoasRecommendation )

Только вывод. Рекомендация снизить целевую рентабельность инвестиций в рекламу.

performanceMaxOptInRecommendation

object ( PerformanceMaxOptInRecommendation )

Только вывод. Рекомендация о подписке с максимальной эффективностью.

improvePerformanceMaxAdStrengthRecommendation

object ( ImprovePerformanceMaxAdStrengthRecommendation )

Только вывод. Рекомендации по повышению эффективности объявлений с максимальной эффективностью.

migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object ( MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation )

Только вывод. Рекомендация по переходу с динамических поисковых объявлений на кампании с максимальной эффективностью.

forecastingSetTargetCpaRecommendation

object ( ForecastingSetTargetCpaRecommendation )

Только вывод. Прогнозирование установило рекомендацию по целевой цене за конверсию.

setTargetCpaRecommendation

object ( ForecastingSetTargetCpaRecommendation )

Только вывод. Рекомендуемая целевая цена за конверсию.

setTargetRoasRecommendation

object ( ForecastingSetTargetRoasRecommendation )

Только вывод. Установленная целевая рекомендация по рентабельности инвестиций в рекламу.

maximizeConversionValueOptInRecommendation

object ( MaximizeConversionValueOptInRecommendation )

Только вывод. Рекомендация по включению максимальной ценности конверсии.

improveGoogleTagCoverageRecommendation

object ( ImproveGoogleTagCoverageRecommendation )

Только вывод. Рекомендация разместить тег Google на большем количестве страниц.

performanceMaxFinalUrlOptInRecommendation

object ( PerformanceMaxFinalUrlOptInRecommendation )

Только вывод. Рекомендуется включить расширение конечного URL для кампаний с максимальной эффективностью.

refreshCustomerMatchListRecommendation

object ( RefreshCustomerMatchListRecommendation )

Только вывод. Рекомендация по обновлению списка клиентов.

customAudienceOptInRecommendation

object ( CustomAudienceOptInRecommendation )

Только вывод. Пользовательская аудитория соглашается на рекомендацию.

leadFormAssetRecommendation

object ( LeadFormAssetRecommendation )

Только вывод. Лид формирует рекомендации по активам.

improveDemandGenAdStrengthRecommendation

object ( ImproveDemandGenAdStrengthRecommendation )

Только вывод. Рекомендация по улучшению качества рекламы для формирования спроса.

РекомендацияВоздействие

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

JSON-представление 
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
Поля
baseMetrics

object ( RecommendationMetrics )

Только вывод. Базовые показатели на момент создания рекомендации.

potentialMetrics

object ( RecommendationMetrics )

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

РекомендацияМетрики

Еженедельные показатели эффективности аккаунта. Для некоторых типов рекомендаций они усреднены за последний 90-дневный период и, следовательно, могут быть дробными.

JSON-представление 
{
  "impressions": number,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionsValue": number,
  "videoViews": number
}
Поля
impressions

number

Только вывод. Количество показов рекламы.

clicks

number

Только вывод. Количество кликов по объявлению.

costMicros

string ( int64 format)

Только вывод. Стоимость (в микронах) за рекламу, в местной валюте для аккаунта.

conversions

number

Только вывод. Количество конверсий.

conversionsValue

number

Только вывод. Сумма ценности конверсий.

videoViews

number

Только вывод. Количество просмотров видео для видеорекламной кампании.

Рекомендации по бюджету кампании

Рекомендации по бюджету для кампаний с ограниченным бюджетом.

JSON-представление 
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
Поля
budgetOptions[]

object ( CampaignBudgetRecommendationOption )

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

currentBudgetAmountMicros

string ( int64 format)

Только вывод. Текущая сумма бюджета в микронах.

recommendedBudgetAmountMicros

string ( int64 format)

Только вывод. Рекомендуемая сумма бюджета в микронах.

Вариант рекомендации бюджета кампании

Оценка воздействия на данную сумму бюджета.

JSON-представление 
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
Поля
impact

object ( RecommendationImpact )

Только вывод. Оценка воздействия, если бюджет будет изменен на сумму, указанную в этой опции.

budgetAmountMicros

string ( int64 format)

Только вывод. Сумма бюджета для этого варианта.

Ключевое словоРекомендация

Рекомендация по ключевому слову.

JSON-представление 
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
Поля
keyword

object ( KeywordInfo )

Только вывод. Рекомендуемое ключевое слово.

searchTerms[]

object ( SearchTerm )

Только вывод. Список поисковых запросов, которым соответствует это ключевое слово. Один и тот же поисковый запрос может повторяться для нескольких ключевых слов.

recommendedCpcBidMicros

string ( int64 format)

Только вывод. Рекомендуемая ставка CPC (цена за клик).

Поисковый термин

Информация о поисковом запросе, связанная с рекомендацией по ключевому слову.

JSON-представление 
{
  "text": string,
  "estimatedWeeklySearchCount": string
}
Поля
text

string

Только вывод. Текст поискового запроса.

estimatedWeeklySearchCount

string ( int64 format)

Только вывод. Приблизительное количество исторических запросов в неделю по этому поисковому запросу.

Рекомендация текстового объявления

Рекомендация по текстовому объявлению.

JSON-представление 
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
Поля
ad

object ( Ad )

Только вывод. Рекомендуемое объявление.

creationDate

string

Только вывод. Дата создания рекомендуемого объявления. Формат ГГГГ-ММ-ДД, например, 17.04.2018.

autoApplyDate

string

Только вывод. Дата, если она присутствует, является самой ранней датой автоматического применения рекомендации. Формат ГГГГ-ММ-ДД, например, 17.04.2018.

TargetCpaOptInРекомендация

Рекомендация по включению целевой цены за конверсию.

JSON-представление 
{
  "options": [
    {
      object (TargetCpaOptInRecommendationOption)
    }
  ],
  "recommendedTargetCpaMicros": string
}
Поля
options[]

object ( TargetCpaOptInRecommendationOption )

Только вывод. Доступные цели и соответствующие варианты стратегии «Целевая цена за конверсию».

recommendedTargetCpaMicros

string ( int64 format)

Только вывод. Рекомендуемая средняя целевая цена за конверсию. См. требуемую сумму бюджета и влияние использования этой рекомендации в списке вариантов.

TargetCpaOptInRecommendationOption

Опция «Целевая цена за конверсию» с оценкой эффекта.

JSON-представление 
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
Поля
goal

enum ( TargetCpaOptInRecommendationGoal )

Только вывод. Цель достигается этим вариантом.

impact

object ( RecommendationImpact )

Только вывод. Оценка воздействия, если выбран этот параметр.

targetCpaMicros

string ( int64 format)

Только вывод. Целевая средняя цена за конверсию.

requiredCampaignBudgetAmountMicros

string ( int64 format)

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

TargetCpaOptInRecommendationGoal

Цель рекомендации TargetCpaOptIn.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
SAME_COST Рекомендуется установить целевую цену за конверсию, чтобы сохранить прежнюю стоимость.
SAME_CONVERSIONS Рекомендуется установить целевую цену за конверсию, чтобы поддерживать прежний уровень конверсий.
SAME_CPA Рекомендуется установить целевую цену за конверсию, чтобы поддерживать ту же цену за конверсию.
CLOSEST_CPA Рекомендуется установить целевую цену за конверсию на значение, максимально близкое к фактической цене за конверсию (рассчитанное за последние 28 дней), но при этом ниже нее.

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

Рекомендация «Максимальное количество конверсий».

JSON-представление 
{
  "recommendedBudgetAmountMicros": string
}
Поля
recommendedBudgetAmountMicros

string ( int64 format)

Только вывод. Рекомендуемая новая сумма бюджета.

EnhancedCpcOptInRecommendation

Этот тип не имеет полей.

Рекомендация по расширенной цене за клик.

SearchPartnersOptInРекомендация

Этот тип не имеет полей.

Рекомендация о согласии поисковых партнеров.

МаксимизироватьClicksOptInRecommendation

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

JSON-представление 
{
  "recommendedBudgetAmountMicros": string
}
Поля
recommendedBudgetAmountMicros

string ( int64 format)

Только вывод. Рекомендуемая новая сумма бюджета. Устанавливается только в том случае, если текущий бюджет слишком высок.

Рекомендация по оптимизации рекламы

Этот тип не имеет полей.

Рекомендация по оптимизации ротации объявлений.

Ключевое словоMatchTypeРекомендация

Рекомендации по типу соответствия ключевого слова.

JSON-представление 
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
Поля
keyword

object ( KeywordInfo )

Только вывод. Существующее ключевое слово, тип соответствия которого должен быть более широким.

recommendedMatchType

enum ( KeywordMatchType )

Только вывод. Рекомендуемый новый тип соответствия.

Рекомендация MoveUnusedBudget

Рекомендация по переносу неиспользованного бюджета.

JSON-представление 
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
Поля
budgetRecommendation

object ( CampaignBudgetRecommendation )

Только вывод. Рекомендация для ограниченного бюджета по увеличению.

excessCampaignBudget

string

Только вывод. Имя ресурса избыточного бюджета.

ТаргетРоасОптИнРекомендация

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

JSON-представление 
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
Поля
recommendedTargetRoas

number

Только вывод. Рекомендуемая целевая рентабельность инвестиций в рекламу (доход на единицу расходов). Значение находится в диапазоне от 0,01 до 1000,0 включительно.

requiredCampaignBudgetAmountMicros

string ( int64 format)

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

Рекомендации по адаптивному поисковому объявлению

Рекомендация по добавлению адаптивного поискового объявления.

JSON-представление 
{
  "ad": {
    object (Ad)
  }
}
Поля
ad

object ( Ad )

Только вывод. Рекомендуемое объявление.

UseBroadMatchKeywordRecommendation

Рекомендуется использовать ключевые слова с широким соответствием.

JSON-представление 
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
Поля
keyword[]

object ( KeywordInfo )

Только вывод. Пример ключевых слов, которые необходимо расширить до широкого соответствия.

suggestedKeywordsCount

string ( int64 format)

Только вывод. Общее количество ключевых слов, которые будут расширены до широкого соответствия в кампании.

campaignKeywordsCount

string ( int64 format)

Только вывод. Общее количество ключевых слов в кампании.

campaignUsesSharedBudget

boolean

Только вывод. Использует ли связанная кампания общий бюджет.

requiredCampaignBudgetAmountMicros

string ( int64 format)

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

АдаптивныйSearchAdAssetRecommendation

Рекомендация по добавлению объекта адаптивного поискового объявления.

JSON-представление 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
Поля
currentAd

object ( Ad )

Только вывод. Текущее объявление будет обновлено.

recommendedAssets

object ( Ad )

Только вывод. Рекомендуемые активы. Он заполняется только новыми заголовками и/или описаниями и в остальном пуст.

ОбновитьSmartShoppingCampaignToPerformanceMaxRecommendation

Превратите умную торговую кампанию в рекомендацию кампании с максимальной эффективностью.

JSON-представление 
{
  "merchantId": string,
  "salesCountryCode": string
}
Поля
merchantId

string ( int64 format)

Только вывод. Идентификатор аккаунта Merchant Center.

salesCountryCode

string

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

АдаптивноеПоисковоеОбъявлениеУлучшениеОбъявлениеСилаРекомендация

Адаптивное поисковое объявление повышает рекомендацию по качеству объявления.

JSON-представление 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
Поля
currentAd

object ( Ad )

Только вывод. Текущее объявление будет обновлено.

recommendedAd

object ( Ad )

Только вывод. Обновленное объявление.

DisplayExpansionOptInRecommendation

Этот тип не имеет полей.

Рекомендация по включению расширения дисплея.

UpgradeLocalCampaignToPerformanceMaxRecommendation

Этот тип не имеет полей.

Рекомендация: обновить локальную кампанию до кампании с максимальной эффективностью.

RaiseTargetCpaBidTooLowRecommendation

Рекомендация по повышению целевой цены за конверсию слишком низкая.

JSON-представление 
{
  "recommendedTargetMultiplier": number,
  "averageTargetCpaMicros": string
}
Поля
recommendedTargetMultiplier

number

Только вывод. Число больше 1,0 указывает на коэффициент, на который мы рекомендуем увеличить целевую цену за конверсию.

averageTargetCpaMicros

string ( int64 format)

Только вывод. Текущая средняя целевая цена за конверсию кампании в микронах местной валюты клиента.

ПрогнозированиеSetTargetRoasRecommendation

Прогноз установил целевую рекомендацию по рентабельности инвестиций в рекламу.

JSON-представление 
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
Поля
recommendedTargetRoas

number

Только вывод. Рекомендуемая целевая рентабельность инвестиций в рекламу (доход на единицу расходов). Значение находится в диапазоне от 0,01 до 1000,0 включительно.

campaignBudget

object ( CampaignBudget )

Только вывод. Бюджет кампании.

Бюджет кампании

Бюджет кампании, общий для различных типов рекомендаций по бюджету.

JSON-представление 
{
  "currentAmountMicros": string,
  "recommendedNewAmountMicros": string,
  "newStartDate": string
}
Поля
currentAmountMicros

string ( int64 format)

Только вывод. Текущая сумма бюджета.

recommendedNewAmountMicros

string ( int64 format)

Только вывод. Рекомендуемая сумма бюджета.

newStartDate

string

Только вывод. Дата начала использования нового бюджета. Это поле будет установлено для следующих типов рекомендаций: FORECASTING_SET_TARGET_ROAS , FORECASTING_SET_TARGET_CPA Формат ГГГГ-ММ-ДД, например, 17.04.2018.

CalloutAssetRecommendation

Рекомендация по объекту уточнения.

JSON-представление 
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
Поля
recommendedCampaignCalloutAssets[]

object ( Asset )

Только вывод. Новые объекты уточнений, рекомендуемые на уровне кампании.

recommendedCustomerCalloutAssets[]

object ( Asset )

Только вывод. Новые объекты расширений уточнений, рекомендованные на уровне клиента.

Дополнительная ссылкаАктивРекомендация

Рекомендация по объекту дополнительной ссылки.

JSON-представление 
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
Поля

CallAssetРекомендация

Этот тип не имеет полей.

Рекомендация по активу колл.

ПокупкиПредложениеАтрибутРекомендация

Рекомендация для покупок о добавлении атрибута к предложениям, которые понижены в рейтинге из-за его отсутствия.

JSON-представление 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
Поля
merchant

object ( MerchantInfo )

Только вывод. Детали аккаунта Merchant Center.

feedLabel

string

Только вывод. Ярлык фида кампании.

offersCount

string ( int64 format)

Только вывод. Количество онлайн-обслуживаемых предложений.

demotedOffersCount

string ( int64 format)

Только вывод. Количество онлайн-предложений, которые были понижены в рейтинге из-за отсутствующих атрибутов. Посетите Merchant Center для получения более подробной информации.

Информация о МерчантИнфо

Данные аккаунта Merchant Center.

JSON-представление 
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
Поля
id

string ( int64 format)

Только вывод. Идентификатор аккаунта Merchant Center.

name

string

Только вывод. Имя аккаунта Merchant Center.

multiClient

boolean

Только вывод. Является ли аккаунт Merchant Center мультиклиентским аккаунтом (MCA).

ПокупкиДобавитьПродуктыВКампанияРекомендация

Торговая рекомендация по добавлению товаров в инвентарь торговой кампании.

JSON-представление 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
Поля
merchant

object ( MerchantInfo )

Только вывод. Детали аккаунта Merchant Center.

feedLabel

string

Только вывод. Ярлык фида кампании.

reason

enum ( Reason )

Только вывод. Причина, по которой к кампании не прикреплены товары.

Причина

Проблемы, из-за которых торговая кампания не ориентирована на ноль товаров.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS В аккаунте Merchant Center нет отправленных товаров.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED В фиде аккаунта Merchant Center нет отправленных товаров.
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN В аккаунте Google Рекламы есть активные фильтры кампаний, которые предотвращают включение предложений в кампанию.
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN Все доступные продукты были явно исключены из целевой кампании.

ПокупкиИсправитьОтклоненоПродуктыРекомендация

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

JSON-представление 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
Поля
merchant

object ( MerchantInfo )

Только вывод. Детали аккаунта Merchant Center.

feedLabel

string

Только вывод. Ярлык фида кампании.

productsCount

string ( int64 format)

Только вывод. Количество товаров кампании.

disapprovedProductsCount

string ( int64 format)

Только вывод. Количество отклоненных товаров кампании.

ПокупкиЦельВсеПредложенияРекомендация

Рекомендация по покупкам: создать всеобъемлющую кампанию, ориентированную на все предложения.

JSON-представление 
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
Поля
merchant

object ( MerchantInfo )

Только вывод. Детали аккаунта Merchant Center.

untargetedOffersCount

string ( int64 format)

Только вывод. Количество нецелевых предложений.

feedLabel

string

Только вывод. Ярлык фида предложений.

ПокупкиMerchantCenterAccountПриостановлениеРекомендация

Рекомендация по покупкам для устранения проблем с блокировкой аккаунта Merchant Center.

JSON-представление 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Поля
merchant

object ( MerchantInfo )

Только вывод. Детали аккаунта Merchant Center.

feedLabel

string

Только вывод. Ярлык фида кампании, для которой произошла блокировка.

ПокупкиМиграцияОбычныйПокупкиКампанияПредложенияToПроизводительностьМаксРекомендация

Торговая рекомендация по переносу таргетированных предложений обычной торговой кампании в кампании с максимальной эффективностью.

JSON-представление 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Поля
merchant

object ( MerchantInfo )

Только вывод. Детали аккаунта Merchant Center.

feedLabel

string

Только вывод. Ярлык фида предложений, на которые нацелены кампании, в которых используется это предложение.

Динамикаимажеекстенсионоптинрекомендатион

Этот тип не имеет полей.

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

Рекомендация RaiseTargetCPA

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

JSON-представление 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
Поля
targetAdjustment

object ( TargetAdjustmentInfo )

Только вывод. Соответствующая информация, описывающая рекомендуемую целевую корректировку.

appBiddingGoal

enum ( AppBiddingGoal )

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

TargetAdjustmentInfo

Информация о рекомендации по корректировке целевого показателя.

JSON-представление 
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
Поля
recommendedTargetMultiplier

number

Только вывод. Коэффициент, на который мы рекомендуем корректировать цель.

currentAverageTargetMicros

string ( int64 format)

Только вывод. Текущая средняя цель кампании или портфеля, на которые распространяется эта рекомендация.

sharedSet

string

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

Цель AppBidding

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Представляет значение, неизвестное в этой версии API.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME Стратегия назначения ставок в кампании для приложений должна быть направлена ​​на максимальное увеличение количества установок приложения.
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME Стратегия назначения ставок в кампании для приложений должна быть направлена ​​на максимальное увеличение количества выбранных конверсий в приложении.
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE Стратегия назначения ставок в кампании для приложений должна быть направлена ​​на максимизацию ценности всех конверсий, то есть установок и выбранных конверсий в приложении.
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION Стратегия назначения ставок в кампании для приложений должна быть направлена ​​на максимальное увеличение количества выбранных конверсий в приложении, при этом достигая или превышая целевую цену за конверсию в приложении.
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND Стратегия назначения ставок в кампании для приложений должна быть направлена ​​на максимизацию ценности всех конверсий, то есть установок и выбранных конверсий в приложении, при этом достигая или превышая целевую рентабельность инвестиций в рекламу.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI Эта стратегия назначения ставок в кампании для приложений должна быть направлена ​​на максимальное увеличение установки приложения без указания целевой цены за установку, указанной рекламодателем.
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME Эта стратегия назначения ставок в кампании для приложений должна быть направлена ​​на максимальное увеличение предварительной регистрации приложения.

Рекомендация LowerTargetRoas

Рекомендация снизить целевую рентабельность инвестиций в рекламу.

JSON-представление 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
Поля
targetAdjustment

object ( TargetAdjustmentInfo )

Только вывод. Соответствующая информация, описывающая рекомендуемую целевую корректировку.

ПроизводительностьMaxOptInРекомендация

Этот тип не имеет полей.

Рекомендация о подписке с максимальной эффективностью.

Рекомендация «Улучшить производительностьМаксимальная сила рекламы»

Рекомендация повысить оценку группы объектов кампании с максимальной эффективностью до "отлично".

JSON-представление 
{
  "assetGroup": string
}
Поля
assetGroup

string

Только вывод. Имя ресурса группы активов.

МиграцияDynamicSearchAdsCampaignToPerformanceMaxRecommendation

Рекомендация по переходу с динамических поисковых объявлений на кампании с максимальной эффективностью.

JSON-представление 
{
  "applyLink": string
}
Поля

ПрогнозированиеSetTargetCpaRecommendation

Рекомендации по установленной целевой цене за конверсию.

JSON-представление 
{
  "recommendedTargetCpaMicros": string,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
Поля
recommendedTargetCpaMicros

string ( int64 format)

Только вывод. Рекомендуемая целевая цена за конверсию.

campaignBudget

object ( CampaignBudget )

Только вывод. Бюджет кампании.

Максимизироватьконверсиявалуеоптинрекомендация

Этот тип не имеет полей.

Рекомендуется выбрать стратегию назначения ставок "Максимальная ценность конверсии".

Рекомендация по улучшению покрытия тегов Google

Этот тип не имеет полей.

Рекомендация разместить тег Google на большем количестве страниц.

PerformanceMaxFinalUrlOptInRecommendation

Этот тип не имеет полей.

Рекомендуется включить расширение конечного URL для кампаний с максимальной эффективностью.

ОбновитьCustomerMatchListРекомендация

Рекомендация обновить список клиентов, который не обновлялся в течение последних 90 дней. Клиент, получающий рекомендацию, не обязательно является владельцем аккаунта. Учетная запись владельца должна обновить список клиентов.

JSON-представление 
{
  "userListId": string,
  "userListName": string,
  "daysSinceLastRefresh": string,
  "topSpendingAccount": [
    {
      object (AccountInfo)
    }
  ],
  "targetingAccountsCount": string,
  "ownerAccount": {
    object (AccountInfo)
  }
}
Поля
userListId

string ( int64 format)

Только вывод. Идентификатор списка пользователей.

userListName

string

Только вывод. Название списка.

daysSinceLastRefresh

string ( int64 format)

Только вывод. Количество дней с момента последнего обновления.

topSpendingAccount[]

object ( AccountInfo )

Только вывод. Самый расходный счет.

targetingAccountsCount

string ( int64 format)

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

ownerAccount

object ( AccountInfo )

Только вывод. Аккаунт владельца. Это учетная запись, которая должна обновить список клиентов.

Информация об аккаунте

Обертка для информации об аккаунте Google Рекламы.

JSON-представление 
{
  "customerId": string,
  "descriptiveName": string
}
Поля
customerId

string ( int64 format)

Только вывод. Идентификатор клиента учетной записи.

descriptiveName

string

Только вывод. Описательное имя учетной записи.

CustomAudienceOptInRecommendation

Рекомендация о согласии на индивидуализированную аудиторию.

JSON-представление 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ]
}
Поля
keywords[]

object ( KeywordInfo )

Только вывод. Список ключевых слов, которые будут использоваться для создания индивидуальной аудитории.

ЛидФормАссетРекомендация

Этот тип не имеет полей.

Лид формирует рекомендации по активам.

УлучшениеDemandGenAdStrengthRecommendation

Рекомендация по улучшению качества рекламы для формирования спроса.

JSON-представление 
{
  "ad": string,
  "adStrength": enum (AdStrength),
  "demandGenAssetActionItems": [
    string
  ]
}
Поля
ad

string

Только вывод. Имя ресурса объявления, которое можно улучшить.

adStrength

enum ( AdStrength )

Только вывод. Текущая мощность объявления.

demandGenAssetActionItems[]

string

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