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)

Exchange 세부정보
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번째 자리로 반올림한 관심 장소의 위도입니다.
longitude

number

출력 전용. 소수점 6자리로 반올림되는 관심 장소의 경도입니다.
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

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