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、CALLOUT_EXTENSION、ENHANCED_CPC_OPT_IN、USE_BROAD_MATCH_KEYWORD、USE_BROAD_MATCH_KEYWORD、KEYWORD、KEYWORD_MATCH_TYPE、UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX、UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CLICKS_OPT_APP
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)

仅限输出。有关启用“目标每次转化费用”出价策略的建议。
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)

仅限输出。关于宣传信息素材资源的建议。
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)

仅限输出。建议为效果最大化广告系列启用“最终到达网址扩展”功能。
refreshCustomerMatchListRecommendation

object (RefreshCustomerMatchListRecommendation)

仅限输出。刷新客户名单建议。
customAudienceOptInRecommendation

object (CustomAudienceOptInRecommendation)

仅限输出。自定义受众群体选择启用建议。
leadFormAssetRecommendation

object (LeadFormAssetRecommendation)

仅限输出。潜在客户表单素材资源建议。
improveDemandGenAdStrengthRecommendation

object (ImproveDemandGenAdStrengthRecommendation)

仅限输出。关于改进需求开发广告的广告效力建议。

RecommendationImpact

按照建议进行更改的影响。某些类型的建议可能没有影响信息。

JSON 表示法 
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
字段
baseMetrics

object (RecommendationMetrics)

仅限输出。生成建议时的基础指标。
potentialMetrics

object (RecommendationMetrics)

仅限输出。采纳建议后估算的指标。

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

仅限输出。视频广告系列的视频观看次数。

CampaignBudgetRecommendation

针对受预算限制的广告系列的预算建议。

JSON 表示法 
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
字段
budgetOptions[]

object (CampaignBudgetRecommendationOption)

仅限输出。可能的预算金额的一些值对应的预算金额和相关影响估算值。
currentBudgetAmountMicros

string (int64 format)

仅限输出。当前预算金额（以微单位表示）。
recommendedBudgetAmountMicros

string (int64 format)

仅限输出。建议的预算金额（以微单位表示）。

CampaignBudgetRecommendationOption

给定预算金额的预计影响。

JSON 表示法 
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
字段
impact

object (RecommendationImpact)

仅限输出。将预算更改为此选项中指定的金额后预计会产生的影响。
budgetAmountMicros

string (int64 format)

仅限输出。此选项的预算金额。

KeywordRecommendation

关键字建议。

JSON 表示法 
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
字段
keyword

object (KeywordInfo)

仅限输出。建议的关键字。
searchTerms[]

object (SearchTerm)

仅限输出。与此关键字匹配的搜索字词列表。多个关键字可以使用相同的搜索字词。
recommendedCpcBidMicros

string (int64 format)

仅限输出。建议的每次点击费用出价。

SearchTerm

与关键字建议相关的搜索字词的相关信息。

JSON 表示法 
{
  "text": string,
  "estimatedWeeklySearchCount": string
}
字段
text

string

仅限输出。搜索字词的文本。
estimatedWeeklySearchCount

string (int64 format)

仅限输出。此搜索字词的历史每周搜索次数估算值。

TextAdRecommendation

文字广告建议。

JSON 表示法 
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
字段
ad

object (Ad)

仅限输出。推荐广告。
creationDate

string

仅限输出。推荐广告的创建日期。采用 YYYY-MM-DD 格式，例如 2018-04-17。
autoApplyDate

string

仅限输出。日期（如果有）是系统自动采纳建议的最早时间。YYYY-MM-DD 格式，例如 2018-04-17。

TargetCpaOptInRecommendation

启用“目标每次转化费用”出价策略的建议。

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 天的数据计算得出）。

MaximizeConversionsOptInRecommendation

启用“尽可能提高转化次数”出价策略的建议。

JSON 表示法 
{
  "recommendedBudgetAmountMicros": string
}
字段
recommendedBudgetAmountMicros

string (int64 format)

仅限输出。建议的新预算金额。

EnhancedCpcOptInRecommendation

此类型没有字段。

智能点击付费“用户选择观看”建议。

SearchPartnersOptInRecommendation

此类型没有字段。

“启用搜索网络合作伙伴”建议。

MaximizeClicksOptInRecommendation

启用“尽可能争取更多点击次数”出价策略的建议。

JSON 表示法 
{
  "recommendedBudgetAmountMicros": string
}
字段
recommendedBudgetAmountMicros

string (int64 format)

仅限输出。建议的新预算金额。仅在当前预算过高时设置。

OptimizeAdRotationRecommendation

此类型没有字段。

“优化广告轮播”建议。

KeywordMatchTypeRecommendation

关键字匹配类型建议。

JSON 表示法 
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
字段
keyword

object (KeywordInfo)

仅限输出。匹配类型应更宽泛的现有关键字。
recommendedMatchType

enum (KeywordMatchType)

仅限输出。建议的新匹配类型。

MoveUnusedBudgetRecommendation

“改分未使用的预算”建议。

JSON 表示法 
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
字段
budgetRecommendation

