REST Resource: targetingTypes.targetingOptions

리소스: targetingOption

DV360에서 타겟팅할 수 있는 개념인 단일 타겟팅 옵션을 나타냅니다.

JSON 표현 
{
  "name": string,
  "targetingOptionId": string,
  "targetingType": enum (TargetingType),

  // Union field details can be only one of the following:
  "digitalContentLabelDetails": {
    object (DigitalContentLabelTargetingOptionDetails)
  },
  "sensitiveCategoryDetails": {
    object (SensitiveCategoryTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
필드
name

string

출력 전용. 이 타겟팅 옵션의 리소스 이름입니다.
targetingOptionId

string

출력 전용. 이 타겟팅 옵션의 고유 식별자입니다. {targetingType, targetingOptionId} 튜플은 고유합니다.
targetingType

enum (TargetingType)

출력 전용. 이 타겟팅 옵션의 유형입니다.
통합 필드 details. 타겟팅 옵션에 대한 자세한 정보입니다. 세부정보에서 하나의 필드만 작성할 수 있으며 targeting_type에 해당해야 합니다. details는 다음 중 하나여야 합니다.
digitalContentLabelDetails

object (DigitalContentLabelTargetingOptionDetails)

디지털 콘텐츠 라벨 세부정보
sensitiveCategoryDetails

object (SensitiveCategoryTargetingOptionDetails)

민감한 카테고리 세부정보
appCategoryDetails

object (AppCategoryTargetingOptionDetails)

앱 카테고리 세부정보입니다.
onScreenPositionDetails

object (OnScreenPositionTargetingOptionDetails)

화면 위치 세부정보
contentOutstreamPositionDetails

object (ContentOutstreamPositionTargetingOptionDetails)

콘텐츠 아웃스트림 위치 세부정보
contentInstreamPositionDetails

object (ContentInstreamPositionTargetingOptionDetails)

콘텐츠 인스트림 게재위치 세부정보입니다.
videoPlayerSizeDetails

object (VideoPlayerSizeTargetingOptionDetails)

동영상 플레이어 크기 세부정보입니다.
ageRangeDetails

object (AgeRangeTargetingOptionDetails)

연령대 세부정보입니다.
parentalStatusDetails

object (ParentalStatusTargetingOptionDetails)

자녀 유무 세부정보
userRewardedContentDetails

object (UserRewardedContentTargetingOptionDetails)

사용자 보상형 콘텐츠 세부정보입니다.
householdIncomeDetails

object (HouseholdIncomeTargetingOptionDetails)

가구 소득 세부정보입니다.
genderDetails

object (GenderTargetingOptionDetails)

성별 세부정보
deviceTypeDetails

object (DeviceTypeTargetingOptionDetails)

기기 유형 세부정보입니다.
browserDetails

object (BrowserTargetingOptionDetails)

브라우저 세부정보입니다.
carrierAndIspDetails

object (CarrierAndIspTargetingOptionDetails)

이동통신사 및 ISP 세부정보
environmentDetails

object (EnvironmentTargetingOptionDetails)

환경 세부정보입니다.
operatingSystemDetails

object (OperatingSystemTargetingOptionDetails)

운영체제 리소스 세부정보입니다.
deviceMakeModelDetails

object (DeviceMakeModelTargetingOptionDetails)

기기 제조업체 및 모델 리소스 세부정보입니다.
viewabilityDetails

object (ViewabilityTargetingOptionDetails)

조회가능성 리소스 세부정보입니다.
categoryDetails

object (CategoryTargetingOptionDetails)

카테고리 리소스 세부정보입니다.
languageDetails

object (LanguageTargetingOptionDetails)

언어 리소스 세부정보입니다.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusTargetingOptionDetails)

승인된 판매자 상태 리소스 세부정보입니다.
geoRegionDetails

object (GeoRegionTargetingOptionDetails)

지리적 리전 리소스 세부정보입니다.
exchangeDetails

object (ExchangeTargetingOptionDetails)

거래소 세부정보
subExchangeDetails

object (SubExchangeTargetingOptionDetails)

하위 거래소 세부정보
poiDetails

object (PoiTargetingOptionDetails)

관심 장소 리소스 세부정보입니다.
businessChainDetails

object (BusinessChainTargetingOptionDetails)

비즈니스 체인 리소스 세부정보
contentDurationDetails

object (ContentDurationTargetingOptionDetails)

콘텐츠 길이 리소스 세부정보입니다.
contentStreamTypeDetails

object (ContentStreamTypeTargetingOptionDetails)

콘텐츠 스트림 유형 리소스 세부정보
nativeContentPositionDetails

object (NativeContentPositionTargetingOptionDetails)

네이티브 콘텐츠 게재순위 세부정보
omidDetails

object (OmidTargetingOptionDetails)

Open Measurement가 사용 설정된 인벤토리 세부정보
audioContentTypeDetails

object (AudioContentTypeTargetingOptionDetails)

오디오 콘텐츠 유형 세부정보입니다.
contentGenreDetails

object (ContentGenreTargetingOptionDetails)

콘텐츠 장르 리소스 세부정보입니다.

DigitalContentLabelTargetingOptionDetails

타겟팅할 수 있는 디지털 콘텐츠 라벨 등급 등급을 나타냅니다. targetingType가 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION이면 타겟팅 옵션의 digitalContentLabelDetails 필드에 채워집니다.

JSON 표현 
{
  "contentRatingTier": enum (ContentRatingTier)
}
필드
contentRatingTier

enum (ContentRatingTier)

출력 전용. 콘텐츠 라벨 브랜드 안전성 등급의 열거형입니다.

SensitiveCategoryTargetingOptionDetails

타겟팅할 수 있는 민감한 카테고리를 나타냅니다. targetingType가 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION이면 타겟팅 옵션의 sensitiveCategoryDetails 필드에 채워집니다.

JSON 표현 
{
  "sensitiveCategory": enum (SensitiveCategory)
}
필드
sensitiveCategory

enum (SensitiveCategory)

출력 전용. DV360 민감한 카테고리 콘텐츠 분류 기준에 대한 열거형입니다.

AppCategoryTargetingOptionDetails

타겟팅할 수 있는 앱 컬렉션을 나타냅니다. 컬렉션을 사용하면 플랫폼에서 유지관리하는 관련 앱의 동적 그룹을 타겟팅할 수 있습니다(예: All Apps/Google Play/Games). targetingType가 TARGETING_TYPE_APP_CATEGORY이면 appCategoryDetails 필드에 채워집니다.

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

string

출력 전용. 앱 컬렉션의 이름입니다.

OnScreenPositionTargetingOptionDetails

디스플레이 및 동영상 광고에서 사용할 수 있는 타겟 화면 위치를 나타냅니다. targetingType가 TARGETING_TYPE_ON_SCREEN_POSITION이면 onScreenPositionDetails 필드에 채워집니다.

JSON 표현 
{
  "onScreenPosition": enum (OnScreenPosition)
}
필드
onScreenPosition

enum (OnScreenPosition)

출력 전용. 화면의 위치입니다.

ContentOutstreamPositionTargetingOptionDetails

디스플레이 및 동영상 광고에서 사용할 수 있는 타겟팅 가능한 콘텐츠 아웃스트림 위치를 나타냅니다. targetingType가 TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION이면 contentOutstreamPositionDetails 필드에 채워집니다.

JSON 표현 
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition)
}
필드
contentOutstreamPosition

