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_CPA, CALLOUT_EXTENSION, CAMPAIGNHANCED_CPC_OPT_IN, USE_BROAD_MATCH_KEYWORD,KEYWORD, KEYWORD_MATCH_TYPE, UPGRADE_LOCAL_CAMPAIGN_SET_IN, MAXIMIZE_CLICK_OPT_IN, 提高轉換, 提高預期出價, 提高單次轉換, 提高轉換率, 提高預期出價, 提高單次轉換。目標投資報酬率：{/5}
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)

僅供輸出。購物新增全球交易品項識別碼建議。
shoppingAddMoreIdentifiersRecommendation

object (ShoppingOfferAttributeRecommendation)

僅供輸出。購物廣告新增更多 ID 最佳化建議。
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)

僅供輸出。帳戶要達到目標單次轉換出價所需的最低廣告活動預算 (以當地幣別表示)。金額是以微量指定，100 萬相當於一個貨幣單位。

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)

僅供輸出。要達到目標廣告投資報酬率所需的最低廣告活動預算 (以當地幣別表示)，金額是以微量指定，100 萬相當於一個貨幣單位。

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

僅供輸出。廣告活動動態饋給標籤。
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

僅供輸出。廣告活動的動態饋給標籤。
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 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

僅供輸出。廣告活動的動態饋給標籤。
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

僅供輸出。優惠動態饋給標籤。

ShoppingMerchantCenterAccountSuspensionRecommendation

修正購物建議，修正 Merchant Center 帳戶停權問題。

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

object (MerchantInfo)

僅供輸出。Merchant Center 帳戶的詳細資料。
feedLabel

string

僅供輸出。停權廣告活動的動態饋給標籤。

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

購物建議將一般購物廣告活動的指定優惠遷移至最高成效廣告活動。

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

object (MerchantInfo)

僅供輸出。Merchant Center 帳戶的詳細資料。
feedLabel

string

僅供輸出。廣告活動指定優惠的動態饋給標籤。

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)

僅供輸出。擁有者可與其他帳戶共用使用者名單。targetAccountsCount 是指帳戶數量可用於指定目標的帳戶。
ownerAccount

object (AccountInfo)

僅供輸出。擁有者帳戶。這個帳戶應更新顧客名單。

AccountInfo

Google Ads 帳戶相關資訊的包裝函式。

JSON 表示法 
{
  "customerId": string,
  "descriptiveName": string
}
欄位
customerId

string (int64 format)

僅供輸出。帳戶的客戶編號。
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

僅供輸出。廣告優異度提升的最佳化建議清單。