---
title: "POST /v23/customers/{+customerId}:generateKeywordForecastMetrics"
method: POST
path: "/v23/customers/{+customerId}:generateKeywordForecastMetrics"
tags: ["customers"]
---

# POST /v23/customers/{+customerId}:generateKeywordForecastMetrics

`POST /v23/customers/{+customerId}:generateKeywordForecastMetrics`

Returns metrics (such as impressions, clicks, total cost) of a keyword forecast for the given campaign. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [CollectionSizeError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]()

## Path parameters

- `customerId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesGenerateKeywordForecastMetricsRequest — Request message for KeywordPlanIdeaService.GenerateKeywordForecastMetrics.
  - `forecastPeriod` GoogleAdsSearchads360V23CommonDateRange — A date range.
    - `startDate` string — The start date, in yyyy-mm-dd format. This date is inclusive.
    - `endDate` string — The end date, in yyyy-mm-dd format. This date is inclusive.
  - `campaign` GoogleAdsSearchads360V23ServicesCampaignToForecast — A campaign to do a keyword campaign forecast.
    - `biddingStrategy` GoogleAdsSearchads360V23ServicesCampaignToForecastCampaignBiddingStrategy — Supported bidding strategies for new campaign forecasts.
      - `maximizeClicksBiddingStrategy` GoogleAdsSearchads360V23ServicesMaximizeClicksBiddingStrategy — Maximize Clicks Bidding Strategy.
        - `dailyTargetSpendMicros` string, int64 — Required. The daily target spend in micros to be used for estimation. A minimum value is enforced for the local currency used in the campaign. An error will occur showing the minimum value if this field is set too low.
        - `maxCpcBidCeilingMicros` string, int64 — Ceiling on max CPC bids in micros.
      - `manualCpcBiddingStrategy` GoogleAdsSearchads360V23ServicesManualCpcBiddingStrategy — Manual CPC Bidding Strategy.
        - `dailyBudgetMicros` string, int64 — Campaign level budget in micros. If set, a minimum value is enforced for the local currency used in the campaign. An error will occur showing the minimum value if this field is set too low.
        - `maxCpcBidMicros` string, int64 — Required. A bid in micros to be applied to ad groups within the campaign for a manual CPC bidding strategy.
      - `maximizeConversionsBiddingStrategy` GoogleAdsSearchads360V23ServicesMaximizeConversionsBiddingStrategy — Maximize Conversions Bidding Strategy.
        - `dailyTargetSpendMicros` string, int64 — Required. The daily target spend in micros to be used for estimation. This value must be greater than zero.
    - `languageConstants` string[] — The list of resource names of languages to be targeted. The resource name is of the format "languageConstants/{criterion_id}". See https://developers.google.com/google-ads/api/data/codes-formats#languages for the list of language criterion codes.
    - `keywordPlanNetwork` 'UNSPECIFIED' | 'UNKNOWN' | 'GOOGLE_SEARCH' | 'GOOGLE_SEARCH_AND_PARTNERS' — Required. The network used for targeting.
    - `adGroups` GoogleAdsSearchads360V23ServicesForecastAdGroup[] — The ad groups in the new campaign to forecast.
      - `maxCpcBidMicros` string, int64 — The max cpc to use for the ad group when generating forecasted traffic. This value will override the max cpc value set in the bidding strategy. Only specify this field for bidding strategies that max cpc values.
      - `biddableKeywords` GoogleAdsSearchads360V23ServicesBiddableKeyword[] — Required. The list of biddable keywords to be used in the ad group when doing the forecast. Requires at least one keyword.
        - `keyword` GoogleAdsSearchads360V23CommonKeywordInfo — A keyword criterion.
          - `text` string — The text of the keyword (at most 80 characters and 10 words).
          - `matchType` 'UNSPECIFIED' | 'UNKNOWN' | 'EXACT' | 'PHRASE' | 'BROAD' — The match type of the keyword.
        - `maxCpcBidMicros` string, int64 — A max cpc bid in micros that overrides the ad group level max cpc bid in forecast simulation. This value will override the max cpc value set in the bidding strategy and ad group. Only specify this field for bidding strategies that support max cpc values.
      - `negativeKeywords` GoogleAdsSearchads360V23CommonKeywordInfo[] — The details of the keyword. You should specify both the keyword text and match type.
        - `text` string — The text of the keyword (at most 80 characters and 10 words).
        - `matchType` 'UNSPECIFIED' | 'UNKNOWN' | 'EXACT' | 'PHRASE' | 'BROAD' — The match type of the keyword.
    - `geoModifiers` GoogleAdsSearchads360V23ServicesCriterionBidModifier[] — Locations to be targeted. Locations must be unique.
      - `bidModifier` number, double — The associated multiplier for the criterion_id. If set, this value cannot be 0.
      - `geoTargetConstant` string — The resource name of the geo location to target. The resource name is of the format "geoTargetConstants/{criterion_id}".
    - `negativeKeywords` GoogleAdsSearchads360V23CommonKeywordInfo[] — The list of negative keywords to be used in the campaign when doing the forecast.
      - `text` string — The text of the keyword (at most 80 characters and 10 words).
      - `matchType` 'UNSPECIFIED' | 'UNKNOWN' | 'EXACT' | 'PHRASE' | 'BROAD' — The match type of the keyword.
    - `conversionRate` number, double — The expected conversion rate (number of conversions divided by number of total clicks) as defined by the user. This value is expressed as a decimal value, so an expected conversion rate of 2% should be entered as 0.02. If left empty, an estimated conversion rate will be used.
  - `currencyCode` string — The currency used for exchange rate conversion. By default, the account currency of the customer is used. Set this field only if the currency is different from the account currency. The list of valid currency codes can be found at https://developers.google.com/google-ads/api/data/codes-formats#currency-codes.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/searchads360.md) · [All operations](https://skmtc.net/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/searchads360/versions/40d087435afd/schema)