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

条件 ID に関連付けられた調整因子です。設定した場合、この値を 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)

上限 CPC による入札の上限（マイクロ単位）。

{
  "dailyTargetSpendMicros": string
}

string (int64 format)

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

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

object (BiddableKeyword)

必須。予測時に広告グループで使用される単価調整可能なキーワードのリスト。少なくとも 1 つのキーワードが必要です。

object (KeywordInfo)

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

string (int64 format)

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

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

object (KeywordInfo)

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

string (int64 format)

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

{
  "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 ÷ コンバージョン数で計算されます。