REST Resource: targetingTypes.targetingOptions

리소스: 타겟팅 옵션

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. 타겟팅 옵션에 대한 세부정보 세부정보의 필드 1개만 작성할 수 있으며 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

타겟팅 가능한 디지털 콘텐츠 라벨 등급 등급을 나타냅니다. 이는 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번째 소수점 이하 6자리로 반올림한 관심 장소 위도입니다.
longitude

number

출력 전용입니다. 관심 장소의 경도이며, 소수점 여섯 번째 자리로 반올림됩니다.
displayName

string

출력 전용입니다. 관심 장소의 표시 이름(예: '타임스 스퀘어', '스페이스 니들')으로, 가능한 경우 전체 주소가 표시됩니다.

BusinessChainTargetingOptionDetails

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

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

string

출력 전용입니다. 비즈니스 체인의 표시 이름입니다. 예: 'KFC', '체이스 뱅크' 등입니다.
geoRegion

string

출력 전용입니다. 지역의 표시 이름입니다. 예: '캐나다 온타리오'라고 합니다.
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

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