Method: advertisers.reachForecast.generateReachForecast

특정 광고주 및 타겟팅 구성의 도달범위 예측을 생성합니다.

HTTP 요청

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:generateReachForecast

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

경로 매개변수

매개변수
advertiserId

string (int64 format)

필수 항목입니다. 계획된 캠페인을 운영할 광고주의 ID입니다.

요청 본문

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

JSON 표현 
{
  "targeting": {
    object (Targeting)
  },
  "campaignDuration": {
    object (CampaignDuration)
  },
  "currencyCode": string,
  "plannedProducts": [
    {
      object (PlannedProduct)
    }
  ],
  "minEffectiveFrequency": integer
}
필드
targeting

object (Targeting)

필수 항목입니다. 계획된 캠페인의 타겟팅 매개변수입니다.
campaignDuration

object (CampaignDuration)

필수 항목입니다. 계획된 캠페인의 기간입니다.
currencyCode

string

필수 항목입니다. 요금제의 통화 코드입니다(ISO 4217 형식).
plannedProducts[]

object (PlannedProduct)

필수 항목입니다. 예측에 포함할 광고 항목 목록입니다.
minEffectiveFrequency

integer

선택사항입니다. 보고된 도달범위 측정항목의 최소 유효 게재빈도입니다. 광고가 효과적인 것으로 간주되기 위해 고객이 광고에 노출되어야 하는 최소 횟수입니다. 이 설정은 보고에만 영향을 미칩니다.

1 이상 10 이하여야 합니다. 지정하지 않으면 기본값 1이 적용됩니다.

응답 본문

ReachForecastService.GenerateReachForecast의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "onTargetAudienceMetrics": {
    object (OnTargetAudienceMetrics)
  },
  "reachCurve": {
    object (ReachCurve)
  }
}
필드
onTargetAudienceMetrics

object (OnTargetAudienceMetrics)

타겟팅된 지역의 예상 잠재고객 규모입니다.
reachCurve

object (ReachCurve)

생성된 예측 곡선입니다.

승인 범위

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

  • https://www.googleapis.com/auth/display-video

자세한 내용은 OAuth 2.0 Overview를 참조하세요.

타겟팅

계획된 캠페인의 타겟팅 설정입니다.

JSON 표현 
{
  "plannableLocationIds": [
    string
  ],
  "ageRange": enum (PlannableAgeRange),
  "genders": [
    enum (Gender)
  ],
  "devices": [
    enum (DeviceType)
  ]
}
필드
plannableLocationIds[]

string (int64 format)

필수 항목입니다. 타겟팅할 계획 가능한 위치의 ID입니다.

계획 가능한 위치는 reachForecast.retrievePlannableLocations 메서드를 사용하여 가져올 수 있습니다.
ageRange

enum (PlannableAgeRange)

선택사항입니다. 타겟팅할 연령대입니다.
genders[]

enum (Gender)

선택사항입니다. 타겟팅할 성별 옵션입니다.
devices[]

enum (DeviceType)

선택사항입니다. 타겟팅할 기기입니다.

CampaignDuration

도달범위 계획의 기간입니다.

JSON 표현 
{

  // Union field duration can be only one of the following:
  "durationDays": integer,
  "dateRange": {
    object (DateRange)
  }
  // End of list of possible types for union field duration.
}
필드
통합 필드 duration. 캠페인 기간 선택 duration은 다음 중 하나여야 합니다.
durationDays

integer

필수 항목입니다. 요금제가 적용되는 일수입니다.
dateRange

object (DateRange)

필수 항목입니다. 계획이 적용되는 기간입니다.

PlannedProduct

요금제의 특정 제품 구성입니다.

JSON 표현 
{
  "plannableProductCode": string,
  "budgetMicros": string,
  "advancedProductTargeting": {
    object (AdvancedProductTargeting)
  }
}
필드
plannableProductCode

string

필수 항목입니다. 제품의 코드입니다(예: 'VIDEO_REACH_CAMPAIGN').
budgetMicros

string (int64 format)

필수 항목입니다. 이 제품의 예산입니다(마이크로 단위).
advancedProductTargeting

object (AdvancedProductTargeting)

선택사항입니다. 선택사항인 광고 항목 수준 타겟팅 재정의입니다.

AdvancedProductTargeting

제품별 타겟팅 재정의입니다.

