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_IN、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CONVERSIONSAPPORSEARCH_SEARCH_SEARCH_SEARCH_APP_SEARCH_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)

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

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

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 之间（含 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 之间（含 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

此类型没有字段。

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

ImproveDemandGenAdStrengthRecommendation

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

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

string

仅限输出。可以优化的广告的资源名称。
adStrength

enum (AdStrength)

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

string

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