Method: customers.generateReachForecast

특정 타겟팅 / 제품 조합에 대한 도달범위 예측을 생성합니다.

발생한 오류 목록: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError ReachPlanError RequestError

HTTP 요청

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateReachForecast

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 고객의 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "campaignDuration": {
    object (CampaignDuration)
  },
  "cookieFrequencyCapSetting": {
    object (FrequencyCap)
  },
  "targeting": {
    object (Targeting)
  },
  "plannedProducts": [
    {
      object (PlannedProduct)
    }
  ],
  "forecastMetricOptions": {
    object (ForecastMetricOptions)
  },
  "currencyCode": string,
  "cookieFrequencyCap": integer,
  "minEffectiveFrequency": integer,
  "effectiveFrequencyLimit": {
    object (EffectiveFrequencyLimit)
  },
  "customerReachGroup": string
}
입력란
campaignDuration

object (CampaignDuration)

필수 항목입니다. 캠페인 기간
cookieFrequencyCapSetting

object (FrequencyCap)

계획한 각 제품에 적용하기 위해 선택한 쿠키 게재빈도입니다. 캠페인을 만들 때 Google Ads에 노출되는 최대 게재빈도와 동일하며, 지정된 시간 간격 동안 동일한 사용자에게 광고가 게재될 수 있는 최대 횟수를 나타냅니다. 지정하지 않으면 기본값 0 (한도 없음)이 적용됩니다.

이 필드는 지원 중단된 cookieFrequencyCap 필드를 대체합니다.
targeting

object (Targeting)

제품 조합에서 선택한 모든 제품에 적용할 타겟팅입니다.

계획된 타겟팅입니다. 실행 세부정보는 광고 제품에 따라 다를 수 있으므로 구현 전문가에게 문의하세요.

타겟팅이 측정항목에 미치는 영향에 대한 자세한 내용은 특정 측정항목을 참조하세요.
plannedProducts[]

object (PlannedProduct)

필수 항목입니다. 예측할 제품입니다. 허용되는 최대 계획 제품 수는 15개입니다.
forecastMetricOptions

object (ForecastMetricOptions)

응답에서 반환된 예측 측정항목을 제어합니다.
currencyCode

string

통화 코드입니다. 3자리 ISO 4217 통화 코드입니다.
cookieFrequencyCap

integer

계획한 각 제품에 적용하기 위해 선택한 쿠키 게재빈도입니다. 캠페인을 만들 때 Google Ads에 표시되는 최대 게재빈도와 동일하며, 동일한 사용자에게 광고가 게재될 수 있는 최대 횟수를 나타냅니다. 지정하지 않으면 한도가 적용되지 않습니다.

이 필드는 v4에서 지원 중단되었으며 삭제될 예정입니다. 대신 cookieFrequencyCapSetting을 사용하세요.
minEffectiveFrequency

integer

보고된 도달범위 측정항목[1~10]에 대해 선택한 최소 유효 게재빈도 (사용자가 광고에 노출된 횟수)입니다. 타겟팅에는 영향을 주지 않고 보고에만 영향을 줍니다. 지정하지 않으면 기본값 1이 적용됩니다.

이 필드는 유효FrequencyLimit 필드와 결합할 수 없습니다.
effectiveFrequencyLimit

object (EffectiveFrequencyLimit)

Forecast.effective_frequency_breakdowns에 포함될 가장 높은 최소 유효 게재빈도 (사용자가 광고에 노출된 횟수) 값[1~10]. 지정하지 않으면 Forecast.effective_frequency_breakdowns가 제공되지 않습니다.

여기에 제공된 유효 게재빈도 값은 보고된 도달범위 측정항목의 최소 유효 게재빈도로도 사용됩니다.

이 필드는 minEffectiveFrequency 필드와 결합할 수 없습니다.
customerReachGroup

string

계획 중인 고객의 이름입니다. 사용자 정의 값입니다.

응답 본문

생성된 도달범위 곡선이 포함된 응답 메시지입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "onTargetAudienceMetrics": {
    object (OnTargetAudienceMetrics)
  },
  "reachCurve": {
    object (ReachCurve)
  }
}
입력란
onTargetAudienceMetrics