JSON 표현 
{
  "surfaceTargetingSettings": {
    object (SurfaceTargetingSettings)
  },
  "targetFrequency": {
    object (TargetFrequency)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "ageRange": enum (PlannableAgeRange),
  "genders": [
    enum (Gender)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "userInterestIds": [
    string
  ],
  "userListIds": [
    string
  ],
  "youtubeSelectSettings": {
    object (YouTubeSelectSettings)
  },
  "dateRange": {
    object (DateRange)
  },
  "plannableLocationIds": [
    string
  ],
  "network": enum (PlannableNetwork)
}
필드
surfaceTargetingSettings

object (SurfaceTargetingSettings)

선택사항입니다. 타겟팅할 수 있는 계획 가능한 표시 경로입니다.
targetFrequency

object (TargetFrequency)

선택사항입니다. 일정 기간 동안 동일한 사용자에게 광고가 게재되는 평균 횟수입니다.
frequencyCap

object (FrequencyCap)

선택사항입니다. 특정 제품의 최대 게재빈도입니다.
ageRange

enum (PlannableAgeRange)

선택사항입니다. 타겟팅할 연령대입니다.
genders[]

enum (Gender)

선택사항입니다. 타겟팅할 성별 옵션입니다.
devices[]

enum (DeviceType)

선택사항입니다. 타겟팅할 기기입니다.
userInterestIds[]

string

선택사항입니다. 타겟팅할 사용자 관심분야 ID입니다.

계획 가능한 사용자 관심분야는 reachForecast.retrievePlannableUserInterests 메서드를 사용하여 가져올 수 있습니다.
userListIds[]

string

선택사항입니다. 타겟팅할 사용자 목록 ID입니다.

계획 가능한 사용자 목록은 reachForecast.retrievePlannableUserInterests 메서드를 사용하여 가져올 수 있습니다.
youtubeSelectSettings

object (YouTubeSelectSettings)

선택사항입니다. YouTube Select 설정
dateRange

object (DateRange)

선택사항입니다. 타겟팅할 기간입니다.
plannableLocationIds[]

string (int64 format)

선택사항입니다. 타겟팅할 계획 가능한 위치 ID입니다.
network

enum (PlannableNetwork)

선택사항입니다. 타겟팅할 네트워크입니다.

SurfaceTargetingSettings

표면 타겟팅 선택

JSON 표현 
{
  "surfaces": [
    enum (PlannableSurface)
  ]
}
필드
surfaces[]

enum (PlannableSurface)

선택사항입니다. 타겟팅할 표시 경로입니다.

YouTubeSelectSettings

YouTube Select 라인업 설정입니다.

JSON 표현 
{
  "lineupId": string
}
필드
lineupId

string (int64 format)

선택사항입니다. YouTube Select 라인업의 ID입니다.

OnTargetAudienceMetrics

타겟팅된 지역의 예상 잠재고객 규모입니다.

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,
  "plannedProductReachForecasts": [
    {
      object (PlannedProductReachForecast)
    }
  ],
  "forecast": {
    object (PlannedProductForecast)
  }
}
필드
costMicros

string (int64 format)

이 지점의 총비용(마이크로 단위)입니다.
plannedProductReachForecasts[]

object (PlannedProductReachForecast)

이 비용 지점에서의 개별 제품 분류입니다.
forecast

object (PlannedProductForecast)

전체 계획의 집계 예측입니다.

PlannedProductReachForecast

특정 제품의 실적 예측입니다.

JSON 표현 
{
  "costMicros": string,
  "plannableProductCode": string,
  "plannedProductForecast": {
    object (PlannedProductForecast)
  }
}
필드
costMicros

string (int64 format)

이 제품의 비용(단위: 1백만 분의 1)입니다.
plannableProductCode

string

제품의 코드입니다.
plannedProductForecast

object (PlannedProductForecast)

제품의 실적 측정항목입니다.

PlannedProductForecast

예측 지점의 성능 측정항목입니다.

JSON 표현 
{
  "onTargetReach": string,
  "onTargetImpressions": string,
  "trueviewViews": string,
  "totalReach": string,
  "totalImpressions": string,
  "viewableImpressions": string,
  "onTargetCoviewReach": string,
  "totalCoviewReach": string,
  "onTargetCoviewImpressions": string,
  "totalCoviewImpressions": string
}
필드
onTargetReach

string (int64 format)

타겟 정의와 일치하는 도달한 순 사용자 수입니다.
onTargetImpressions

string (int64 format)

타겟층 노출수입니다.
trueviewViews

string (int64 format)

TrueView 조회수입니다.
totalReach

string (int64 format)

도달한 총 순 사용자 수입니다.
totalImpressions

string (int64 format)

총 노출수입니다.
viewableImpressions

string (int64 format)

조회 가능 노출수
onTargetCoviewReach

string (int64 format)

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

string (int64 format)

공동 시청자를 포함하여 도달한 전체 순 사용자 수입니다.
onTargetCoviewImpressions

string (int64 format)

공동 시청자를 포함한 타겟층 노출수입니다.
totalCoviewImpressions

string (int64 format)

공동 시청자를 포함한 총 노출수입니다.