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)

공개 측정이 사용 설정된 인벤토리 세부정보

audioContentTypeDetails

object (AudioContentTypeTargetingOptionDetails)

오디오 콘텐츠 유형 세부정보

contentGenreDetails

object (ContentGenreTargetingOptionDetails)

콘텐츠 장르 리소스 세부정보

DigitalContentLabelTargetingOptionDetails

타겟팅 가능한 디지털 콘텐츠 라벨 등급 등급을 나타냅니다. targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION인 경우 TargetingOption의 digitalContentLabelDetails 필드에 채워집니다.

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

enum (ContentRatingTier)

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

SensitiveCategoryTargetingOptionDetails

타겟팅 가능한 민감한 카테고리를 나타냅니다. 이는 targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION인 경우 타겟팅 옵션의 sensitiveCategoryDetails 필드에 채워집니다.

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

enum (SensitiveCategory)

출력 전용입니다. DV360 민감한 카테고리 콘텐츠 분류기의 enum입니다.

AppCategoryTargetingOptionDetails

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

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

string

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

OnScreenPositionTargetingOptionDetails

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

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

enum (OnScreenPosition)

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

ContentOutstreamPositionTargetingOptionDetails

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

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

enum (ContentOutstreamPosition)

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

ContentInstreamPositionTargetingOptionDetails

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

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

enum (ContentInstreamPosition)

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

VideoPlayerSizeTargetingOptionDetails

타겟팅 가능한 동영상 플레이어 크기를 나타냅니다. targetingTypeTARGETING_TYPE_VIDEO_PLAYER_SIZE이면 videoPlayerSizeDetails 필드에 채워집니다.

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

enum (VideoPlayerSize)

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

AgeRangeTargetingOptionDetails

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

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

enum (AgeRange)

출력 전용입니다. 시청자 연령대입니다.

ParentalStatusTargetingOptionDetails

타겟팅 가능한 자녀 유무를 나타냅니다. targetingTypeTARGETING_TYPE_PARENTAL_STATUS인 경우 TargetingOption의 parentalStatusDetails 필드에 채워집니다.

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

enum (ParentalStatus)

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

UserRewardedContentTargetingOptionDetails

동영상 광고에 대해서만 타겟팅 가능한 사용자 보상 콘텐츠 상태를 나타냅니다. targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT이면 userRewardedContentDetails 필드에 채워집니다.

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

enum (UserRewardedContent)

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

HouseholdIncomeTargetingOptionDetails

타겟팅 가능한 가구 소득을 나타냅니다. targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME인 경우 TargetingOption의 householdIncomeDetails 필드에 채워집니다.

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

enum (HouseholdIncome)

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

GenderTargetingOptionDetails

타겟팅 가능한 성별을 나타냅니다. 이는 targetingTypeTARGETING_TYPE_GENDER인 경우 타겟팅 옵션의 genderDetails 필드에 채워집니다.

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

enum (Gender)

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

DeviceTypeTargetingOptionDetails

타겟팅 가능한 기기 유형을 나타냅니다. targetingTypeTARGETING_TYPE_DEVICE_TYPE인 경우 TargetingOption의 deviceTypeDetails 필드에 채워집니다.

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

enum (DeviceType)

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

BrowserTargetingOptionDetails

타겟팅 가능한 브라우저를 나타냅니다. targetingTypeTARGETING_TYPE_BROWSER이면 browserDetails 필드에 채워집니다.

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

string

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

CarrierAndIspTargetingOptionDetails

타겟팅 가능한 이동통신사 또는 ISP를 나타냅니다. 이는 targetingTypeTARGETING_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

타겟팅 가능한 환경을 나타냅니다. targetingTypeTARGETING_TYPE_ENVIRONMENT인 경우 TargetingOption의 environmentDetails 필드에 채워집니다.

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

enum (Environment)

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

OperatingSystemTargetingOptionDetails

타겟팅 가능한 운영체제를 나타냅니다. targetingTypeTARGETING_TYPE_OPERATING_SYSTEM인 경우 TargetingOption의 operatingSystemDetails 필드에 채워집니다.

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