object (OnTargetAudienceMetrics)

이 곡선의 타겟층에 대한 참조입니다.
reachCurve

object (ReachCurve)

계획된 제품 조합에 대해 생성된 도달범위 곡선입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

CampaignDuration

계획한 캠페인의 기간입니다.

JSON 표현 
{
  "dateRange": {
    object (DateRange)
  },
  "durationInDays": integer
}
입력란
dateRange

object (DateRange)

캠페인의 기간입니다. 날짜는 yyyy-mm-dd 형식이며 여기에는 포함됩니다. 종료일은 향후 1년 미만이어야 하며 기간은 92일 이하여야 합니다.

이 필드는 durationInDays 필드와 결합할 수 없습니다.
durationInDays

integer

기간(일) 값입니다.

이 필드는 dateRange 필드와 함께 사용할 수 없습니다.

FrequencyCap

특정 기간 동안 광고가 사용자에게 게재될 수 있는 최대 횟수를 지정하는 규칙입니다.

JSON 표현 
{
  "impressions": integer,
  "timeUnit": enum (FrequencyCapTimeUnit)
}
입력란
impressions

integer

필수 항목입니다. 노출수(포함)입니다.
timeUnit

enum (FrequencyCapTimeUnit)

필수 항목입니다. 시간 단위의 유형입니다.

EffectiveFrequencyLimit

유효 게재빈도 제한입니다.

JSON 표현 
{
  "effectiveFrequencyBreakdownLimit": integer
}
입력란
effectiveFrequencyBreakdownLimit

integer

Forecast.effective_frequency_breakdowns에 포함될 가장 높은 유효 게재빈도 값입니다. 이 필드는 빈도 1~10을 지원합니다.

타겟팅

트래픽 측정항목이 보고되는 타겟팅입니다.

JSON 표현 
{
  "plannableLocationIds": [
    string
  ],
  "ageRange": enum (ReachPlanAgeRange),
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "network": enum (ReachPlanNetwork),
  "audienceTargeting": {
    object (AudienceTargeting)
  },
  "plannableLocationId": string
}
입력란
plannableLocationIds[]

string

이 예측으로 타겟팅할 계획 가능한 위치 ID의 목록입니다.

ID가 두 개 이상 제공된 경우 모든 ID의 parentCountryId가 동일해야 합니다. parent_county을(를) 초과하는 계획은 지원되지 않습니다. 계획 가능한 위치 ID와 parentCountryId는 ReachPlanService.ListPlannableLocations에서 가져올 수 있습니다.

요청에서 이 필드 또는 plannableLocationId를 설정해야 합니다.
ageRange

enum (ReachPlanAgeRange)

타겟 연령대 값을 설정하지 않으면 모든 연령을 타겟팅하는 것과 같습니다.
genders[]

object (GenderInfo)

타겟팅된 성별. 설정되지 않은 값은 MALE 및 FEMALE을 타겟팅하는 것과 동일합니다.
devices[]

object (DeviceInfo)

타겟팅된 기기 지정하지 않으면 모든 관련 기기를 타겟팅합니다. 해당하는 기기는 제품 및 지역에 따라 다르며 ReachPlanService.ListPlannableProducts에서 구매할 수 있습니다.
network

enum (ReachPlanNetwork)

광고 상품에 대해 타겟팅 가능한 네트워크입니다. 지정하지 않으면 적용 가능한 모든 네트워크를 타겟팅합니다. 사용 가능한 네트워크는 제품 및 지역에 따라 다르며 ReachPlanService.ListPlannableProducts에서 얻을 수 있습니다.
audienceTargeting

object (AudienceTargeting)

타겟 잠재고객 지정하지 않으면 특정 잠재고객을 타겟팅하지 않습니다.
plannableLocationId

string

선택한 위치의 ID입니다. 계획 가능한 위치 ID는 ReachPlanService.ListPlannableLocations에서 가져올 수 있습니다.

요청에서 이 필드 또는 plannableLocationIds를 설정해야 합니다.

이 필드는 V12부터 지원 중단되었으며 향후 출시에서 삭제될 예정입니다. 대신 plannableLocationIds를 사용하세요.

