Method: customers.generateKeywordForecastMetrics

傳回特定廣告活動關鍵字預測的指標 (例如曝光次數、點擊次數、總費用)。

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

HTTP 要求

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateKeywordForecastMetrics

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

路徑參數

參數
customerId

string

客戶的 ID。

要求主體

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

JSON 表示法 
{
  "forecastPeriod": {
    object (DateRange)
  },
  "campaign": {
    object (CampaignToForecast)
  },
  "currencyCode": string
}
欄位
forecastPeriod

object (DateRange)

預測的日期範圍。開始日期必須在未來，且結束日期須為從今天算起的 1 年內。使用的參照時區是屬於客戶的其中一個 Google Ads 帳戶。如未設定，系統會使用從下週日到下週六的預設日期範圍。
campaign

object (CampaignToForecast)

必要欄位。用於預測的廣告活動。
currencyCode

string

用於匯率換算的貨幣。根據預設，系統會使用客戶的帳戶幣別。只有在貨幣與帳戶貨幣不同時，才需要設定這個欄位。有效貨幣代碼清單請見 https://developers.google.com/google-ads/api/data/codes-formats#currency-codes。

回應主體

[KeywordPlanIdeaService.GenerateKeywordForecastMetrics] 的回應訊息。

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

JSON 表示法 
{
  "campaignForecastMetrics": {
    object (KeywordForecastMetrics)
  }
}
欄位
campaignForecastMetrics

object (KeywordForecastMetrics)

廣告活動預測結果。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

CampaignToForecast

要進行關鍵字廣告活動預測的廣告活動。

