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.
}
Поля
resource Name

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.

campaign Budget

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_CONVERS. IONS_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, 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_DIS, APPROVED_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, ZE_CONVERSION_VALUE_OPT_IN, IMPROVE_GOOGLE_TAG_COVERAGE, PERFORMANCE_MAX_FINAL_URL_OPT_IN

ad Group

string

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

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

dismissed

boolean

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

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

object ( CampaignBudgetRecommendation )

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

forecasting Campaign Budget Recommendation

object ( CampaignBudgetRecommendation )

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

keyword Recommendation

object ( KeywordRecommendation )

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

text Ad Recommendation

object ( TextAdRecommendation )

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

target Cpa Opt In Recommendation

object ( TargetCpaOptInRecommendation )

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

maximize Conversions Opt In Recommendation

object ( MaximizeConversionsOptInRecommendation )

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

enhanced Cpc Opt In Recommendation

object ( EnhancedCpcOptInRecommendation )

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

search Partners Opt In Recommendation

object ( SearchPartnersOptInRecommendation )

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

maximize Clicks Opt In Recommendation

object ( MaximizeClicksOptInRecommendation )

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

optimize Ad Rotation Recommendation

object ( OptimizeAdRotationRecommendation )

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

keyword Match Type Recommendation

object ( KeywordMatchTypeRecommendation )

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

move Unused Budget Recommendation

object ( MoveUnusedBudgetRecommendation )

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

target Roas Opt In Recommendation

object ( TargetRoasOptInRecommendation )

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

responsive Search Ad Recommendation

object ( ResponsiveSearchAdRecommendation )

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

marginal Roi Campaign Budget Recommendation

object ( CampaignBudgetRecommendation )

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

use Broad Match Keyword Recommendation

object ( UseBroadMatchKeywordRecommendation )

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

responsive Search Ad Asset Recommendation

object ( ResponsiveSearchAdAssetRecommendation )

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

upgrade Smart Shopping Campaign To Performance Max Recommendation

object ( UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation )

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

responsive Search Ad Improve Ad Strength Recommendation

object ( ResponsiveSearchAdImproveAdStrengthRecommendation )

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

display Expansion Opt In Recommendation

object ( DisplayExpansionOptInRecommendation )

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

upgrade Local Campaign To Performance Max Recommendation

object ( UpgradeLocalCampaignToPerformanceMaxRecommendation )

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

raise Target Cpa Bid Too Low Recommendation

object ( RaiseTargetCpaBidTooLowRecommendation )

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

forecasting Set Target Roas Recommendation

object ( ForecastingSetTargetRoasRecommendation )

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

callout Asset Recommendation

object ( CalloutAssetRecommendation )

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

call Asset Recommendation

object ( CallAssetRecommendation )

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

shopping Add Age Group Recommendation

object ( ShoppingOfferAttributeRecommendation )

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

shopping Add Color Recommendation

object ( ShoppingOfferAttributeRecommendation )

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

shopping Add Gender Recommendation

object ( ShoppingOfferAttributeRecommendation )

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

shopping Add Gtin Recommendation

object ( ShoppingOfferAttributeRecommendation )

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

shopping Add More Identifiers Recommendation

object ( ShoppingOfferAttributeRecommendation )

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

shopping Add Size Recommendation

object ( ShoppingOfferAttributeRecommendation )

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

shopping Add Products To Campaign Recommendation

object ( ShoppingAddProductsToCampaignRecommendation )

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

shopping Fix Disapproved Products Recommendation

object ( ShoppingFixDisapprovedProductsRecommendation )

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

shopping Target All Offers Recommendation

object ( ShoppingTargetAllOffersRecommendation )

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

shopping Fix Suspended Merchant Center Account Recommendation

object ( ShoppingMerchantCenterAccountSuspensionRecommendation )

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

shopping Fix Merchant Center Account Suspension Warning Recommendation

object ( ShoppingMerchantCenterAccountSuspensionRecommendation )

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

shopping Migrate Regular Shopping Campaign Offers To Performance Max Recommendation

object ( ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation )

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

dynamic Image Extension Opt In Recommendation

object ( DynamicImageExtensionOptInRecommendation )

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

raise Target Cpa Recommendation

object ( RaiseTargetCpaRecommendation )

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

lower Target Roas Recommendation

object ( LowerTargetRoasRecommendation )

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

performance Max Opt In Recommendation

object ( PerformanceMaxOptInRecommendation )

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

improve Performance Max Ad Strength Recommendation

object ( ImprovePerformanceMaxAdStrengthRecommendation )

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

migrate Dynamic Search Ads Campaign To Performance Max Recommendation

object ( MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation )

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

forecasting Set Target Cpa Recommendation

object ( ForecastingSetTargetCpaRecommendation )

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

set Target Cpa Recommendation

object ( ForecastingSetTargetCpaRecommendation )

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

set Target Roas Recommendation

object ( ForecastingSetTargetRoasRecommendation )

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

maximize Conversion Value Opt In Recommendation

object ( MaximizeConversionValueOptInRecommendation )

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

improve Google Tag Coverage Recommendation

object ( ImproveGoogleTagCoverageRecommendation )

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

performance Max Final Url Opt In Recommendation

object ( PerformanceMaxFinalUrlOptInRecommendation )

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