AudienceTargeting

도달범위 예측을 위한 잠재고객 타겟팅

JSON 표현 
{
  "userInterest": [
    {
      object (UserInterestInfo)
    }
  ]
}
입력란
userInterest[]

object (UserInterestInfo)

타겟팅할 사용자 관심분야를 기반으로 한 잠재고객 목록입니다.

PlannedProduct

도달범위를 위해 계획 중인 제품입니다.

JSON 표현 
{
  "advancedProductTargeting": {
    object (AdvancedProductTargeting)
  },
  "plannableProductCode": string,
  "budgetMicros": string
}
입력란
advancedProductTargeting

object (AdvancedProductTargeting)

선택한 제품의 타겟팅 설정입니다. 각 제품에 사용할 수 있는 타겟팅을 나열하려면 ReachPlanService.ListPlannableProducts를 사용하세요.
plannableProductCode

string

필수 항목입니다. 기획을 위해 선택된 제품 광고 제품과 연결된 코드 (예: TrueView, 범퍼)입니다. 사용 가능한 계획 가능 제품 코드를 나열하려면 ReachPlanService.ListPlannableProducts를 사용합니다.
budgetMicros

string (int64 format)

필수 항목입니다. 선택한 제품의 최대 예산 할당(단위: 마이크로 단위)입니다. 선택한 계획 currencyCode로 값이 지정됩니다. 예: 1 000 000$ = 1 000 000 000 000마이크로

AdvancedProductTargeting

제품의 고급 타겟팅 설정입니다.

JSON 표현 
{

  // Union field advanced_targeting can be only one of the following:
  "youtubeSelectSettings": {
    object (YouTubeSelectSettings)
  }
  // End of list of possible types for union field advanced_targeting.
}
입력란
통합 필드 advanced_targeting. 이 제품의 타겟팅 옵션입니다. advanced_targeting은 다음 중 하나여야 합니다.
youtubeSelectSettings

object (YouTubeSelectSettings)

YouTube Select 타겟팅 설정입니다.

YouTubeSelectSettings

YouTube Select 라인업 설정 요청

JSON 표현 
{
  "lineupId": string
}
입력란
lineupId

string (int64 format)

YouTube Select 타겟팅 라인업

ForecastMetricOptions

반환할 예측 측정항목을 제어합니다.

JSON 표현 
{
  "includeCoview": boolean
}
입력란
includeCoview

boolean

응답 예측에 공동 시청 측정항목을 포함할지 여부를 나타냅니다.

OnTargetAudienceMetrics

계획된 제품의 잠재고객 측정항목입니다. 이러한 측정항목은 다음 타겟팅 측정기준을 고려합니다.

  • 위치
  • PlannableAgeRange
  • 성별
  • Audience타겟팅 (youtubeAudienceSize 전용)
JSON 표현 
{
  "youtubeAudienceSize": string,
  "censusAudienceSize": string
}
입력란
youtubeAudienceSize

string (int64 format)

YouTube에 대해 고려되는 타겟팅과 일치하는 참조 잠재고객 규모입니다.
censusAudienceSize

string (int64 format)

인구조사 대상 타겟팅과 일치하는 참조 잠재고객 규모입니다.

ReachCurve

계획된 제품의 도달범위 곡선입니다.

JSON 표현 
{
  "reachForecasts": [
    {
      object (ReachForecast)
    }
  ]
}
입력란
reachForecasts[]

object (ReachForecast)

도달범위 곡선의 모든 지점입니다.

ReachForecast

도달범위 곡선의 한 지점입니다.

JSON 표현 
{
  "costMicros": string,
  "forecast": {
    object (Forecast)
  },
  "plannedProductReachForecasts": [
    {
      object (PlannedProductReachForecast)
    }
  ]
}
입력란
costMicros

string (int64 format)

마이크로 단위의 비용입니다.
forecast

object (Forecast)

이 지점의 예상 트래픽 측정항목입니다.
plannedProductReachForecasts[]

object (PlannedProductReachForecast)

도달범위 곡선의 이 지점부터 계획된 각 제품에 대한 예측 할당 및 트래픽 측정항목입니다.