enum (ContentOutstreamPosition)

출력 전용. 콘텐츠 아웃스트림 위치입니다.

ContentInstreamPositionTargetingOptionDetails

동영상 및 오디오 광고에서 사용할 수 있는 타겟팅 가능한 콘텐츠 인스트림 위치를 나타냅니다. targetingType가 TARGETING_TYPE_CONTENT_INSTREAM_POSITION이면 contentInstreamPositionDetails 필드에 채워집니다.

JSON 표현 
{
  "contentInstreamPosition": enum (ContentInstreamPosition)
}
필드
contentInstreamPosition

enum (ContentInstreamPosition)

출력 전용. 콘텐츠 인스트림 위치입니다.

VideoPlayerSizeTargetingOptionDetails

타겟팅할 수 있는 동영상 플레이어 크기를 나타냅니다. targetingType가 TARGETING_TYPE_VIDEO_PLAYER_SIZE이면 videoPlayerSizeDetails 필드에 채워집니다.

JSON 표현 
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
필드
videoPlayerSize

enum (VideoPlayerSize)

출력 전용. 동영상 플레이어 크기입니다.

AgeRangeTargetingOptionDetails

타겟팅 가능한 연령대를 나타냅니다. targetingType가 TARGETING_TYPE_AGE_RANGE이면 ageRangeDetails 필드에 채워집니다.

