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、ENHANCED_CPC_OPT_IN、USE_BROAD_MATCH_KEYWORD、KEYWORD、KEYWORD_MATCH_TYPE、UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CONVERSIONS_OPT_IN、OPTIMIZE_AD_ROTATION、RESPONSIVE_SEARCH_AD、RESPONSIVE_SEARCH_AD_ASSET、SEARCH_PARTNERS_OPT_IN、DISPLAY_EXPANSION_OPT_IN、SITELINK_EXTENSION、TARGET_CPA_OPT_IN、TARGET_ROAS_OPT_IN、TEXT_AD、UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX、RAISE_TARGET_CPA_BID_TOO_LOW、FORECASTING_SET_TARGET_ROAS、SHOPPING_ADD_AGE_GROUP、SHOPPING_ADD_COLOR、SHOPPING_ADD_GENDER、SHOPPING_ADD_SIZE、SHOPPING_ADD_GTIN、SHOPPING_ADD_MORE_IDENTIFIERS、SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN、SHOPPING_FIX_DISAPPROVED_PRODUCTS、SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX、DYNAMIC_IMAGE_EXTENSION_OPT_IN、RAISE_TARGET_CPA、LOWER_TARGET_ROAS、FORECASTING_SET_TARGET_CPA、SET_TARGET_CPA、SET_TARGET_ROAS、MAXIMIZE_CONVERSION_VALUE_OPT_IN、IMPROVE_GOOGLE_TAG_COVERAGE、PERFORMANCE_MAX_FINAL_URL_OPT_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)

僅供輸出。成本效益管理系統 (ECPC) 的選擇加入建議。

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)

僅供輸出。達成目標單次轉換出價所需的最低廣告活動預算 (以帳戶當地幣別計算)。金額以微量單位表示,其中百萬分之一等於一個貨幣單位。

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

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

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)

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

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

僅供輸出。列出可改善廣告優異度的最佳化建議。