예측

계획한 제품 및 타겟팅에 대한 예측 트래픽 측정항목입니다.

JSON 표현 
{
  "effectiveFrequencyBreakdowns": [
    {
      object (EffectiveFrequencyBreakdown)
    }
  ],
  "onTargetReach": string,
  "totalReach": string,
  "onTargetImpressions": string,
  "totalImpressions": string,
  "viewableImpressions": string,
  "onTargetCoviewReach": string,
  "totalCoviewReach": string,
  "onTargetCoviewImpressions": string,
  "totalCoviewImpressions": string
}
입력란
effectiveFrequencyBreakdowns[]

object (EffectiveFrequencyBreakdown)

유효 게재빈도 예측 목록입니다. 목록은 1+부터 시작하여 GenerateReachForecastRequest.effective_frequency_limit에 설정된 값으로 끝납니다. 유효빈도제한이 설정되지 않은 경우 이 목록은 비어 있게 됩니다.
onTargetReach

string (int64 format)

타겟팅과 정확히 일치하는 GenerateReachForecastRequest.min_effective_frequency 또는 GenerateReachForecastRequest.effective_frequency_limit회 이상에 도달한 순 사용자 수입니다.

데이터가 보고되려면 최소 순 사용자 수에 도달해야 합니다. 최소 개수를 충족하지 않으면 onTargetReach 값이 0으로 반올림됩니다.
totalReach

string (int64 format)

총 순 사용자 수가 GenerateReachForecastRequest.min_effective_frequency 또는 GenerateReachForecastRequest.effective_frequency_limit회 이상에 도달했습니다. 여기에는 지정된 타겟팅을 벗어날 수 있는 사용자가 포함됩니다.

데이터가 보고되려면 최소 순 사용자 수에 도달해야 합니다. 최소 개수를 충족하지 않으면 totalReach 값이 0으로 반올림됩니다.
onTargetImpressions

string (int64 format)

타겟팅과 정확하게 일치하는 광고 노출수입니다.
totalImpressions

string (int64 format)

총 광고 노출수입니다. 여기에는 로그인한 사용자에 대한 정보가 충분하지 않아 지정된 타겟팅을 벗어나는 노출이 포함됩니다.
viewableImpressions

string (int64 format)

광고 노출이 조회 가능으로 간주된 횟수입니다. https://support.google.com/google-ads/answer/7029393 페이지에서 광고를 조회 가능하게 만드는 요인과 조회가능성을 측정하는 방법을 자세히 알아보세요.
onTargetCoviewReach

string (int64 format)

공동 시청자를 포함하여 타겟팅과 정확하게 일치하는 도달한 순 사용자 수입니다.
totalCoviewReach

string (int64 format)

공동 시청자를 포함하여 도달한 순 사용자 수입니다. 여기에는 지정된 타겟팅을 벗어날 수 있는 사용자가 포함됩니다.
onTargetCoviewImpressions

string (int64 format)

공동 시청자를 포함하여 타겟팅과 정확하게 일치하는 광고 노출수입니다.
totalCoviewImpressions

string (int64 format)

공동 시청자를 포함한 총 광고 노출수입니다. 여기에는 로그인한 사용자에 대한 정보가 충분하지 않아 지정된 타겟팅을 벗어나는 노출이 포함됩니다.

EffectiveFrequencyBreakdown

지정된 유효 게재빈도로 도달한 순 사용자 수에 대한 분석입니다.

JSON 표현 
{
  "effectiveFrequency": integer,
  "onTargetReach": string,
  "totalReach": string,
  "effectiveCoviewReach": string,
  "onTargetEffectiveCoviewReach": string
}
입력란
effectiveFrequency

integer

유효 빈도 [1-10].
onTargetReach

string (int64 format)

최소 유효 게재빈도 시간에 도달한 순 사용자 수입니다. 타겟팅과 정확하게 일치하는 빈도입니다.

데이터가 보고되려면 최소 순 사용자 수에 도달해야 합니다. 최소 개수를 충족하지 않으면 onTargetReach 값이 0으로 반올림됩니다.
totalReach

