Method: customers.recommendations.generate

根據要求的 recommendationTypes 產生推薦內容。

擲回錯誤清單：AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

HTTP 要求

POST https://googleads.googleapis.com/v16/customers/{customerId}/recommendations:generate

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

必要欄位。產生建議的客戶 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
欄位
recommendationTypes[]

enum (RecommendationType)

必要欄位。要產生的符合資格 recommendationTypes 清單。如果上傳的條件不足以提供最佳化建議，或是廣告活動已處於最佳化狀態，系統就不會針對該類型傳回最佳化建議。一般而言，如果您上傳了 RecommendationsType 的所有必填欄位，但有時這麼做並不足，系統就會傳回建議。

系統支援下列 recommendationTypes 產生最佳化建議：KEYWORD、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CONVERSIONS_OPT_IN、MAXIMIZE_CONVERSION_VALUE_OPT_IN、SET_TARGET_CPA、SET_TARGET_ROAS、SITELINK_ASSET、TARGET_CPA_OPT_IN、TARGET_ROAS_OPT_IN
advertisingChannelType

enum (AdvertisingChannelType)

必要欄位。廣告活動的廣告管道類型。系統支援下列 advertisingChannelTypes 產生最佳化建議：PERFORMANCE_MAX 和 SEARCH
adGroupInfo[]

object (AdGroupInfo)

選用設定。目前的廣告群組資訊。支援單一廣告群組的資訊。對下列建議類型而言，此為選填欄位：KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

選用設定。目前的轉換追蹤狀態。對下列建議類型而言，這是必要欄位：MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CONVERSIONS_OPT_IN、MAXIMIZE_CONVERSION_VALUE_OPT_IN、SET_TARGET_CPA、SET_TARGET_ROAS、TARGET_CPA_OPT_IN、TARGET_ROAS_OPT_IN
biddingInfo

object (BiddingInfo)

選用設定。廣告活動的目前出價資訊。對下列建議類型而言，這是必要欄位：MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CONVERSIONS_OPT_IN、MAXIMIZE_CONVERSION_VALUE_OPT_IN、SET_TARGET_CPA、SET_TARGET_ROAS、TARGET_CPA_OPT_IN、TARGET_ROAS_OPT_IN
seedInfo

object (SeedInfo)

選用設定。關鍵字的字根資訊。以下建議類型需使用這個欄位：KEYWORD

回應主體

對「RecommendationService.GenerateRecommendations」的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
欄位
recommendations[]

object (Recommendation)

從傳入的所要求的 recommendationTypes 集合產生的建議清單。如果資料不足以產生所要求的 recommendationTypes 建議，結果集就不會包含該類型的建議。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/adwords

詳情請參閱 OAuth 2.0 總覽。

BiddingInfo

廣告活動目前的出價資訊。為出價相關信號提供包裝函式，以便提供推薦內容。

JSON 表示法 
{
  "biddingStrategyType": enum (BiddingStrategyType),

  // Union field bidding_strategy_target_info can be only one of the following:
  "targetCpaMicros": string,
  "targetRoas": number
  // End of list of possible types for union field bidding_strategy_target_info.
}
欄位
biddingStrategyType

enum (BiddingStrategyType)

目前出價策略。下列推薦類型需要使用這個欄位：MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CONVERSIONS_OPT_IN、MAXIMIZE_CONVERSION_VALUE_OPT_IN、SET_TARGET_CPA、SET_TARGET_ROAS、TARGET_CPA_OPT_IN、TARGET_ROAS_OPT_IN
聯集欄位 bidding_strategy_target_info。與 bidding_strategy_type 相關的選用詳細資料。bidding_strategy_target_info 只能是下列其中一項：
targetCpaMicros

string (int64 format)

目前的目標單次轉換出價 (以百萬分之一為單位)。如果廣告活動的出價策略類型為 TARGET_CPA 或 MAXIMIZE_CONVERSIONS，就可以填入這項資訊。
targetRoas

number

目前的目標廣告投資報酬率。如果廣告活動的出價策略類型為 TARGET_ROAS 或 MAXIMIZE_CONVERSION_VALUE，就可以填入這項數值。

AdGroupInfo

廣告活動的目前的廣告群組資訊。

JSON 表示法 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
欄位
keywords[]

object (KeywordInfo)

選用設定。目前的關鍵字。如果 adGroupInfo 已設為 KEYWORD，則此欄位為下列 recommendationTypes 的選填欄位：
adGroupType

enum (AdGroupType)

選用設定。廣告群組的廣告群組類型。如果已設定 adGroupInfo，則下列 recommendationTypes 需要使用這個欄位：KEYWORD

SeedInfo

用來產生關鍵字的關鍵字字根和特定網址。

JSON 表示法 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
欄位
keywordSeeds[]

string

選用設定。能根據「汽車」或「附近的汽車經銷商」等關鍵字構思提案。
urlSeed

string

要產生提案的相關網址，例如：www.example.com/cars。