JSON 표현 
{
  "ageRange": enum (AgeRange)
}
필드
ageRange

enum (AgeRange)

출력 전용. 잠재고객의 연령대입니다.

ParentalStatusTargetingOptionDetails

타겟팅할 수 있는 자녀 유무를 나타냅니다. targetingType가 TARGETING_TYPE_PARENTAL_STATUS이면 타겟팅 옵션의 parentalStatusDetails 필드에 채워집니다.

JSON 표현 
{
  "parentalStatus": enum (ParentalStatus)
}
필드
parentalStatus

enum (ParentalStatus)

출력 전용. 잠재고객의 자녀 유무입니다.

UserRewardedContentTargetingOptionDetails

동영상 광고 전용으로 타겟팅 가능한 사용자 보상형 콘텐츠 상태를 나타냅니다. targetingType가 TARGETING_TYPE_USER_REWARDED_CONTENT이면 userRewardedContentDetails 필드에 채워집니다.

JSON 표현 
{
  "userRewardedContent": enum (UserRewardedContent)
}
필드
userRewardedContent

enum (UserRewardedContent)

출력 전용. 동영상 광고의 사용자 보상형 콘텐츠 상태입니다.

HouseholdIncomeTargetingOptionDetails

타겟팅할 수 있는 가계 소득을 나타냅니다. targetingType가 TARGETING_TYPE_HOUSEHOLD_INCOME이면 타겟팅 옵션의 householdIncomeDetails 필드에 채워집니다.

JSON 표현 
{
  "householdIncome": enum (HouseholdIncome)
}
필드
householdIncome

enum (HouseholdIncome)

출력 전용. 잠재고객의 가계 소득입니다.

GenderTargetingOptionDetails

타겟팅 가능한 성별을 나타냅니다. targetingType가 TARGETING_TYPE_GENDER이면 타겟팅 옵션의 genderDetails 필드에 채워집니다.

JSON 표현 
{
  "gender": enum (Gender)
}
필드
gender

enum (Gender)

출력 전용. 잠재고객의 성별입니다.

DeviceTypeTargetingOptionDetails

타겟팅 가능한 기기 유형을 나타냅니다. targetingType가 TARGETING_TYPE_DEVICE_TYPE이면 타겟팅 옵션의 deviceTypeDetails 필드에 채워집니다.

JSON 표현 
{
  "deviceType": enum (DeviceType)
}
필드
deviceType

enum (DeviceType)

출력 전용. 타겟팅되는 데 사용되는 기기 유형입니다.

BrowserTargetingOptionDetails

타겟팅할 수 있는 브라우저를 나타냅니다. targetingType가 TARGETING_TYPE_BROWSER이면 browserDetails 필드에 채워집니다.

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

string

출력 전용. 브라우저의 표시 이름입니다.

CarrierAndIspTargetingOptionDetails

타겟팅할 수 있는 이동통신사 또는 ISP를 나타냅니다. targetingType가 TARGETING_TYPE_CARRIER_AND_ISP이면 타겟팅 옵션의 carrierAndIspDetails 필드에 채워집니다.

JSON 표현 
{
  "displayName": string,
  "type": enum (CarrierAndIspType)
}
필드
displayName

string

출력 전용. 이동통신사 또는 ISP의 표시 이름입니다.
type

enum (CarrierAndIspType)

출력 전용. 이동통신사 또는 ISP인지 여부를 나타내는 유형입니다.

CarrierAndIspType

CarrierAndIsptargetingOption의 유형입니다.