string

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

DeviceMakeModelTargetingOptionDetails

타겟팅 가능한 기기 제조업체 및 모델을 나타냅니다. 이는 targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL인 경우 타겟팅 옵션의 deviceMakeModelDetails 필드에 채워집니다.

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

string

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

ViewabilityTargetingOptionDetails

타겟팅 가능한 조회가능성을 나타냅니다. targetingTypeTARGETING_TYPE_VIEWABILITY인 경우 TargetingOption의 viewabilityDetails 필드에 채워집니다.

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

enum (Viewability)

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

CategoryTargetingOptionDetails

타겟팅 가능한 카테고리를 나타냅니다. targetingTypeTARGETING_TYPE_CATEGORY인 경우 TargetingOption의 categoryDetails 필드에 채워집니다.

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

string

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

LanguageTargetingOptionDetails

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

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

string

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

AuthorizedSellerStatusTargetingOptionDetails

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

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

enum (AuthorizedSellerStatus)

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

GeoRegionTargetingOptionDetails

타겟팅 가능한 지리적 지역을 나타냅니다. targetingTypeTARGETING_TYPE_GEO_REGION이면 geoRegionDetails 필드에 채워집니다.

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

string

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

geoRegionType

enum (GeoRegionType)

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

ExchangeTargetingOptionDetails

타겟팅 가능한 거래소를 나타냅니다. targetingTypeTARGETING_TYPE_EXCHANGE인 경우 TargetingOption의 exchangeDetails 필드에 채워집니다.

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

enum (Exchange)

출력 전용입니다. 거래 유형입니다.

SubExchangeTargetingOptionDetails

타겟팅할 수 있는 하위 거래소를 나타냅니다. targetingTypeTARGETING_TYPE_SUB_EXCHANGE인 경우 TargetingOption의 subExchangeDetails 필드에 채워집니다.

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

string

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

PoiTargetingOptionDetails

타겟팅 가능한 관심 장소(POI)를 나타냅니다. targetingTypeTARGETING_TYPE_POI이면 poiDetails 필드에 채워집니다.

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

number

출력 전용입니다. 관심 장소의 위도이며 소수점 이하 6자리까지 반올림됩니다.

longitude

number

출력 전용입니다. 관심 장소의 경도이며 소수점 이하 6자리까지 반올림됩니다.

displayName

string

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

BusinessChainTargetingOptionDetails

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

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

string

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

geoRegion

string

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

geoRegionType

enum (GeoRegionType)

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

ContentDurationTargetingOptionDetails

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

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

enum (ContentDuration)

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

ContentStreamTypeTargetingOptionDetails

타겟팅 가능한 콘텐츠 스트림 유형을 나타냅니다. targetingTypeTARGETING_TYPE_CONTENT_STREAM_TYPE이면 contentStreamTypeDetails 필드에 채워집니다.

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

enum (ContentStreamType)

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

NativeContentPositionTargetingOptionDetails

타겟팅 가능한 네이티브 콘텐츠 게재위치를 나타냅니다. targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION이면 nativeContentPositionDetails 필드에 채워집니다.

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

enum (NativeContentPosition)

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

OmidTargetingOptionDetails

타겟팅 가능한 공개 측정 지원 인벤토리 유형을 나타냅니다. targetingTypeTARGETING_TYPE_OMID이면 omidDetails 필드에 채워집니다.

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

enum (Omid)

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

AudioContentTypeTargetingOptionDetails

타겟팅 가능한 오디오 콘텐츠 유형을 나타냅니다. targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE이면 audioContentTypeDetails 필드에 채워집니다.

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

enum (AudioContentType)

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

ContentGenreTargetingOptionDetails

타겟팅 가능한 콘텐츠 장르를 나타냅니다. targetingTypeTARGETING_TYPE_CONTENT_GENRE이면 contentGenreDetails 필드에 채워집니다.

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

string

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

메서드

get

하나의 타겟팅 옵션을 가져옵니다.

list

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