Method: customers.generateKeywordForecastMetrics

지정된 캠페인에 대한 키워드 예측의 측정항목 (예: 노출수, 클릭수, 총 비용)을 표시합니다.

발생하는 오류 목록: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

HTTP 요청

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

URL은 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

criterionId의 관련 승수입니다. 설정할 경우 이 값은 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)

예측에 수동 CPC 입찰 전략을 사용합니다.
maximizeClicksBiddingStrategy

object (MaximizeClicksBiddingStrategy)

예측에 클릭수 최대화 입찰 전략을 사용합니다.
maximizeConversionsBiddingStrategy

object (MaximizeConversionsBiddingStrategy)

예측에 전환수 최대화 입찰 전략을 사용합니다.

ManualCpcBiddingStrategy

수동 CPC 입찰 전략

JSON 표현 
{
  "maxCpcBidMicros": string,
  "dailyBudgetMicros": string
}
입력란
maxCpcBidMicros

string (int64 format)

필수 항목입니다. 수동 CPC 입찰 전략에서 캠페인 내의 광고그룹에 적용되는 마이크로 단위의 입찰가입니다.
dailyBudgetMicros

string (int64 format)

마이크로 단위의 캠페인 수준 예산입니다. 설정된 경우 캠페인에 사용되는 현지 통화로 최소 금액이 적용됩니다. 이 필드가 너무 낮게 설정되면 최솟값을 표시하는 오류가 발생합니다.

MaximizeClicksBiddingStrategy

클릭수 최대화 입찰 전략을 사용합니다.

JSON 표현 
{
  "dailyTargetSpendMicros": string,
  "maxCpcBidCeilingMicros": string
}
입력란
dailyTargetSpendMicros

string (int64 format)

필수 항목입니다. 추정에 사용할 일일 목표 지출액입니다(단위: 마이크로 단위). 캠페인에서 사용되는 현지 통화로 최소 금액이 적용됩니다. 이 필드가 너무 낮게 설정되면 최솟값을 표시하는 오류가 발생합니다.
maxCpcBidCeilingMicros

string (int64 format)

마이크로 단위의 최대 CPC 입찰가 상한

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)

예측 트래픽을 생성할 때 광고그룹에 사용할 최대 CPC입니다. 이 값은 입찰 전략에 설정된 최대 CPC 값보다 우선 적용됩니다. 최대 CPC 값을 사용하는 입찰 전략에만 이 입력란을 지정하세요.

BiddableKeyword

광고그룹의 입찰 가능한 키워드 부분입니다.

JSON 표현 
{
  "keyword": {
    object (KeywordInfo)
  },
  "maxCpcBidMicros": string
}
입력란
keyword

object (KeywordInfo)

필수 항목입니다. 키워드 텍스트와 일치 유형이 있어야 합니다.
maxCpcBidMicros

string (int64 format)

예측 시뮬레이션에서 광고그룹 수준의 최대 CPC 입찰가보다 우선하는 마이크로 단위의 최대 CPC 입찰가입니다. 이 값은 입찰 전략 및 광고그룹에 설정된 최대 CPC 값보다 우선 적용됩니다. 최대 CPC 값을 지원하는 입찰 전략에만 이 입력란을 지정하세요.

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)

평균 CPC입니다. 클릭수가 0보다 큰 경우에만 사용할 수 있습니다.
clicks

number

총 클릭수입니다.
costMicros

string (int64 format)

총 비용입니다.
conversions

number

예상 전환수: 클릭수 * conversionRate
conversionRate

number

예상 전환율입니다.
averageCpaMicros

string (int64 format)

평균 전환당비용은 costMicros / 전환수로 계산됩니다.