열거형
CARRIER_AND_ISP_TYPE_UNSPECIFIED 이 버전에서 유형이 지정되지 않았거나 알 수 없는 경우의 기본값입니다.
CARRIER_AND_ISP_TYPE_ISP 이 타겟팅 리소스가 ISP를 참조함을 나타냅니다.
CARRIER_AND_ISP_TYPE_CARRIER 이 타겟팅 리소스가 이동통신사를 참조함을 나타냅니다.

EnvironmentTargetingOptionDetails

타겟팅 가능한 환경을 나타냅니다. targetingType가 TARGETING_TYPE_ENVIRONMENT이면 타겟팅 옵션의 environmentDetails 필드에 채워집니다.

JSON 표현 
{
  "environment": enum (Environment)
}
필드
environment

enum (Environment)

출력 전용. 게재 환경입니다.

OperatingSystemTargetingOptionDetails

타겟팅할 수 있는 운영체제를 나타냅니다. targetingType가 TARGETING_TYPE_OPERATING_SYSTEM이면 타겟팅 옵션의 operatingSystemDetails 필드에 채워집니다.

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

string

출력 전용. 운영체제의 표시 이름입니다.

DeviceMakeModelTargetingOptionDetails

타겟팅할 수 있는 기기 제조업체 및 모델을 나타냅니다. targetingType가 TARGETING_TYPE_DEVICE_MAKE_MODEL이면 타겟팅 옵션의 deviceMakeModelDetails 필드에 채워집니다.

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

string

출력 전용. 기기 제조업체 및 모델의 표시 이름입니다.

ViewabilityTargetingOptionDetails

타겟팅 가능한 조회가능성을 나타냅니다. targetingType가 TARGETING_TYPE_VIEWABILITY이면 타겟팅 옵션의 viewabilityDetails 필드에 채워집니다.

JSON 표현 
{
  "viewability": enum (Viewability)
}
필드
viewability

enum (Viewability)

출력 전용. 예상 조회가능성 비율입니다.

CategoryTargetingOptionDetails

타겟팅할 수 있는 카테고리를 나타냅니다. targetingType가 TARGETING_TYPE_CATEGORY이면 타겟팅 옵션의 categoryDetails 필드에 채워집니다.

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

string

출력 전용. 카테고리의 표시 이름입니다.

LanguageTargetingOptionDetails

타겟팅 가능한 언어를 나타냅니다. targetingType가 TARGETING_TYPE_LANGUAGE이면 languageDetails 필드에 채워집니다.

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

string

출력 전용. 언어의 표시 이름입니다 (예: '프랑스어')

AuthorizedSellerStatusTargetingOptionDetails

타겟팅 가능한 승인된 판매자 상태를 나타냅니다. targetingType가 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS이면 authorizedSellerStatusDetails 필드에 채워집니다.

JSON 표현 
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus)
}
필드
authorizedSellerStatus

enum (AuthorizedSellerStatus)

출력 전용. 승인된 판매자 상태입니다.

GeoRegionTargetingOptionDetails

타겟팅할 수 있는 지역을 나타냅니다. targetingType가 TARGETING_TYPE_GEO_REGION이면 geoRegionDetails 필드에 채워집니다.

JSON 표현 
{
  "displayName": string,
  "geoRegionType": enum (GeoRegionType)
}
필드
displayName

string

출력 전용. 지역의 표시 이름입니다 (예: '캐나다 온타리오')
geoRegionType

enum (GeoRegionType)

출력 전용. 지역 타겟팅의 유형입니다.

ExchangeTargetingOptionDetails

타겟팅 가능한 거래소를 나타냅니다. targetingType가 TARGETING_TYPE_EXCHANGE이면 타겟팅 옵션의 exchangeDetails 필드에 채워집니다.

JSON 표현 
{
  "exchange": enum (Exchange)
}
필드
exchange

enum (Exchange)

출력 전용. 교환 유형입니다.

SubExchangeTargetingOptionDetails

타겟팅 가능한 하위 거래소를 나타냅니다. targetingType가 TARGETING_TYPE_SUB_EXCHANGE이면 타겟팅 옵션의 subExchangeDetails 필드에 채워집니다.

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

string

출력 전용. 하위 거래소의 표시 이름입니다.

PoiTargetingOptionDetails