JSON 表示法 
{
  "languageConstants": [
    string
  ],
  "geoModifiers": [
    {
      object (CriterionBidModifier)
    }
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "biddingStrategy": {
    object (CampaignBiddingStrategy)
  },
  "adGroups": [
    {
      object (ForecastAdGroup)
    }
  ],
  "conversionRate": number
}
欄位
languageConstants[]

string

要指定的語言資源名稱清單。資源名稱的格式為「languageConstants/{criterionId}」。如需語言條件代碼清單，請參閱 https://developers.google.com/google-ads/api/data/codes-formats#languages。
geoModifiers[]

object (CriterionBidModifier)

要指定的地區。位置不得重複。
keywordPlanNetwork

enum (KeywordPlanNetwork)

必要欄位。用於指定目標的聯播網。
negativeKeywords[]

object (KeywordInfo)

執行預測時要在廣告活動中使用的排除關鍵字清單。
biddingStrategy

object (CampaignBiddingStrategy)

必要欄位。廣告活動的出價策略。
adGroups[]

object (ForecastAdGroup)

新廣告活動中的廣告群組要預測。
conversionRate

number

使用者定義的預期轉換率 (轉換次數除以總點擊次數)。這個值會以小數值表示，因此預期轉換率為 2%，輸入的值應為 0.02。如果留空，系統會使用預估轉換率。

CriterionBidModifier

地區條件出價調節係數。

JSON 表示法 
{
  "geoTargetConstant": string,
  "bidModifier": number
}
欄位
geoTargetConstant

string

要指定的地理位置的資源名稱。資源名稱的格式為「geoTargetConstants/{criterionId}」。
bidModifier

number

與 conditionId 相關聯的調節係數。設定後，這個值不能為 0。

CampaignBiddingStrategy

新廣告活動預測功能支援的出價策略。

JSON 表示法 
{

  // Union field bidding_strategy can be only one of the following:
  "manualCpcBiddingStrategy": {
    object (ManualCpcBiddingStrategy)
  },
  "maximizeClicksBiddingStrategy": {
    object (MaximizeClicksBiddingStrategy)
  },
  "maximizeConversionsBiddingStrategy": {
    object (MaximizeConversionsBiddingStrategy)
  }
  // End of list of possible types for union field bidding_strategy.
}
欄位
聯集欄位 bidding_strategy。出價策略。bidding_strategy 只能是下列其中一項：
manualCpcBiddingStrategy

object (ManualCpcBiddingStrategy)

請使用手動單次點擊出價策略進行預測。
maximizeClicksBiddingStrategy

object (MaximizeClicksBiddingStrategy)

使用「盡量爭取點擊」出價策略進行預測。
maximizeConversionsBiddingStrategy

object (MaximizeConversionsBiddingStrategy)

使用「盡量爭取轉換」出價策略進行預測。

ManualCpcBiddingStrategy

手動單次點擊出價策略。

JSON 表示法 
{
  "maxCpcBidMicros": string,
  "dailyBudgetMicros": string
}
欄位
maxCpcBidMicros

string (int64 format)

必要欄位。以手動單次點擊出價策略，套用至廣告活動中廣告群組的出價 (以微秒為單位)。
dailyBudgetMicros

string (int64 format)

廣告活動層級預算 (以百萬分之一為單位)。如果已設定，系統會針對廣告活動使用的當地幣別強制執行最小值。如果設定這個欄位的值過低，系統會顯示最小值錯誤。

MaximizeClicksBiddingStrategy

盡量爭取點擊出價策略。

JSON 表示法 
{
  "dailyTargetSpendMicros": string,
  "maxCpcBidCeilingMicros": string
}
欄位
dailyTargetSpendMicros

string (int64 format)

必要欄位。用於估算的每日目標支出 (以百萬分之一為單位)。系統會針對廣告活動使用的當地幣別強制執行最低價值。如果設定這個欄位的值過低，系統會顯示最小值錯誤。
maxCpcBidCeilingMicros

string (int64 format)

設定最高單次點擊出價 (以百萬分之一為單位)。

MaximizeConversionsBiddingStrategy

「盡量爭取轉換」出價策略。

JSON 表示法 
{
  "dailyTargetSpendMicros": string
}
欄位
dailyTargetSpendMicros

string (int64 format)

必要欄位。用於估算的每日目標支出 (以百萬分之一為單位)。這個值必須大於 0。

ForecastAdGroup

要預測廣告活動中的廣告群組。

JSON 表示法 
{
  "biddableKeywords": [
    {
      object (BiddableKeyword)
    }
  ],
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "maxCpcBidMicros": string
}
欄位
biddableKeywords[]

object (BiddableKeyword)

必要欄位。進行預測時，要用於廣告群組的可出價關鍵字清單。需要至少一個關鍵字。
negativeKeywords[]

object (KeywordInfo)

關鍵字的詳情。同時指定關鍵字文字和比對類型。
maxCpcBidMicros

string (int64 format)

廣告群組產生預測流量時使用的最高單次點擊出價。這個值會覆寫出價策略中設定的最高單次點擊出價值。只有最高單次點擊出價值的出價策略可以指定這個欄位。

BiddableKeyword

廣告群組中的可出價關鍵字部分。

JSON 表示法 
{
  "keyword": {
    object (KeywordInfo)
  },
  "maxCpcBidMicros": string
}
欄位
keyword

object (KeywordInfo)

必要欄位。關鍵字。必須包含文字和比對類型。
maxCpcBidMicros

string (int64 format)

最高單次點擊出價 (以百萬分之一為單位)，在預測模擬中會覆寫廣告群組層級的最高單次點擊出價。這個值會覆寫出價策略和廣告群組中設定的最高單次點擊出價值。請只針對支援最高單次點擊出價值的出價策略指定這個欄位。

KeywordForecastMetrics

無規劃關鍵字廣告活動的預測指標。

JSON 表示法 
{
  "impressions": number,
  "clickThroughRate": number,
  "averageCpcMicros": string,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionRate": number,
  "averageCpaMicros": string
}
欄位
impressions

number

曝光總數。
clickThroughRate

number

平均點閱率。只有在曝光次數大於 0 時才能使用。
averageCpcMicros

string (int64 format)

平均單次點擊出價。只有在點擊次數大於 0 時才能使用。
clicks

number

總點擊次數。
costMicros

string (int64 format)

總費用。
conversions

number

預測轉換次數：點擊次數 * 轉換率。
conversionRate

number

預測轉換率。
averageCpaMicros

string (int64 format)

平均單次轉換出價的計算方式如下：費用微型除以轉換次數。