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_CPA_CAMPAIGN_PRODUCT_DATE_NAME、DATEF_DATE_NAME、概述_邮箱、事件和交易所占有：
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)

仅供输出。边际 ROI 广告系列预算建议。
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

仅供输出。可提升广告效力的建议列表。