refresh Customer Match List Recommendation

object ( RefreshCustomerMatchListRecommendation )

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

custom Audience Opt In Recommendation

object ( CustomAudienceOptInRecommendation )

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

lead Form Asset Recommendation

object ( LeadFormAssetRecommendation )

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

improve Demand Gen Ad Strength Recommendation

object ( ImproveDemandGenAdStrengthRecommendation )

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

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

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

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

object ( RecommendationMetrics )

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

potential Metrics

object ( RecommendationMetrics )

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

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

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

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

number

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

clicks

number

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

cost Micros

string ( int64 format)

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

conversions

number

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

conversions Value

number

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

video Views

number

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

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

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

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

object ( CampaignBudgetRecommendationOption )

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

current Budget Amount Micros

string ( int64 format)

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

recommended Budget Amount Micros

string ( int64 format)

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

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

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

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

object ( RecommendationImpact )

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

budget Amount Micros

string ( int64 format)

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

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

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

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

object ( KeywordInfo )

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

search Terms[]

object ( SearchTerm )

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

recommended Cpc Bid Micros

string ( int64 format)

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

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

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

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

string

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

estimated Weekly Search Count

string ( int64 format)

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

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

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

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

object ( Ad )

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

creation Date

string

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

auto Apply Date

string

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

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

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

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

object ( TargetCpaOptInRecommendationOption )

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

recommended Target Cpa Micros

string ( int64 format)

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

TargetCpaOptInRecommendationOption

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

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

enum ( TargetCpaOptInRecommendationGoal )

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

impact

object ( RecommendationImpact )

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

target Cpa Micros

string ( int64 format)

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

required Campaign Budget Amount Micros

string ( int64 format)

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

TargetCpaOptInRecommendationGoal

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

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

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

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

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

string ( int64 format)

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

EnhancedCpcOptInRecommendation

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

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

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

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

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

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

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

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

string ( int64 format)

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

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

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

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

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

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

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

object ( KeywordInfo )

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

recommended Match Type

enum ( KeywordMatchType )

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

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

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

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

object ( CampaignBudgetRecommendation )

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

excess Campaign Budget

string

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

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

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

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

number

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

required Campaign Budget Amount Micros

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 )

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

suggested Keywords Count

string ( int64 format)

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

campaign Keywords Count

string ( int64 format)

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

campaign Uses Shared Budget

boolean

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

required Campaign Budget Amount Micros

string ( int64 format)

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

АдаптивныйSearchAdAssetRecommendation

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

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

object ( Ad )

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

recommended Assets

object ( Ad )

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

ОбновитьSmartShoppingCampaignToPerformanceMaxRecommendation

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

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

string ( int64 format)

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

sales Country Code

string

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

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

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

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

object ( Ad )

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

recommended Ad

object ( Ad )

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

DisplayExpansionOptInRecommendation

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

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

UpgradeLocalCampaignToPerformanceMaxRecommendation

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

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

RaiseTargetCpaBidTooLowRecommendation

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

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

number

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

average Target Cpa Micros

string ( int64 format)

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

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

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

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

number

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

campaign Budget

object ( CampaignBudget )

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

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

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

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

string ( int64 format)

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

recommended New Amount Micros

string ( int64 format)

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

new Start Date

string

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

CalloutAssetRecommendation

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

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

object ( Asset )

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

recommended Customer Callout Assets[]

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.

feed Label

string

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

offers Count

string ( int64 format)

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

demoted Offers Count

string ( int64 format)

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

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

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

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

string ( int64 format)

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

name

string

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

multi Client

boolean

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

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

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

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

object ( MerchantInfo )

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

feed Label

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.

feed Label

string

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

products Count

string ( int64 format)

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

disapproved Products Count

string ( int64 format)

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

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

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

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

object ( MerchantInfo )

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

untargeted Offers Count

string ( int64 format)

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

feed Label

string

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

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

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

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

object ( MerchantInfo )

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

feed Label

string

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

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

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

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

object ( MerchantInfo )

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

feed Label

string

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

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

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

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

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

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

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

object ( TargetAdjustmentInfo )

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

app Bidding Goal

enum ( AppBiddingGoal )

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

TargetAdjustmentInfo

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

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

number

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

current Average Target Micros

string ( int64 format)

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

shared Set

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)
  }
}
Поля
target Adjustment

object ( TargetAdjustmentInfo )

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

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

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

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

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

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

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

string

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

МиграцияDynamicSearchAdsCampaignToPerformanceMaxRecommendation

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

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

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

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

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

string ( int64 format)

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

campaign Budget

object ( CampaignBudget )

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

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

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

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

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

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

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

PerformanceMaxFinalUrlOptInRecommendation

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

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

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

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

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

string ( int64 format)

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

user List Name

string

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

days Since Last Refresh

string ( int64 format)

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

top Spending Account[]

object ( AccountInfo )

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

targeting Accounts Count

string ( int64 format)

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

owner Account

object ( AccountInfo )

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

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

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

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

string ( int64 format)

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

descriptive Name

string

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

CustomAudienceOptInRecommendation

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

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

object ( KeywordInfo )

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

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

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

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

УлучшениеDemandGenAdStrengthRecommendation

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

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

string

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

ad Strength

enum ( AdStrength )

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

demand Gen Asset Action Items[]

string

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