string (int64 format)

최소 유효게재빈도 시간에 도달한 총 순 사용자 수입니다. 여기에는 지정된 타겟팅을 벗어날 수 있는 사용자가 포함됩니다.

데이터가 보고되려면 최소 순 사용자 수에 도달해야 합니다. 최소 개수를 충족하지 않으면 totalReach 값이 0으로 반올림됩니다.
effectiveCoviewReach

string (int64 format)

연결된 유효빈도 값에 도달한 사용자 (공동 시청 사용자 포함) 수입니다.
onTargetEffectiveCoviewReach

string (int64 format)

지정된 계획 인구통계 내에서 연결된 유효게재빈도 값에 도달한 사용자 (공동 시청 사용자 포함) 수입니다.

PlannedProductReachForecast

도달범위 곡선의 한 지점에서 특정 제품에 대한 예측 할당 및 트래픽 측정항목입니다.

JSON 표현 
{
  "plannableProductCode": string,
  "costMicros": string,
  "plannedProductForecast": {
    object (PlannedProductForecast)
  }
}
입력란
plannableProductCode

string

기획을 위해 선택된 제품 반환된 제품 코드는 동일한 위치 ID를 사용할 때 ListPlannableProducts에서 반환한 코드 세트 내에 있습니다.
costMicros

string (int64 format)

마이크로 단위의 비용입니다. 하나 이상의 계획된 제품이 제한된 인벤토리로 인해 예산을 충족할 수 없는 경우 제품의 입력 할당과 다를 수 있습니다.
plannedProductForecast

object (PlannedProductForecast)

이 제품의 예상 트래픽 측정항목입니다.

PlannedProductForecast

계획된 제품의 예측 트래픽 측정항목입니다.

JSON 표현 
{
  "onTargetReach": string,
  "totalReach": string,
  "onTargetImpressions": string,
  "totalImpressions": string,
  "viewableImpressions": string,
  "onTargetCoviewReach": string,
  "totalCoviewReach": string,
  "onTargetCoviewImpressions": string,
  "totalCoviewImpressions": string
}
입력란
onTargetReach

string (int64 format)

타겟팅과 정확하게 일치하는 도달한 순 사용자 수입니다.

데이터가 보고되려면 최소 순 사용자 수에 도달해야 합니다. 최소 개수를 충족하지 않으면 onTargetReach 값이 0으로 반올림됩니다.
totalReach

string (int64 format)

도달한 순 사용자 수입니다. 여기에는 지정된 타겟팅을 벗어날 수 있는 사용자가 포함됩니다.

데이터가 보고되려면 최소 순 사용자 수에 도달해야 합니다. 최소 개수를 충족하지 않으면 totalReach 값이 0으로 반올림됩니다.
onTargetImpressions

string (int64 format)

타겟팅과 정확하게 일치하는 광고 노출수입니다.
totalImpressions

string (int64 format)

총 광고 노출수입니다. 여기에는 로그인한 사용자에 대한 정보가 충분하지 않아 지정된 타겟팅을 벗어나는 노출이 포함됩니다.
viewableImpressions

string (int64 format)

광고 노출이 조회 가능으로 간주된 횟수입니다. https://support.google.com/google-ads/answer/7029393 페이지에서 광고를 조회 가능하게 만드는 요인과 조회가능성을 측정하는 방법을 자세히 알아보세요.
onTargetCoviewReach

string (int64 format)

공동 시청자를 포함하여 타겟팅과 정확하게 일치하는 도달한 순 사용자 수입니다.
totalCoviewReach

string (int64 format)

공동 시청자를 포함하여 도달한 순 사용자 수입니다. 여기에는 지정된 타겟팅을 벗어날 수 있는 사용자가 포함됩니다.
onTargetCoviewImpressions

string (int64 format)

공동 시청자를 포함하여 타겟팅과 정확하게 일치하는 광고 노출수입니다.
totalCoviewImpressions

string (int64 format)

공동 시청자를 포함한 총 광고 노출수입니다. 여기에는 로그인한 사용자에 대한 정보가 충분하지 않아 지정된 타겟팅을 벗어나는 노출이 포함됩니다.