object (CampaignBudgetRecommendation)

仅限输出。针对受限预算增加的建议。
excessCampaignBudget

string

仅限输出。富余预算的 resourceName。

TargetRoasOptInRecommendation

“启用目标广告支出回报率”出价策略建议。

JSON 表示法 
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
字段
recommendedTargetRoas

number

仅限输出。推荐的目标广告支出回报率（每单位支出的收入）。值介于 0.01 到 1000.0 之间（包括这两个数值）。
requiredCampaignBudgetAmountMicros

string (int64 format)

仅限输出。实现目标广告支出回报率所需的最低广告系列预算（以账号的本地货币为单位）。金额以微单位指定，即一百万等同于一个货币单位。

ResponsiveSearchAdRecommendation

关于添加自适应搜索广告的建议。

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)

仅限输出。建议的预算，以免在应用建议后受到预算限制。

ResponsiveSearchAdAssetRecommendation

关于添加自适应搜索广告素材资源的建议。

JSON 表示法 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
字段
currentAd

object (Ad)

仅限输出。要更新的当前广告。
recommendedAssets

object (Ad)

仅限输出。推荐的素材资源。此字段仅填充新的标题和/或广告内容描述，否则为空。

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

将智能购物广告系列升级为效果最大化广告系列的建议。

JSON 表示法 
{
  "merchantId": string,
  "salesCountryCode": string
}
字段
merchantId

string (int64 format)

仅限输出。Merchant Center 账号的 ID。
salesCountryCode

string

仅限输出。应包含商家商品目录中哪些国家/地区的商品。

ResponsiveSearchAdImproveAdStrengthRecommendation

自适应搜索广告的广告效力建议。

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)

仅限输出。广告系列的当前平均目标每次转化费用，以客户本地货币为单位（微分）。

ForecastingSetTargetRoasRecommendation

根据预测数据设置目标广告支出回报率的建议。

JSON 表示法 
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
字段
recommendedTargetRoas

number

仅限输出。推荐的目标广告支出回报率（每单位支出的收入）。值介于 0.01 到 1000.0 之间（包括这两个数值）。
campaignBudget

object (CampaignBudget)

仅限输出。广告系列预算。

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 YYYY-MM-DD 格式（例如 2018-04-17）。

CalloutAssetRecommendation

关于宣传信息素材资源的建议。

JSON 表示法 
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
字段
recommendedCampaignCalloutAssets[]

object (Asset)

仅限输出。建议在广告系列一级添加新的附加宣传信息素材资源。
recommendedCustomerCalloutAssets[]

object (Asset)

仅限输出。在客户一级推荐的新附加宣传信息素材资源。

SitelinkAssetRecommendation

站内链接素材资源建议。

JSON 表示法 
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
字段

CallAssetRecommendation

此类型没有字段。

电话素材资源建议。

ShoppingOfferAttributeRecommendation

购物建议：为因缺少属性而被降级的商品添加属性。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
字段
merchant

object (MerchantInfo)

仅限输出。Merchant Center 账号的详细信息。
feedLabel

string

仅限输出。广告系列 Feed 标签。
offersCount

string (int64 format)

仅限输出。可在线投放的商品数量。
demotedOffersCount

string (int64 format)

仅限输出。因缺少属性而被降级的在线可投放商品的数量。如需了解详情，请访问 Merchant Center。

MerchantInfo

Merchant Center 账号详情。

JSON 表示法 
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
字段
id

string (int64 format)

仅限输出。Merchant Center 账号 ID。
name

string

仅限输出。Merchant Center 账号的名称。
multiClient

boolean

仅限输出。Merchant Center 账号是否为多客户账号 (MCA)。

ShoppingAddProductsToCampaignRecommendation

建议向购物广告系列产品目录添加产品的购物建议。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
字段
merchant

object (MerchantInfo)

仅限输出。Merchant Center 账号的详细信息。
feedLabel

string

仅限输出。广告系列的 Feed 标签。
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 账号的 Feed 中没有任何已提交的产品。
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN 该 Google Ads 账号设置了有效的广告系列过滤条件，用于防止在广告系列中包含优惠信息。
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN 所有可售商品均已明确排除在广告系列的宣传对象范围之外。

ShoppingFixDisapprovedProductsRecommendation

用于解决购物广告系列商品目录中被拒登产品问题的购物建议。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
字段
merchant

object (MerchantInfo)

仅限输出。Merchant Center 账号的详细信息。
feedLabel

string

仅限输出。广告系列的 Feed 标签。
productsCount

string (int64 format)

仅限输出。广告系列的商品数量。
disapprovedProductsCount

string (int64 format)

仅限输出。广告系列中被拒登的产品数量。

ShoppingTargetAllOffersRecommendation

购物建议：制作一个定位所有商品的全包型广告系列。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
字段
merchant

object (MerchantInfo)

仅限输出。Merchant Center 账号的详细信息。
untargetedOffersCount

string (int64 format)