타겟팅할 수 있는 관심 장소를 나타냅니다. targetingType가 TARGETING_TYPE_POI이면 poiDetails 필드에 채워집니다.

JSON 표현 
{
  "latitude": number,
  "longitude": number,
  "displayName": string
}
필드
latitude

number

출력 전용. 소수점 6자리로 반올림한 POI의 위도입니다.
longitude

number

출력 전용. 소수점 6자리로 반올림되는 POI의 경도입니다.
displayName

string

출력 전용. 관심 장소의 표시 이름(예: '타임스 스퀘어', '스페이스 니들') 뒤에 전체 주소가 표시됩니다(있는 경우).

BusinessChainTargetingOptionDetails

지역 내에서 타겟팅 가능한 비즈니스 체인을 나타냅니다. targetingType가 TARGETING_TYPE_BUSINESS_CHAIN이면 businessChainDetails 필드에 채워집니다.

JSON 표현 
{
  "businessChain": string,
  "geoRegion": string,
  "geoRegionType": enum (GeoRegionType)
}
필드
businessChain

string

출력 전용. 비즈니스 체인의 표시 이름입니다(예: 'KFC', 'Chase Bank').
geoRegion

string

출력 전용. 지역의 표시 이름입니다(예: 'Ontario, Canada').
geoRegionType

enum (GeoRegionType)

출력 전용. 지역의 유형입니다.

ContentDurationTargetingOptionDetails

타겟팅 가능한 콘텐츠 길이를 나타냅니다. targetingType가 TARGETING_TYPE_CONTENT_DURATION이면 contentDurationDetails 필드에 채워집니다.

JSON 표현 
{
  "contentDuration": enum (ContentDuration)
}
필드
contentDuration

enum (ContentDuration)

출력 전용. 콘텐츠 길이입니다.

ContentStreamTypeTargetingOptionDetails

타겟팅할 수 있는 콘텐츠 스트림 유형을 나타냅니다. targetingType가 TARGETING_TYPE_CONTENT_STREAM_TYPE이면 contentStreamTypeDetails 필드에 채워집니다.

JSON 표현 
{
  "contentStreamType": enum (ContentStreamType)
}
필드
contentStreamType

enum (ContentStreamType)

출력 전용. 콘텐츠 스트림 유형입니다.

NativeContentPositionTargetingOptionDetails

타겟팅할 수 있는 네이티브 콘텐츠 위치를 나타냅니다. targetingType가 TARGETING_TYPE_NATIVE_CONTENT_POSITION이면 nativeContentPositionDetails 필드에 채워집니다.

JSON 표현 
{
  "contentPosition": enum (NativeContentPosition)
}
필드
contentPosition

enum (NativeContentPosition)

출력 전용. 콘텐츠 위치입니다.

OmidTargetingOptionDetails

타겟팅 가능한 Open Measurement가 사용 설정된 인벤토리 유형을 나타냅니다. targetingType가 TARGETING_TYPE_OMID이면 omidDetails 필드에 채워집니다.

JSON 표현 
{
  "omid": enum (Omid)
}
필드
omid

enum (Omid)

출력 전용. Open Measurement가 사용 설정된 인벤토리의 유형입니다.

AudioContentTypeTargetingOptionDetails

타겟팅할 수 있는 오디오 콘텐츠 유형을 나타냅니다. targetingType가 TARGETING_TYPE_AUDIO_CONTENT_TYPE이면 audioContentTypeDetails 필드에 채워집니다.

JSON 표현 
{
  "audioContentType": enum (AudioContentType)
}
필드
audioContentType

enum (AudioContentType)

출력 전용. 오디오 콘텐츠 유형입니다.

ContentGenreTargetingOptionDetails

타겟팅할 수 있는 콘텐츠 장르를 나타냅니다. targetingType가 TARGETING_TYPE_CONTENT_GENRE이면 contentGenreDetails 필드에 채워집니다.

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

string

출력 전용. 콘텐츠 장르의 표시 이름

방법

get

 단일 타겟팅 옵션을 가져옵니다.

list

 지정된 유형의 타겟팅 옵션을 나열합니다.
지정된 검색어를 기반으로 지정된 유형의 타겟팅 옵션을 검색합니다.