Method: customers.generateKeywordForecastMetrics

string

顧客の ID。

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

string

ターゲットとする言語のリソース名のリストです。リソース名の形式は「languageConstants/{CriterionId}」です。言語の条件コードのリストについては、https://developers.google.com/google-ads/api/data/codes-formats#languages をご覧ください。

object (CriterionBidModifier)

ターゲットに設定する地域です。ロケーションは一意である必要があります。

enum (KeywordPlanNetwork)

必須。ターゲティングに使用されるネットワーク。

object (KeywordInfo)

予測を行う際にキャンペーンで使用される除外キーワードのリスト。

object (CampaignBiddingStrategy)

必須。キャンペーンの入札戦略です。

object (ForecastAdGroup)

予測する新しいキャンペーンの広告グループです。

number

ユーザーが定義した推定コンバージョン率（コンバージョン数を合計クリック数で割った値）。この値は 10 進数で表現されるため、推定コンバージョン率の 2% は 0.02 と入力する必要があります。空白のままにすると、推定コンバージョン率が使用されます。

{
  "geoTargetConstant": string,
  "bidModifier": number
}

string

ターゲットとする地域のリソース名です。リソース名の形式は「geoTargetConstants/{CriterionId}」です。

number

CriterionId に関連付けられた調整因子です。設定する場合、この値を 0 にすることはできません。

{

  // 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.
}

object (ManualCpcBiddingStrategy)

予測には個別クリック単価制入札戦略を使用する。

object (MaximizeClicksBiddingStrategy)

予測には「クリック数の最大化」入札戦略を使用する。

object (MaximizeConversionsBiddingStrategy)

予測には「コンバージョン数の最大化」入札戦略を使用する。

{
  "maxCpcBidMicros": string,
  "dailyBudgetMicros": string
}

string (int64 format)

必須。個別クリック単価制入札戦略のキャンペーン内の広告グループに適用する入札単価（マイクロ単位）。

string (int64 format)

キャンペーン単位の予算（マイクロ単位）。設定すると、キャンペーンで使用される現地通貨の最小値が適用されます。このフィールドの設定が低すぎると、最小値を示すエラーが発生します。

{
  "dailyTargetSpendMicros": string,
  "maxCpcBidCeilingMicros": string
}

string (int64 format)

必須。見積もりに使用する 1 日の目標予算（マイクロ単位）。最小値は、キャンペーンで使用されている現地通貨で適用されます。このフィールドの設定が低すぎると、最小値を示すエラーが発生します。

string (int64 format)

上限クリック単価（マイクロ単位）の上限。

{
  "dailyTargetSpendMicros": string
}

string (int64 format)

必須。見積もりに使用する 1 日の目標予算（マイクロ単位）。この値は 0 よりも大きくする必要があります。

{
  "biddableKeywords": [
    {
      object (BiddableKeyword)
    }
  ],
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "maxCpcBidMicros": string
}

object (BiddableKeyword)

必須。予測を行う際に広告グループで使用される、入札可能なキーワードのリスト。少なくとも 1 つのキーワードが必要です。

object (KeywordInfo)

キーワードの詳細。キーワードのテキストとマッチタイプの両方を指定してください。

string (int64 format)

予測トラフィックの生成時に広告グループで使用する上限クリック単価です。この値は、入札戦略で設定された上限クリック単価よりも優先されます。このフィールドは、クリック単価値を上限とする入札戦略の場合にのみ指定します。

{
  "keyword": {
    object (KeywordInfo)
  },
  "maxCpcBidMicros": string
}

object (KeywordInfo)

必須。キーワード。テキストとマッチタイプが必要です。

string (int64 format)

予測シミュレーションで広告グループ単位の上限クリック単価を上書きする、上限クリック単価（マイクロ単位）です。この値は、入札戦略と広告グループで設定された上限クリック単価の値よりも優先されます。このフィールドは、上限クリック単価の値に対応している入札戦略の場合にのみ指定します。

{
  "impressions": number,
  "clickThroughRate": number,
  "averageCpcMicros": string,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionRate": number,
  "averageCpaMicros": string
}

number

インプレッションの合計数。

number

平均クリック率。インプレッション数 > 0 の場合にのみ使用できます。

string (int64 format)

平均クリック単価。クリック数 > 0 の場合にのみ使用できます。

number

クリックの総数。

string (int64 format)

合計費用。

number

予測コンバージョン数（クリック数 × コンバージョン率）で算出されます。

number

予測コンバージョン率。

string (int64 format)

平均コンバージョン単価は、costMicros ÷ コンバージョン数で算出されます。