Method: customers.recommendations.generate

根據要求的 RecommendationsType 產生建議。

擲回錯誤清單：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)

必要欄位。要產生的符合資格 RecommendationsType 清單。如果上傳的條件不足而無法提供建議，或是廣告活動已經處於建議狀態，系統就不會傳回該類型的建議。一般來說，如果已上傳該 RecommendationsType 的所有必填欄位，但目前並不符合需求，系統就會傳回建議。

產生建議時，系統支援下列最佳化建議類型：KEYWORD、MAXIMIZE_CLICK_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)

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

object (AdGroupInfo)

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

enum (ConversionTrackingStatus)

選用設定。目前的轉換追蹤狀態。下列最佳化建議類型必須使用這個欄位：MAXIMIZE_CLICK_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_CLICK_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)

這份建議清單。如果資料不足，無法針對要求的 RecommendationsType 產生建議，結果集就不會包含該類型的建議。

授權範圍

需要下列 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_CLICK_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)

目前的 targetCpa (以微量為單位)。可根據出價策略類型為 TARGET_CPA 或 MAXIMIZE_CONVERSIONS 的廣告活動填入這項資料。
targetRoas

number

目前 targetRoas。可為出價策略類型為「TARGET_ROAS」或「MAXIMIZE_CONVERSION_VALUE」的廣告活動填入這項資料。

AdGroupInfo

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

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

object (KeywordInfo)

選用設定。目前的關鍵字。如果已設定 adGroupInfo，則下列建議類型為選用欄位：KEYWORD
adGroupType

enum (AdGroupType)

選用設定。廣告群組的廣告群組類型。如果已設定 adGroupInfo，則下列 RecommendationsType 為必要欄位：KEYWORD

SeedInfo

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

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

string

選用設定。用來產生提案的關鍵字或詞組，例如「汽車或我附近的汽車經銷商」。
urlSeed

string

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