仅限输出。未定位优惠的数量。
feedLabel

string

仅限输出。商品 Feed 标签。

ShoppingMerchantCenterAccountSuspensionRecommendation

用于解决 Merchant Center 账号中止问题的购物建议。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
字段
merchant

object (MerchantInfo)

仅限输出。Merchant Center 账号的详细信息。
feedLabel

string

仅限输出。发生中止的广告系列的 Feed 标签。

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

建议将常规购物广告系列定位到的商品迁移到效果最大化广告系列。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
字段
merchant

object (MerchantInfo)

仅限输出。Merchant Center 账号的详细信息。
feedLabel

string

仅限输出。共享此建议的广告系列定位到的商品的 Feed 标签。

DynamicImageExtensionOptInRecommendation

此类型没有字段。

建议在账号中启用动态图片附加信息，以便 Google 从广告着陆页中找到最佳图片，并为文字广告锦上添花。

RaiseTargetCpaRecommendation

建议提高目标每次转化费用。

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

仅限输出。定义了目标的组合出价策略的共享集资源名称。仅当建议是组合层级时填充。

AppBiddingGoal

表示应用广告系列的出价策略应作为优化目标。

枚举
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 此应用广告系列的出价策略应以尽可能提高应用的预注册量为目标。

LowerTargetRoasRecommendation

建议降低目标广告支出回报率。

JSON 表示法 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
字段
targetAdjustment

object (TargetAdjustmentInfo)

仅限输出。用于说明建议的目标调整值的相关信息。

PerformanceMaxOptInRecommendation

此类型没有字段。

选择启用效果最大化广告系列的建议。

ImprovePerformanceMaxAdStrengthRecommendation

建议将效果最大化广告系列的素材资源组效力提升至“极佳”评分。

JSON 表示法 
{
  "assetGroup": string
}
字段
assetGroup

string

仅限输出。素材资源组资源名称。

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

从动态搜索广告迁移到效果最大化广告系列的建议。

JSON 表示法 
{
  "applyLink": string
}
字段

ForecastingSetTargetCpaRecommendation

目标每次转化费用建议。

JSON 表示法 
{
  "recommendedTargetCpaMicros": string,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
字段
recommendedTargetCpaMicros

string (int64 format)

仅限输出。建议的目标每次转化费用。
campaignBudget

object (CampaignBudget)

仅限输出。广告系列预算。

MaximizeConversionValueOptInRecommendation

此类型没有字段。

建议采用“尽可能提高转化价值”出价策略。

ImproveGoogleTagCoverageRecommendation

此类型没有字段。

建议在更多网页上部署 Google 代码。

PerformanceMaxFinalUrlOptInRecommendation

此类型没有字段。

建议为效果最大化广告系列启用“最终到达网址扩展”功能。

RefreshCustomerMatchListRecommendation

建议更新过去 90 天内未更新的客户名单。收到建议的客户不一定是所有者账号。所有者账号应更新客户名单。

JSON 表示法 
{
  "userListId": string,
  "userListName": string,
  "daysSinceLastRefresh": string,
  "topSpendingAccount": [
    {
      object (AccountInfo)
    }
  ],
  "targetingAccountsCount": string,
  "ownerAccount": {
    object (AccountInfo)
  }
}
字段
userListId

string (int64 format)

仅限输出。用户列表 ID。
userListName

string

仅限输出。列表的名称。
daysSinceLastRefresh

string (int64 format)

仅限输出。距离上次刷新的时间（天）。
topSpendingAccount[]

object (AccountInfo)

仅限输出。支出最高的客户。
targetingAccountsCount

string (int64 format)

仅限输出。用户名单可以由所有者与其他账号共享。targetingAccountsCount 是可以将其用于定位的账号数量。
ownerAccount

object (AccountInfo)

仅限输出。所有者账号。这是应更新客户名单的账号。

AccountInfo

用于封装 Google Ads 账号相关信息的容器。

JSON 表示法 
{
  "customerId": string,
  "descriptiveName": string
}
字段
customerId

string (int64 format)

仅限输出。账户的客户 ID。
descriptiveName

string

仅限输出。账号的描述性名称。

CustomAudienceOptInRecommendation

“选择启用自定义受众群体”建议。

JSON 表示法 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ]
}
字段
keywords[]

object (KeywordInfo)

仅限输出。用于创建自定义受众群体的关键字列表。

LeadFormAssetRecommendation

此类型没有字段。

潜在客户表单素材资源建议。

改进了 DemandGenAdStrengthRecommendation

“提升需求开发广告的广告效力”建议。

JSON 表示法 
{
  "ad": string,
  "adStrength": enum (AdStrength),
  "demandGenAssetActionItems": [
    string
  ]
}
字段
ad

string

仅限输出。可以改进的广告的资源名称。
adStrength

enum (AdStrength)

仅限输出。当前的广告效力。
demandGenAssetActionItems[]

string

仅限输出。有助于提升广告效力的建议列表。