REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

리소스: AssignedTargetingOption

할당된 단일 타겟팅 옵션으로, 타겟팅 설정이 있는 항목의 타겟팅 옵션 상태를 정의합니다.

JSON 표현 
{
  "name": string,
  "assignedTargetingOptionId": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
필드
name

string

출력 전용입니다. 이 할당된 타겟팅 옵션의 리소스 이름입니다.
assignedTargetingOptionId

string

출력 전용입니다. 할당된 타겟팅 옵션의 고유 ID입니다. ID는 특정 리소스 및 타겟팅 유형 내에서만 고유합니다. 다른 컨텍스트에서 다시 사용할 수 있습니다.
targetingType

enum (TargetingType)

출력 전용입니다. 할당된 타겟팅 옵션의 유형을 식별합니다.
inheritance

enum (Inheritance)

출력 전용입니다. 할당된 타겟팅 옵션의 상속 상태입니다.
통합 필드 details. 할당되는 타겟팅 옵션에 대한 세부정보입니다. 세부정보의 필드 1개만 작성할 수 있으며 targeting_type와 일치해야 합니다. details는 다음 중 하나여야 합니다.
channelDetails

object (ChannelAssignedTargetingOptionDetails)

채널 세부정보 이 필드는 targetingType가 TARGETING_TYPE_CHANNEL일 때 채워집니다.
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

앱 카테고리 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_APP_CATEGORY일 때 채워집니다.
appDetails

object (AppAssignedTargetingOptionDetails)

앱 세부정보 이 필드는 targetingType가 TARGETING_TYPE_APP일 때 채워집니다.
urlDetails

object (UrlAssignedTargetingOptionDetails)

URL 세부정보 이 필드는 targetingType가 TARGETING_TYPE_URL일 때 채워집니다.
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

날짜 및 시간 세부정보 이 필드는 targetingType가 TARGETING_TYPE_DAY_AND_TIME일 때 채워집니다.
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

연령대 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_AGE_RANGE일 때 채워집니다.
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

리전 위치 목록 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_REGIONAL_LOCATION_LIST일 때 채워집니다.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

인접 위치 목록 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_PROXIMITY_LOCATION_LIST일 때 채워집니다.
genderDetails

object (GenderAssignedTargetingOptionDetails)

성별 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_GENDER일 때 채워집니다.
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

동영상 플레이어 크기 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_VIDEO_PLAYER_SIZE일 때 채워집니다.
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

사용자 리워드 콘텐츠 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_USER_REWARDED_CONTENT일 때 채워집니다.
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

자녀 유무 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_PARENTAL_STATUS일 때 채워집니다.
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

콘텐츠 인스트림 위치 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_CONTENT_INSTREAM_POSITION일 때 채워집니다.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

콘텐츠 아웃스트림 위치 세부정보. 이 필드는 targetingType가 TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION일 때 채워집니다.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

기기 유형 세부정보 이 필드는 targetingType가 TARGETING_TYPE_DEVICE_TYPE일 때 채워집니다.
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

잠재고객 타겟팅 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_AUDIENCE_GROUP일 때 채워집니다. 리소스당 하나의 잠재고객 그룹 옵션만 타겟팅할 수 있습니다.
browserDetails

object (BrowserAssignedTargetingOptionDetails)

브라우저 세부정보 이 필드는 targetingType가 TARGETING_TYPE_BROWSER일 때 채워집니다.
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

가구 소득 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_HOUSEHOLD_INCOME일 때 채워집니다.
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

화면 위치 세부정보 이 필드는 targetingType가 TARGETING_TYPE_ON_SCREEN_POSITION일 때 채워집니다.
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

이동통신사 및 ISP 세부정보 이 필드는 targetingType가 TARGETING_TYPE_CARRIER_AND_ISP일 때 채워집니다.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

키워드 세부정보. 이 필드는 targetingType가 TARGETING_TYPE_KEYWORD일 때 채워집니다.

리소스에 최대 5,000개의 직접 제외 키워드를 할당할 수 있습니다. 할당할 수 있는 일반 키워드 수에는 제한이 없습니다.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

키워드 세부정보. 이 필드는 targetingType가 TARGETING_TYPE_NEGATIVE_KEYWORD_LIST일 때 채워집니다.

리소스에 최대 4개의 제외 키워드 목록을 할당할 수 있습니다.
operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

운영체제 세부정보 이 필드는 targetingType가 TARGETING_TYPE_OPERATING_SYSTEM일 때 채워집니다.
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

기기 제조업체 및 모델 세부정보 이 필드는 targetingType가 TARGETING_TYPE_DEVICE_MAKE_MODEL일 때 채워집니다.
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

환경 세부정보 이 필드는 targetingType가 TARGETING_TYPE_ENVIRONMENT일 때 채워집니다.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

인벤토리 소스 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_INVENTORY_SOURCE일 때 채워집니다.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

카테고리 세부정보 이 필드는 targetingType가 TARGETING_TYPE_CATEGORY일 때 채워집니다.

카테고리를 타겟팅하면 그 하위 카테고리도 타겟팅됩니다. 카테고리가 타겟팅에서 제외되고 하위 카테고리가 포함된 경우 제외가 우선 적용됩니다.
viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

조회가능성 세부정보 이 필드는 targetingType가 TARGETING_TYPE_VIEWABILITY일 때 채워집니다.

리소스당 하나의 조회가능성 옵션만 타겟팅할 수 있습니다.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

승인된 판매자 상태 세부정보 이 필드는 targetingType가 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS일 때 채워집니다.

리소스당 승인된 판매자 상태 옵션 하나만 타겟팅할 수 있습니다.

리소스에 승인된 판매자 상태 옵션이 없는 경우 ads.txt 파일에 DIRECT 또는 RESELLER로 표시된 모든 승인된 판매자가 기본적으로 타겟팅됩니다.
languageDetails

object (LanguageAssignedTargetingOptionDetails)

언어 세부정보 이 필드는 targetingType가 TARGETING_TYPE_LANGUAGE일 때 채워집니다.
geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

지리적 리전 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_GEO_REGION일 때 채워집니다.
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

인벤토리 소스 그룹 세부정보 이 필드는 targetingType가 TARGETING_TYPE_INVENTORY_SOURCE_GROUP일 때 채워집니다.
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

디지털 콘텐츠 라벨 세부정보 이 필드는 targetingType가 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION일 때 채워집니다.

디지털 콘텐츠 라벨은 제외를 타겟팅합니다. 광고주 수준의 디지털 콘텐츠 라벨 제외가 설정된 경우 리소스 설정에 표시되지 않더라도 항상 게재 시 적용됩니다. 리소스 설정은 광고주 제외 외에 콘텐츠 라벨을 제외할 수 있지만 재정의할 수는 없습니다. 모든 디지털 콘텐츠 라벨이 제외되면 광고 항목이 게재되지 않습니다.
sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

민감한 카테고리 세부정보 이 필드는 targetingType가 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION일 때 채워집니다.

민감한 카테고리는 제외를 타겟팅합니다. 광고주 수준의 민감한 카테고리 제외가 설정되면 리소스 설정에 표시되지 않더라도 항상 게재 시 적용됩니다. 리소스 설정은 광고주 제외 외에 민감한 카테고리를 제외할 수 있지만 재정의할 수는 없습니다.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

거래소 세부정보 이 필드는 targetingType가 TARGETING_TYPE_EXCHANGE일 때 채워집니다.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

하위 거래소 세부정보 이 필드는 targetingType가 TARGETING_TYPE_SUB_EXCHANGE일 때 채워집니다.
thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

서드 파티 인증 세부정보 이 필드는 targetingType가 TARGETING_TYPE_THIRD_PARTY_VERIFIER일 때 채워집니다.
poiDetails

object (PoiAssignedTargetingOptionDetails)

관심 장소 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_POI일 때 채워집니다.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

비즈니스 체인 세부정보 이 필드는 targetingType가 TARGETING_TYPE_BUSINESS_CHAIN일 때 채워집니다.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

콘텐츠 길이 세부정보 이 필드는 targetingType가 TARGETING_TYPE_CONTENT_DURATION일 때 채워집니다.
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

콘텐츠 길이 세부정보 이 필드는 타겟팅 유형이 TARGETING_TYPE_CONTENT_STREAM_TYPE인 경우 채워집니다.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

네이티브 콘텐츠 위치 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_NATIVE_CONTENT_POSITION일 때 채워집니다.
omidDetails

object (OmidAssignedTargetingOptionDetails)

측정이 사용 설정된 인벤토리 세부정보를 엽니다. 이 필드는 targetingType가 TARGETING_TYPE_OMID일 때 채워집니다.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

오디오 콘텐츠 유형 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_AUDIO_CONTENT_TYPE일 때 채워집니다.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

콘텐츠 장르 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_CONTENT_GENRE일 때 채워집니다.

상속

할당된 타겟팅 옵션이 파트너 또는 광고주와 같은 상위 수준 개체에서 상속되었는지 여부를 나타냅니다. 상속된 할당된 타겟팅 옵션이 우선하며, 현재 수준에서 할당된 타겟팅보다 게재 시 항상 적용되며 현재 항목 서비스를 통해 수정할 수 없습니다. 상속된 항목 서비스를 통해 수정해야 합니다. 상위 수준에서 구성된 경우 제외 타겟 채널, 민감한 카테고리 제외, 디지털 콘텐츠 라벨 제외에만 상속이 적용됩니다.

열거형
INHERITANCE_UNSPECIFIED 상속이 지정되지 않았거나 알 수 없습니다.
NOT_INHERITED 할당된 타겟팅 옵션은 상위 항목에서 상속되지 않습니다.
INHERITED_FROM_PARTNER 할당된 타겟팅 옵션은 파트너 타겟팅 설정에서 상속됩니다.
INHERITED_FROM_ADVERTISER 할당된 타겟팅 옵션은 광고주 타겟팅 설정에서 상속됩니다.

ChannelAssignedTargetingOptionDetails

할당된 채널 타겟팅 옵션에 대한 세부정보입니다. targetingType이 TARGETING_TYPE_CHANNEL인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

JSON 표현 
{
  "channelId": string,
  "negative": boolean
}
필드
channelId

string (int64 format)

필수 항목입니다. 채널의 ID입니다. 파트너 소유 채널 또는 광고주 소유 채널 리소스의 채널 ID 필드를 참조해야 합니다.
negative

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다. 광고주 수준에서 할당된 타겟팅 옵션의 경우 이 필드가 true여야 합니다.

AppCategoryAssignedTargetingOptionDetails

할당된 앱 카테고리 타겟팅 옵션에 대한 세부정보입니다. targetingType이 TARGETING_TYPE_APP_CATEGORY이면 AssignedTargetingOption의 appCategoryDetails 필드에 채워집니다.

JSON 표현 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
필드
displayName

string

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

string

필수 항목입니다. targetingType가 TARGETING_TYPE_APP_CATEGORY인 경우 targetingOptionId 필드
negative

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다.

AppAssignedTargetingOptionDetails

할당된 앱 타겟팅 옵션에 대한 세부정보입니다. targetingType이 TARGETING_TYPE_APP인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

JSON 표현 
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
필드
appId

string

필수 항목입니다. 앱의 ID입니다.

Android의 Play 스토어 App은 번들 ID(예: com.google.android.gm)를 사용합니다. Apple의 App Store 앱 ID는 9자리 문자열을 사용합니다(예: 422689480).
displayName

string

출력 전용입니다. 앱의 표시 이름입니다.
negative

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다.
appPlatform

enum (AppPlatform)

타겟팅된 앱의 플랫폼을 나타냅니다. 이 필드가 지정되지 않으면 앱 플랫폼이 모바일 (예: Android 또는 iOS)에서 앱 ID를 통해 적절한 모바일 플랫폼을 가져옵니다.

AppPlatform

가능한 앱 플랫폼 타겟팅 옵션입니다.

열거형
APP_PLATFORM_UNSPECIFIED 이 버전에 앱 플랫폼이 지정되지 않은 경우의 기본값입니다. 이 enum은 기본값의 자리표시자이며 실제 플랫폼 옵션을 나타내지 않습니다.
APP_PLATFORM_IOS 앱 플랫폼이 iOS입니다.
APP_PLATFORM_ANDROID 앱 플랫폼이 Android입니다.
APP_PLATFORM_ROKU 앱 플랫폼이 Roku입니다.
APP_PLATFORM_AMAZON_FIRETV 앱 플랫폼이 Amazon FireTV입니다.
APP_PLATFORM_PLAYSTATION 앱 플랫폼이 Playstation입니다.
APP_PLATFORM_APPLE_TV 앱 플랫폼이 Apple TV입니다.
APP_PLATFORM_XBOX 앱 플랫폼이 Xbox입니다.
APP_PLATFORM_SAMSUNG_TV 앱 플랫폼이 삼성 TV입니다.
APP_PLATFORM_ANDROID_TV 앱 플랫폼이 Android TV입니다.
APP_PLATFORM_GENERIC_CTV 앱 플랫폼이 다른 곳에 명시적으로 나열되지 않은 CTV 플랫폼입니다.

UrlAssignedTargetingOptionDetails

할당된 URL 타겟팅 옵션에 대한 세부정보입니다. targetingType이 TARGETING_TYPE_URL인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

JSON 표현 
{
  "url": string,
  "negative": boolean
}
필드
url

string

필수 항목입니다. URL입니다(예: example.com).

DV360은 2가지 수준의 하위 디렉터리 타겟팅(예: www.example.com/one-subdirectory-level/second-level)과 5가지 수준의 하위 도메인 타겟팅(예: five.four.three.two.one.example.com)을 지원합니다.
negative

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다.

DayAndTimeAssignedTargetingOptionDetails

특정 요일에 시작 시간과 종료 시간이 함께 정의된 시간 세그먼트를 나타냅니다. startHour로 표시되는 시간은 endHour로 표시되는 시간 이전이어야 합니다.

JSON 표현 
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
필드
dayOfWeek

enum (DayOfWeek)

필수 항목입니다. 이 요일 및 시간 타겟팅 설정의 요일입니다.
startHour

integer

필수 항목입니다. 요일 및 시간 타겟팅의 시작 시간입니다. 0 (일과 시작)에서 23 (하루가 끝나기 1시간 전) 사이의 값이어야 합니다.
endHour

integer

필수 항목입니다. 요일 및 시간 타겟팅의 종료 시간입니다. 1 (하루가 시작된 후 1시간)에서 24시간 (하루를 시작 후 1시간) 사이여야 합니다.
timeZoneResolution

enum (TimeZoneResolution)

필수 항목입니다. 이 요일 및 시간 타겟팅 설정에 사용할 시간대를 결정하는 데 사용되는 메커니즘입니다.

DayOfWeek

요일을 나타냅니다.

열거형
DAY_OF_WEEK_UNSPECIFIED 요일이 지정되지 않습니다.
MONDAY 월요일
TUESDAY 화요일
WEDNESDAY 수요일
THURSDAY 목요일
FRIDAY 금요일
SATURDAY 토요일
SUNDAY 일요일

TimeZoneResolution

시간대를 해결할 수 있는 방법입니다.

열거형
TIME_ZONE_RESOLUTION_UNSPECIFIED 시간대 해상도가 구체적이지 않거나 알 수 없습니다.
TIME_ZONE_RESOLUTION_END_USER 시간은 광고를 본 사용자의 시간대로 확인됩니다.
TIME_ZONE_RESOLUTION_ADVERTISER 시간은 광고를 게재한 광고주의 시간대를 기준으로 확인됩니다.

AgeRangeAssignedTargetingOptionDetails

타겟팅할 수 있는 연령대를 나타냅니다. targetingType이 TARGETING_TYPE_AGE_RANGE인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

enum (AgeRange)

잠재고객의 연령대입니다. 잠재고객의 연속 연령대 타겟팅만 지원됩니다. 따라서 이 필드에 표시되는 연령대는 1) 단독으로 타겟팅되거나 2) 더 큰 연속 연령대의 일부일 수 있습니다. 연령을 알 수 없는 잠재고객을 타겟팅해도 연속 연령대 타겟팅의 도달범위를 확장할 수 있습니다.

v1에서만 출력됩니다. v2에서 필수입니다.
targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_AGE_RANGE 유형 TargetingOption의 targetingOptionId

RegionalLocationListAssignedTargetingOptionDetails

지역 위치 목록의 타겟팅 세부정보입니다. targetingType이 TARGETING_TYPE_REGIONAL_LOCATION_LIST인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

JSON 표현 
{
  "regionalLocationListId": string,
  "negative": boolean
}
필드
regionalLocationListId

string (int64 format)

필수 항목입니다. 지역 위치 목록의 ID입니다. 유형이 TARGETING_LOCATION_TYPE_REGIONAL인 LocationList 리소스의 locationListId 필드를 참조해야 합니다.
negative

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다.

ProximityLocationListAssignedTargetingOptionDetails

인접 위치 목록의 타겟팅 세부정보입니다. targetingType이 TARGETING_TYPE_PROXIMITY_LOCATION_LIST인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

JSON 표현 
{
  "proximityLocationListId": string,
  "proximityRadiusRange": enum (ProximityRadiusRange)
}
필드
proximityLocationListId

string (int64 format)

필수 항목입니다. 인접 위치 목록의 ID입니다. 유형이 TARGETING_LOCATION_TYPE_PROXIMITY인 LocationList 리소스의 locationListId 필드를 참조해야 합니다.
proximityRadiusRange

enum (ProximityRadiusRange)

필수 항목입니다. 인접 위치 목록의 반경 범위입니다. 선택된 위치 주변에서 타겟팅할 지역의 크기를 나타냅니다.

단일 리소스에 있는 All 인접 위치 타겟팅은 반경 범위 값이 동일해야 합니다. 기존 타겟팅과 일치하도록 이 값을 설정합니다. 업데이트하면 이 필드는 리소스에 있는 모든 인접 타겟팅의 반경 범위를 변경합니다.

ProximityRadiusRange

인접 지역 유형으로 할당된 옵션의 반경 범위 유형입니다. 반경 범위는 인구 밀도를 기준으로 합니다. 예를 들어 시골 지역의 PROXIMITY_RADIUS_RANGE_SMALL은 인구가 많은 도시의 PROXIMITY_RADIUS_RANGE_SMALL와 다릅니다.

열거형
PROXIMITY_RADIUS_RANGE_UNSPECIFIED 타겟 반경 범위가 지정되지 않았거나 알 수 없습니다. 이 버전에 반경 범위가 지정되지 않은 경우의 기본값입니다. 이 enum은 기본값의 자리표시자이며 실제 반경 범위 옵션을 나타내지 않습니다.
PROXIMITY_RADIUS_RANGE_SMALL 타겟 반경 범위가 작습니다.
PROXIMITY_RADIUS_RANGE_MEDIUM 타겟 반경 범위가 중간입니다.
PROXIMITY_RADIUS_RANGE_LARGE 타겟 반경 범위가 넓습니다.

GenderAssignedTargetingOptionDetails

할당된 성별 타겟팅 옵션에 대한 세부정보입니다. targetingType이 TARGETING_TYPE_GENDER인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

enum (Gender)

잠재고객의 성별입니다.

v1에서만 출력됩니다. v2에서 필수입니다.
targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_GENDER 유형 TargetingOption의 targetingOptionId

VideoPlayerSizeAssignedTargetingOptionDetails

동영상 플레이어 크기 타겟팅 옵션 세부정보입니다. targetingType가 TARGETING_TYPE_VIDEO_PLAYER_SIZE이면 videoPlayerSizeDetails 필드에 채워집니다. 모든 옵션을 명시적으로 타겟팅하는 기능은 지원되지 않습니다. 이 효과를 얻으려면 모든 동영상 플레이어 크기 타겟팅 옵션을 제거하세요.

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

string

필수 항목입니다. targetingType가 TARGETING_TYPE_VIDEO_PLAYER_SIZE인 경우 targetingOptionId 필드
videoPlayerSize

enum (VideoPlayerSize)

동영상 플레이어 크기입니다.

v1에서만 출력됩니다. v2에서 필수입니다.

UserRewardedContentAssignedTargetingOptionDetails

사용자 리워드 콘텐츠 타겟팅 옵션 세부정보입니다. targetingType가 TARGETING_TYPE_USER_REWARDED_CONTENT이면 userRewardedContentDetails 필드에 채워집니다.

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

string

필수 항목입니다. targetingType가 TARGETING_TYPE_USER_REWARDED_CONTENT인 경우 targetingOptionId 필드
userRewardedContent

enum (UserRewardedContent)

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

ParentalStatusAssignedTargetingOptionDetails

할당된 자녀 유무 타겟팅 옵션에 대한 세부정보입니다. targetingType이 TARGETING_TYPE_PARENTAL_STATUS인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

enum (ParentalStatus)

잠재고객의 자녀 유무 상태입니다.

v1에서만 출력됩니다. v2에서 필수입니다.
targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_PARENTAL_STATUS 유형 TargetingOption의 targetingOptionId

ContentInstreamPositionAssignedTargetingOptionDetails

할당된 콘텐츠 인스트림 위치 타겟팅 옵션 세부정보입니다. targetingType가 TARGETING_TYPE_CONTENT_INSTREAM_POSITION이면 contentInstreamPositionDetails 필드에 채워집니다.

JSON 표현 
{
  "targetingOptionId": string,
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
필드
targetingOptionId

string

필수 항목입니다. targetingType가 TARGETING_TYPE_CONTENT_INSTREAM_POSITION인 경우 targetingOptionId 필드
contentInstreamPosition

enum (ContentInstreamPosition)

동영상 또는 오디오 광고의 콘텐츠 인스트림 위치입니다.

v1에서만 출력됩니다. v2에서 필수입니다.
adType

enum (AdType)

출력 전용입니다. 타겟팅할 광고 유형입니다. 게재 신청서 타겟팅에만 적용되며 지정된 광고 유형을 지원하는 새 광고 항목은 기본적으로 이 타겟팅 옵션을 상속합니다. 가능한 값은 다음과 같습니다.

  • AD_TYPE_VIDEO인 경우 lineItemType이 LINE_ITEM_TYPE_VIDEO_DEFAULT일 때 새 광고 항목에서 설정을 상속합니다.
  • AD_TYPE_AUDIO인 경우 lineItemType이 LINE_ITEM_TYPE_AUDIO_DEFAULT일 때 새 광고 항목에서 설정을 상속합니다.

AdType

광고와 연결된 광고 소재 유형을 나타냅니다.

열거형
AD_TYPE_UNSPECIFIED 광고 유형이 지정되지 않았거나 이 버전에서 알 수 없습니다.
AD_TYPE_DISPLAY 디스플레이 광고 소재(예: 있습니다.
AD_TYPE_VIDEO 동영상 광고 소재(예: 동영상 플레이어에서 콘텐츠가 스트리밍되는 동안 재생되는 동영상 광고입니다.
AD_TYPE_AUDIO 오디오 광고 소재(예: 오디오 콘텐츠 중에 재생되는 오디오 광고입니다.

ContentOutstreamPositionAssignedTargetingOptionDetails

할당된 콘텐츠 아웃스트림 위치 타겟팅 옵션 세부정보입니다. targetingType가 TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION이면 contentOutstreamPositionDetails 필드에 채워집니다.

JSON 표현 
{
  "targetingOptionId": string,
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
필드
targetingOptionId

string

필수 항목입니다. targetingType가 TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION인 경우 targetingOptionId 필드
contentOutstreamPosition

enum (ContentOutstreamPosition)

콘텐츠 아웃스트림 위치입니다.

v1에서만 출력됩니다. v2에서 필수입니다.
adType

enum (AdType)

출력 전용입니다. 타겟팅할 광고 유형입니다. 게재 신청서 타겟팅에만 적용되며 지정된 광고 유형을 지원하는 새 광고 항목은 기본적으로 이 타겟팅 옵션을 상속합니다. 가능한 값은 다음과 같습니다.

  • AD_TYPE_DISPLAY인 경우 lineItemType이 LINE_ITEM_TYPE_DISPLAY_DEFAULT일 때 새 광고 항목에서 설정을 상속합니다.
  • AD_TYPE_VIDEO인 경우 lineItemType이 LINE_ITEM_TYPE_VIDEO_DEFAULT일 때 새 광고 항목에서 설정을 상속합니다.

DeviceTypeAssignedTargetingOptionDetails

기기 유형의 타겟팅 세부정보입니다. targetingType이 TARGETING_TYPE_DEVICE_TYPE인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

string

필수 항목입니다. 기기 유형의 ID입니다.
deviceType

enum (DeviceType)

기기 유형의 표시 이름입니다.

v1에서만 출력됩니다. v2에서 필수입니다.

AudienceGroupAssignedTargetingOptionDetails

할당된 잠재고객 그룹 타겟팅 옵션 세부정보입니다. targetingType이 TARGETING_TYPE_AUDIENCE_GROUP인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다. 각 그룹 간의 관계는 UNION입니다. 단, excludedFirstAndThirdPartyAudienceGroup 및 excludedGoogleAudienceGroup은 제외되며, 여기서 COMPLEMENT는 다른 그룹과의 교대로 사용됩니다.

JSON 표현 
{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}
필드
includedFirstAndThirdPartyAudienceGroups[]

object (FirstAndThirdPartyAudienceGroup)

포함된 퍼스트 파티 및 서드 파티 잠재고객 그룹의 퍼스트 파티 및 서드 파티 잠재고객 ID와 최신성입니다. 각 자사 및 타사 잠재고객 그룹에는 자사 및 타사 잠재고객 ID만 포함됩니다. 각 퍼스트 파티 잠재고객 및 서드 파티 잠재고객 그룹 간의 관계가 '상호작용'이며, 그 결과는 다른 잠재고객 그룹과 통합됩니다. 설정이 동일한 반복되는 그룹은 무시됩니다.
includedGoogleAudienceGroup

object (GoogleAudienceGroup)

포함된 Google 잠재고객 그룹의 Google 잠재고객 ID입니다. Google 잠재고객 ID만 포함합니다.
includedCustomListGroup

object (CustomListGroup)

포함된 맞춤 목록 그룹의 맞춤 목록 ID입니다. 맞춤 목록 ID만 포함합니다.
includedCombinedAudienceGroup

object (CombinedAudienceGroup)

포함된 합성 잠재고객 그룹의 합성 잠재고객 ID입니다. 합성 잠재고객 ID만 포함합니다.
excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

제외된 퍼스트 파티 및 서드 파티 잠재고객 그룹의 퍼스트 파티 및 서드 파티 잠재고객 ID와 날짜순입니다. 제외 타겟팅에 사용됩니다. 이 그룹과 기타 제외된 잠재고객 그룹의 'UNION' 보완이 모든 포함 잠재고객 타겟팅에 대한 상호 연결로 사용됩니다. 모든 항목은 논리적으로 서로 ‘OR’입니다.
excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

제외된 Google 잠재고객 그룹의 Google 잠재고객 ID입니다. 제외 타겟팅에 사용됩니다. 이 그룹과 기타 제외된 잠재고객 그룹의 'UNION' 보완이 모든 포함 잠재고객 타겟팅에 대한 상호 연결로 사용됩니다. Google 잠재고객, 관심분야, 구매 의도, 설치된 앱 유형만 포함됩니다. 모든 항목은 논리적으로 서로 ‘OR’입니다.

FirstAndThirdPartyAudienceGroup

퍼스트 파티 및 서드 파티 잠재고객 그룹의 세부정보입니다. 모든 자사 및 타사 잠재고객 타겟팅 설정은 논리적으로 'OR'로 연결됩니다.

JSON 표현 
{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}
필드
settings[]

object (FirstAndThirdPartyAudienceTargetingSetting)

필수 항목입니다. 자사 및 타사 잠재고객 그룹의 모든 자사 및 타사 잠재고객 타겟팅 설정. 동일한 ID로 반복되는 설정은 허용되지 않습니다.

FirstAndThirdPartyAudienceTargetingSetting

퍼스트 파티 및 서드 파티 잠재고객 타겟팅 설정의 세부정보입니다.

JSON 표현 
{
  "firstAndThirdPartyAudienceId": string,
  "recency": enum (Recency)
}
필드
firstAndThirdPartyAudienceId

string (int64 format)

필수 항목입니다. 퍼스트 파티 및 서드 파티 잠재고객 타겟팅 설정의 퍼스트 파티 및 서드 파티 잠재고객 ID입니다. 이 ID는 firstAndThirdPartyAudienceId입니다.
recency

enum (Recency)

퍼스트 파티 및 서드 파티 잠재고객 타겟팅 설정의 최신성입니다. 퍼스트 파티 잠재고객에만 적용되며, 그렇지 않은 경우에는 무시됩니다. 자세한 내용은 https://support.google.com/displayvideo/answer/2949947#recency를 참조하세요. 지정하지 않으면 최근 구매일 한도가 사용되지 않습니다.

최신순

지원되는 모든 퍼스트 파티 및 서드 파티 잠재고객 최신성 값입니다.

열거형
RECENCY_NO_LIMIT 최신성에는 제한이 없습니다.
RECENCY_1_MINUTE 최근 구매일은 1분입니다.
RECENCY_5_MINUTES 최근 구매일은 5분입니다.
RECENCY_10_MINUTES 최근 구매일은 10분입니다.
RECENCY_15_MINUTES 최근 구매일은 15분입니다.
RECENCY_30_MINUTES 최근 구매일은 30분입니다.
RECENCY_1_HOUR 최근 구매일은 1시간입니다.
RECENCY_2_HOURS 최근 구매일은 2시간입니다.
RECENCY_3_HOURS 최근 구매일은 3시간입니다.
RECENCY_6_HOURS 최근 구매일은 6시간입니다.
RECENCY_12_HOURS 최근 구매일은 12시간입니다.
RECENCY_1_DAY 날짜순은 1일입니다.
RECENCY_2_DAYS 날짜순은 2일입니다.
RECENCY_3_DAYS 최근 구매일은 3일입니다.
RECENCY_5_DAYS 최근 구매일은 5일입니다.
RECENCY_7_DAYS 최근 구매일은 7일입니다.
RECENCY_10_DAYS 날짜순은 10일입니다.
RECENCY_14_DAYS 날짜순은 14일입니다.
RECENCY_15_DAYS 최근 구매일은 15일입니다.
RECENCY_21_DAYS 날짜순은 21일입니다.
RECENCY_28_DAYS 최근 구매일은 28일입니다.
RECENCY_30_DAYS 최근 구매일은 30일입니다.
RECENCY_40_DAYS 날짜순은 40일입니다.
RECENCY_45_DAYS 최근 구매일은 45일입니다.
RECENCY_60_DAYS 최근 구매일은 60일입니다.
RECENCY_90_DAYS 날짜순은 90일입니다.
RECENCY_120_DAYS 날짜순은 120일입니다.
RECENCY_180_DAYS 날짜순은 180일입니다.
RECENCY_270_DAYS 날짜순은 270일입니다.
RECENCY_365_DAYS 최근 구매일은 365일입니다.

GoogleAudienceGroup

Google 잠재고객 그룹의 세부정보입니다. 모든 Google 잠재고객 타겟팅 설정은 논리적으로 서로 'OR'로 되어 있습니다.

JSON 표현 
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
필드
settings[]

object (GoogleAudienceTargetingSetting)

필수 항목입니다. Google 잠재고객 그룹의 모든 Google 잠재고객 타겟팅 설정입니다. ID가 동일한 반복 설정은 무시됩니다.

GoogleAudienceTargetingSetting

Google 잠재고객 타겟팅 설정의 세부정보입니다.

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

string (int64 format)

필수 항목입니다. Google 잠재고객 타겟팅 설정의 Google 잠재고객 ID입니다. 이 ID는 googleAudienceId입니다.

CustomListGroup

맞춤 목록 그룹의 세부정보입니다. 모든 맞춤 목록 타겟팅 설정은 논리적으로 서로 'OR'입니다.

JSON 표현 
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
필드
settings[]

object (CustomListTargetingSetting)

필수 항목입니다. 맞춤 목록 그룹의 모든 맞춤 목록 타겟팅 설정입니다. ID가 동일한 반복 설정은 무시됩니다.

CustomListTargetingSetting

맞춤 목록 타겟팅 설정의 세부정보입니다.

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

string (int64 format)

필수 항목입니다. 맞춤 목록 타겟팅 설정의 맞춤 ID입니다. 이 ID는 customListId입니다.

CombinedAudienceGroup

합성 잠재고객 그룹의 세부정보입니다. 모든 합성 잠재고객 타겟팅 설정은 논리적으로 서로 'OR'로 되어 있습니다.

JSON 표현 
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
필드
settings[]

object (CombinedAudienceTargetingSetting)

필수 항목입니다. 합성 잠재고객 그룹의 모든 통합된 잠재고객 타겟팅 설정입니다. ID가 동일한 반복 설정은 무시됩니다. 통합된 잠재고객 설정의 수는 5개를 초과할 수 없으며, 5개를 초과하면 오류가 발생합니다.

CombinedAudienceTargetingSetting

합성 잠재고객 타겟팅 설정의 세부정보입니다.

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

string (int64 format)

필수 항목입니다. 통합된 잠재고객 타겟팅 설정의 통합 잠재고객 ID입니다. 이 ID는 combinedAudienceId입니다.

BrowserAssignedTargetingOptionDetails

할당된 브라우저 타겟팅 옵션에 대한 세부정보입니다. targetingType이 TARGETING_TYPE_BROWSER인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

JSON 표현 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
필드
displayName

string

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

string

필수 항목입니다. TARGETING_TYPE_BROWSER 유형 TargetingOption의 targetingOptionId
negative

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다. 동일한 리소스에 할당된 모든 브라우저 타겟팅 옵션은 이 필드의 값이 동일해야 합니다.

HouseholdIncomeAssignedTargetingOptionDetails

할당된 가계 소득 타겟팅 옵션의 세부정보입니다. targetingType이 TARGETING_TYPE_HOUSEHOLD_INCOME인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

enum (HouseholdIncome)

잠재고객의 가계 소득입니다.

v1에서만 출력됩니다. v2에서 필수입니다.
targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_HOUSEHOLD_INCOME 유형 TargetingOption의 targetingOptionId

OnScreenPositionAssignedTargetingOptionDetails

화면상의 위치 타겟팅 옵션 세부정보입니다. targetingType가 TARGETING_TYPE_ON_SCREEN_POSITION이면 onScreenPositionDetails 필드에 채워집니다.

JSON 표현 
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
필드
targetingOptionId

string

필수 항목입니다. targetingType가 TARGETING_TYPE_ON_SCREEN_POSITION인 경우 targetingOptionId 필드
onScreenPosition

enum (OnScreenPosition)

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

enum (AdType)

출력 전용입니다. 타겟팅할 광고 유형입니다. 게재 신청서 타겟팅에만 적용되며 지정된 광고 유형을 지원하는 새 광고 항목은 기본적으로 이 타겟팅 옵션을 상속합니다. 가능한 값은 다음과 같습니다.

  • AD_TYPE_DISPLAY인 경우 lineItemType이 LINE_ITEM_TYPE_DISPLAY_DEFAULT일 때 새 광고 항목에서 설정을 상속합니다.
  • AD_TYPE_VIDEO인 경우 lineItemType이 LINE_ITEM_TYPE_VIDEO_DEFAULT일 때 새 광고 항목에서 설정을 상속합니다.

CarrierAndIspAssignedTargetingOptionDetails

할당된 이동통신사 및 ISP 타겟팅 옵션에 대한 세부정보입니다. targetingType이 TARGETING_TYPE_CARRIER_AND_ISP인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

JSON 표현 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
필드
displayName

string

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

string

필수 항목입니다. TARGETING_TYPE_CARRIER_AND_ISP 유형 TargetingOption의 targetingOptionId
negative

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다. 동일한 리소스에 할당된 모든 이동통신사 및 ISP 타겟팅 옵션은 이 필드의 값이 동일해야 합니다.

KeywordAssignedTargetingOptionDetails

할당된 키워드 타겟팅 옵션에 대한 세부정보입니다. targetingType이 TARGETING_TYPE_KEYWORD인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

JSON 표현 
{
  "keyword": string,
  "negative": boolean
}
필드
keyword

string

필수 항목입니다. 키워드입니다(예: car insurance).

포함 키워드는 불쾌감을 주는 단어가 될 수 없습니다. 최대 255바이트의 UTF-8로 인코딩되어야 합니다. 최대 80자(영문 기준)입니다. 최대 단어 수는 10개입니다.
negative

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다.

NegativeKeywordListAssignedTargetingOptionDetails

제외 키워드 목록의 타겟팅 세부정보입니다. targetingType이 TARGETING_TYPE_NEGATIVE_KEYWORD_LIST인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

string (int64 format)

필수 항목입니다. 제외 키워드 목록의 ID입니다. NegativeKeywordList 리소스의 negativeKeywordListId 필드를 참조해야 합니다.

OperatingSystemAssignedTargetingOptionDetails

할당된 운영체제 타겟팅 옵션 세부정보입니다. targetingType가 TARGETING_TYPE_OPERATING_SYSTEM이면 operatingSystemDetails 필드에 채워집니다.

JSON 표현 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
필드
displayName

string

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

string

필수 항목입니다. targetingType가 TARGETING_TYPE_OPERATING_SYSTEM일 때 targetingOptionId 필드에 입력되는 타겟팅 옵션 ID입니다.
negative

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다.

DeviceMakeModelAssignedTargetingOptionDetails

할당된 기기 제조업체 및 모델 타겟팅 옵션 세부정보 targetingType가 TARGETING_TYPE_DEVICE_MAKE_MODEL이면 deviceMakeModelDetails 필드에 채워집니다.

JSON 표현 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
필드
displayName

string

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

string

필수 항목입니다. targetingType가 TARGETING_TYPE_DEVICE_MAKE_MODEL인 경우 targetingOptionId 필드
negative

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다.

EnvironmentAssignedTargetingOptionDetails

할당된 환경 타겟팅 옵션 세부정보입니다. targetingType이 TARGETING_TYPE_ENVIRONMENT인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

enum (Environment)

게재 환경

v1에서만 출력됩니다. v2에서 필수입니다.
targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_ENVIRONMENT 유형 TargetingOption의 targetingOptionId (예: '508010' (ENVIRONMENT_WEB_OPTIMIZED 옵션 타겟팅)

InventorySourceAssignedTargetingOptionDetails

인벤토리 소스의 타겟팅 세부정보입니다. targetingType이 TARGETING_TYPE_INVENTORY_SOURCE인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

string (int64 format)

필수 항목입니다. 인벤토리 소스의 ID입니다. InventorySource 리소스의 inventorySourceId 필드를 참조해야 합니다.

CategoryAssignedTargetingOptionDetails

할당된 카테고리 타겟팅 옵션 세부정보입니다. targetingType가 TARGETING_TYPE_CATEGORY이면 categoryDetails 필드에 채워집니다.

JSON 표현 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
필드
displayName

string

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

string

필수 항목입니다. targetingType가 TARGETING_TYPE_CATEGORY인 경우 targetingOptionId 필드
negative

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다.

ViewabilityAssignedTargetingOptionDetails

할당된 조회가능성 타겟팅 옵션 세부정보입니다. targetingType이 TARGETING_TYPE_VIEWABILITY이면 AssignedTargetingOption의 viewabilityDetails 필드에 채워집니다.

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

enum (Viewability)

예상 조회가능성 비율입니다.

v1에서만 출력됩니다. v2에서 필수입니다.
targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_VIEWABILITY 유형 TargetingOption의 targetingOptionId (예: '509010' (VIEWABILITY_10_PERCENT_OR_MORE 옵션 타겟팅)

AuthorizedSellerStatusAssignedTargetingOptionDetails

할당된 승인된 판매자 상태를 나타냅니다. targetingType이 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

리소스에 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 할당 타겟팅 옵션이 없는 경우 '승인된 직접 판매자 및 리셀러'를 사용하는 것입니다. 옵션을 선택합니다.

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

enum (AuthorizedSellerStatus)

출력 전용입니다. 타겟팅할 승인된 판매자 상태입니다.
targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 유형 TargetingOption의 targetingOptionId

LanguageAssignedTargetingOptionDetails

할당된 언어 타겟팅 옵션에 대한 세부정보입니다. targetingType이 TARGETING_TYPE_LANGUAGE인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

JSON 표현 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
필드
displayName

string

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

string

필수 항목입니다. TARGETING_TYPE_LANGUAGE 유형 TargetingOption의 targetingOptionId
negative

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다. 동일한 리소스에 할당된 모든 언어 타겟팅 옵션은 이 필드의 값이 동일해야 합니다.

GeoRegionAssignedTargetingOptionDetails

할당된 지역 타겟팅 옵션의 세부정보입니다. targetingType이 TARGETING_TYPE_GEO_REGION인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

string

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

string

필수 항목입니다. TARGETING_TYPE_GEO_REGION 유형 TargetingOption의 targetingOptionId
geoRegionType

enum (GeoRegionType)

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

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다.

InventorySourceGroupAssignedTargetingOptionDetails

인벤토리 소스 그룹의 타겟팅 세부정보입니다. targetingType이 TARGETING_TYPE_INVENTORY_SOURCE_GROUP인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

string (int64 format)

필수 항목입니다. 인벤토리 소스 그룹의 ID입니다. InventorySourceGroup 리소스의 inventorySourceGroupId 필드를 참조해야 합니다.

DigitalContentLabelAssignedTargetingOptionDetails

디지털 콘텐츠 라벨의 타겟팅 세부정보입니다. targetingType이 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

string

필수 항목입니다. 제외할 디지털 콘텐츠 라벨의 ID입니다.
contentRatingTier

enum (ContentRatingTier)

출력 전용입니다. 디지털 콘텐츠 라벨 등급 등급의 표시 이름입니다.

SensitiveCategoryAssignedTargetingOptionDetails

민감한 카테고리의 타겟팅 세부정보입니다. targetingType이 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

string

필수 항목입니다. 제외할 민감한 카테고리의 ID입니다.
sensitiveCategory

enum (SensitiveCategory)

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

ExchangeAssignedTargetingOptionDetails

할당된 거래소 타겟팅 옵션에 대한 세부정보입니다. targetingType이 TARGETING_TYPE_EXCHANGE인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

string

필수 항목입니다. TARGETING_TYPE_EXCHANGE 유형 TargetingOption의 targetingOptionId

SubExchangeAssignedTargetingOptionDetails

할당된 하위 거래소 타겟팅 옵션에 대한 세부정보입니다. targetingType이 TARGETING_TYPE_SUB_EXCHANGE인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

string

필수 항목입니다. TARGETING_TYPE_SUB_EXCHANGE 유형 TargetingOption의 targetingOptionId

ThirdPartyVerifierAssignedTargetingOptionDetails

할당된 제3자 인증업체 타겟팅 옵션 세부정보입니다. targetingType이 TARGETING_TYPE_THIRD_PARTY_VERIFIER인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

JSON 표현 
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
필드
통합 필드 verifier. 노출에 대한 브랜드 안전성 기준을 적용하기 위해 제3자 인증기관 중 하나를 타겟팅할 수 있습니다. verifier은 다음 중 하나여야 합니다.
adloox

object (Adloox)

타사 브랜드 인증업체 - Adloox
doubleVerify

object (DoubleVerify)

타사 브랜드 인증업체 -- DoubleVerify입니다.
integralAdScience

object (IntegralAdScience)

타사 브랜드 인증업체 -- Integral Ad Science

Adloox

Adloox 설정 세부정보

JSON 표현 
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
필드
excludedAdlooxCategories[]

enum (AdlooxCategory)

Adloox의 브랜드 안전성 설정

AdlooxCategory

가능한 Adloox 옵션

열거형
ADLOOX_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 Adloox 옵션을 지정하지 않습니다.
ADULT_CONTENT_HARD 성인용 콘텐츠 (하드)
ADULT_CONTENT_SOFT 성인용 콘텐츠 (소프트)
ILLEGAL_CONTENT 불법 콘텐츠
BORDERLINE_CONTENT 정책 위반 가능성이 있는 콘텐츠
DISCRIMINATORY_CONTENT 차별적 콘텐츠.
VIOLENT_CONTENT_WEAPONS 폭력적인 콘텐츠 및 무기입니다.
LOW_VIEWABILITY_DOMAINS 조회 가능성이 낮은 도메인
FRAUD 사기.

DoubleVerify

DoubleVerify 설정 세부정보입니다.

JSON 표현 
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
필드
brandSafetyCategories

object (BrandSafetyCategories)

DV 브랜드 안전 제어
avoidedAgeRatings[]

enum (AgeRating)

연령 등급이 있는 앱에 입찰하지 마세요.
appStarRating

object (AppStarRating)

별표 평점이 있는 앱에 입찰하지 마세요.
displayViewability

object (DisplayViewability)

표시 조회가능성 설정 (디스플레이 광고 항목에만 해당)
videoViewability

object (VideoViewability)

동영상 조회가능성 설정 (동영상 광고 항목에만 적용)
fraudInvalidTraffic

object (FraudInvalidTraffic)

과거에 사기와 발생이 있었던 사이트 및 앱 피하기 IVT 요율.
customSegmentId

string (int64 format)

DoubleVerify에서 제공한 맞춤 세그먼트 ID입니다. ID는 '51'로 시작해야 합니다. 8자리 숫자로 구성됩니다. 맞춤 세그먼트 ID는 다음 필드와 함께 지정할 수 없습니다.

BrandSafetyCategories

브랜드 안전성 관리 기능 설정입니다.

JSON 표현 
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
필드
avoidUnknownBrandSafetyCategory

boolean

알 수 없거나 평가할 수 없습니다.
avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

브랜드 안전성 높은 심각도 회피 카테고리입니다.
avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

브랜드 안전성 보통 심각도 회피 카테고리입니다.

HighSeverityCategory

심각도가 높은 카테고리에 가능한 옵션입니다.

열거형
HIGHER_SEVERITY_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 심각도가 높은 카테고리를 지정하지 않습니다.
ADULT_CONTENT_PORNOGRAPHY 성인용 콘텐츠: 포르노, 성인용 주제, 과도한 노출.
COPYRIGHT_INFRINGEMENT 저작권 침해.
SUBSTANCE_ABUSE 마약/주류/통제 물질: 약물 남용
GRAPHIC_VIOLENCE_WEAPONS 지나치게 노골적이거나 노골적인/노골적인 폭력/무기
HATE_PROFANITY 증오/욕설.
CRIMINAL_SKILLS 불법 행위: 범죄 기술.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER 인센티브 제공/멀웨어/혼잡성.

MediumSeverityCategory

심각도가 보통인 카테고리에 가능한 옵션입니다.

열거형
MEDIUM_SEVERITY_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 보통 심각도 카테고리를 지정하지 않습니다.
AD_SERVERS 광고 서버.
ADULT_CONTENT_SWIMSUIT 성인용 콘텐츠: 수영복.
ALTERNATIVE_LIFESTYLES 논란이 많은 주제: 대체 라이프스타일
CELEBRITY_GOSSIP 논란이 많은 주제: 유명인 가십
GAMBLING 논란이 많은 주제: 도박
OCCULT 논란이 많은 주제: 오컬트.
SEX_EDUCATION 논란이 많은 주제: 성교육
DISASTER_AVIATION 재해: 항공.
DISASTER_MAN_MADE 재해: 인재
DISASTER_NATURAL 재해: 자연재해.
DISASTER_TERRORIST_EVENTS 재해: 테러 사건.
DISASTER_VEHICLE 재해: 차량.
ALCOHOL 마약/주류/통제 물질: 주류.
SMOKING 마약/주류/통제 물질: 흡연
NEGATIVE_NEWS_FINANCIAL 부정적인 뉴스: 금융.
NON_ENGLISH 비표준 콘텐츠: 영어 이외
PARKING_PAGE 비표준 콘텐츠: 파킹 페이지
UNMODERATED_UGC 운영자가 없는 UGC: 포럼, 이미지, 동영상.
INFLAMMATORY_POLITICS_AND_NEWS 논란이 많은 주제: 선동적인 정치 및 뉴스
NEGATIVE_NEWS_PHARMACEUTICAL 부정적인 뉴스: 의약품.

AgeRating

연령 등급에 사용할 수 있는 옵션입니다.

열거형
AGE_RATING_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 연령 등급 옵션을 지정하지 않습니다.
APP_AGE_RATE_UNKNOWN 연령 등급을 알 수 없는 앱
APP_AGE_RATE_4_PLUS 전체이용가 등급 (4세 이상) 앱
APP_AGE_RATE_9_PLUS 전체이용가 등급 (9세 이상) 앱
APP_AGE_RATE_12_PLUS 청소년용 앱 (12세 이상)
APP_AGE_RATE_17_PLUS 성인용 등급 앱 (만 17세 이상)
APP_AGE_RATE_18_PLUS 성인 전용 등급 앱 (만 18세 이상)

AppStarRating

DoubleVerify 별표 평점 설정 세부정보입니다.

JSON 표현 
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
필드
avoidedStarRating

enum (StarRating)

별표 평점이 있는 앱에 입찰하지 마세요.
avoidInsufficientStarRating

boolean

별표 평점이 충분하지 않은 앱에는 입찰하지 마세요.

StarRating

별표 평점에 사용할 수 있는 옵션입니다.

열거형
APP_STAR_RATE_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 앱 별표 평점 옵션을 지정하지 않습니다.
APP_STAR_RATE_1_POINT_5_LESS 다음 등급의 공식 앱 < 별 1.5개.
APP_STAR_RATE_2_LESS 다음 등급의 공식 앱 < 별 2개
APP_STAR_RATE_2_POINT_5_LESS 다음 등급의 공식 앱 < 별 2.5개.
APP_STAR_RATE_3_LESS 다음 등급의 공식 앱 < 별 3개
APP_STAR_RATE_3_POINT_5_LESS 다음 등급의 공식 앱 < 별 3.5개.
APP_STAR_RATE_4_LESS 다음 등급의 공식 앱 < 별 4개
APP_STAR_RATE_4_POINT_5_LESS 다음 등급의 공식 앱 < 별 4.5개.

DisplayViewability

DoubleVerify 디스플레이 조회가능성 설정 세부정보입니다.

JSON 표현 
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
필드
iab

enum (IAB)

웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 극대화합니다.
viewableDuring

enum (ViewableDuring)

웹 및 앱 인벤토리를 타겟팅하여 100% 조회 가능 기간을 극대화합니다.

IAB

IAB 조회가능 노출률에 사용할 수 있는 옵션입니다.

열거형
IAB_VIEWED_RATE_UNSPECIFIED 이 열거형은 자리표시자일 뿐이며 IAB 조회율 옵션을 지정하지 않습니다.
IAB_VIEWED_RATE_80_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 80% 이상 극대화합니다.
IAB_VIEWED_RATE_75_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 75% 이상 극대화합니다.
IAB_VIEWED_RATE_70_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 70% 이상 극대화합니다.
IAB_VIEWED_RATE_65_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 65% 이상 극대화합니다.
IAB_VIEWED_RATE_60_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 60% 이상 극대화합니다.
IAB_VIEWED_RATE_55_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 55% 이상 극대화합니다.
IAB_VIEWED_RATE_50_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 50% 이상 극대화합니다.
IAB_VIEWED_RATE_40_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 40% 이상 극대화합니다.
IAB_VIEWED_RATE_30_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 30% 이상 극대화합니다.

ViewableDuring

조회 가능 기간에 사용할 수 있는 옵션입니다.

열거형
AVERAGE_VIEW_DURATION_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 평균 시청 지속 시간 옵션을 지정하지 않습니다.
AVERAGE_VIEW_DURATION_5_SEC 웹 및 앱 인벤토리를 타겟팅하여 5초 이상의 조회 가능 시간을 100% 극대화합니다.
AVERAGE_VIEW_DURATION_10_SEC 웹 및 앱 인벤토리를 타겟팅하여 10초 이상의 조회 가능 시간을 100% 극대화합니다.
AVERAGE_VIEW_DURATION_15_SEC 웹 및 앱 인벤토리를 타겟팅하여 15초 이상의 조회 가능 시간을 100% 극대화합니다.

VideoViewability

DoubleVerify 동영상 조회가능성 설정 세부정보입니다.

JSON 표현 
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
필드
videoIab

enum (VideoIAB)

웹 인벤토리를 타겟팅하여 IAB 조회가능 노출률을 극대화합니다.
videoViewableRate

enum (VideoViewableRate)

웹 인벤토리를 타겟팅하여 전체 조회가능 노출률을 극대화합니다.
playerImpressionRate

enum (PlayerImpressionRate)

플레이어 크기가 400x300 이상인 노출수를 최대화하도록 인벤토리를 타겟팅합니다.

VideoIAB

IAB 조회가능 노출률의 가능한 옵션입니다.

열거형
VIDEO_IAB_UNSPECIFIED 이 열거형은 자리표시자일 뿐이며 동영상 IAB 조회가능 노출률 옵션을 지정하지 않습니다.
IAB_VIEWABILITY_80_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 80% 이상 극대화합니다.
IAB_VIEWABILITY_75_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 75% 이상 극대화합니다.
IAB_VIEWABILITY_70_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 70% 이상 극대화합니다.
IAB_VIEWABILITY_65_PERCENT_HIHGER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 65% 이상 극대화합니다.
IAB_VIEWABILITY_60_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 60% 이상 극대화합니다.
IAB_VIEWABILITY_55_PERCENT_HIHGER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 55% 이상 극대화합니다.
IAB_VIEWABILITY_50_PERCENT_HIGHER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 50% 이상 극대화합니다.
IAB_VIEWABILITY_40_PERCENT_HIHGER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 40% 이상 극대화합니다.
IAB_VIEWABILITY_30_PERCENT_HIHGER 웹 및 앱 인벤토리를 타겟팅하여 IAB 조회 가능 비율을 30% 이상 극대화합니다.

VideoViewableRate

전체 조회가능 노출률 중에서 선택할 수 있는 옵션입니다.

열거형
VIDEO_VIEWABLE_RATE_UNSPECIFIED 이 열거형은 자리표시자일 뿐이며 동영상 조회가능 노출률 옵션을 지정하지 않습니다.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER 웹 인벤토리를 타겟팅하여 전체 조회가능 비율을 40% 이상으로 극대화합니다.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER 웹 인벤토리를 타겟팅하여 전체 조회가능 비율을 35% 이상으로 극대화합니다.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER 웹 인벤토리를 타겟팅하여 전체 조회가능 비율을 30% 이상으로 극대화합니다.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER 웹 인벤토리를 타겟팅하여 전체 조회가능 비율을 25% 이상으로 극대화합니다.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER 웹 인벤토리를 타겟팅하여 전체 조회가능 비율을 20% 이상으로 극대화합니다.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER 웹 인벤토리를 타겟팅하여 전체 조회가능 비율을 10% 이상으로 극대화합니다.

PlayerImpressionRate

가능한 노출 옵션입니다.

열거형
PLAYER_SIZE_400X300_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 노출 옵션을 지정하지 않습니다.
PLAYER_SIZE_400X300_95 노출수가 95%이상인 사이트
PLAYER_SIZE_400X300_70 노출수가 70%이상인 사이트
PLAYER_SIZE_400X300_25 노출수가 25%이상인 사이트
PLAYER_SIZE_400X300_5 노출수가 5%이상인 사이트

FraudInvalidTraffic

DoubleVerify 사기 및 트래픽 설정이 잘못되었습니다.

JSON 표현 
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
필드
avoidedFraudOption

enum (FraudOption)

과거에 사기와 발생이 있었던 사이트 및 앱 피하기 무효 트래픽
avoidInsufficientOption

boolean

과거 사기 및 IVT 통계

FraudOption

이전 사기 및 IVT 비율

열거형
FRAUD_UNSPECIFIED 이 열거형은 자리표시자일 뿐이며 사기 및 무효 트래픽 옵션을 지정하지 않습니다.
AD_IMPRESSION_FRAUD_100 100% 사기 및 무효 트래픽
AD_IMPRESSION_FRAUD_50 50% 이상 사기 및 무효 트래픽
AD_IMPRESSION_FRAUD_25 25% 이상 사기 및 무효 트래픽
AD_IMPRESSION_FRAUD_10 10% 이상 사기 및 무효 트래픽
AD_IMPRESSION_FRAUD_8 8% 이상 사기 및 무효 트래픽
AD_IMPRESSION_FRAUD_6 6% 이상 사기 및 무효 트래픽
AD_IMPRESSION_FRAUD_4 4% 이상 사기 및 무효 트래픽
AD_IMPRESSION_FRAUD_2 2% 이상 사기 및 무효 트래픽

IntegralAdScience

Integral Ad Science 설정 세부정보

JSON 표현 
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}
필드
traqScoreOption

enum (TRAQScore)

실제 광고 품질 (디스플레이 광고 항목에만 해당)
excludeUnrateable

boolean

브랜드 안전성 - 등급 판정 불가
excludedAdultRisk

enum (Adult)

브랜드 안전성: 성인용 콘텐츠.
excludedAlcoholRisk

enum (Alcohol)

브랜드 안전성 - 주류
excludedIllegalDownloadsRisk

enum (IllegalDownloads)

브랜드 안전성 - 불법 다운로드.
excludedDrugsRisk

enum (Drugs)

브랜드 안전성 - 약물.
excludedHateSpeechRisk

enum (HateSpeech)

브랜드 안전성 - 증오심 표현.
excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

브랜드 안전성 - 불쾌감을 주는 표현
excludedViolenceRisk

enum (Violence)

브랜드 안전성 - 폭력.
excludedGamblingRisk

enum (Gambling)

브랜드 안전성 - 도박
excludedAdFraudRisk

enum (AdFraudPrevention)

광고 사기 설정.
displayViewability

enum (DisplayViewability)

조회가능성 섹션 표시 (광고 항목을 표시하는 경우에만 해당)
videoViewability

enum (VideoViewability)

동영상 조회가능성 섹션 (동영상 광고 항목에만 해당)
customSegmentId[]

string (int64 format)

Integral Ad Science에서 제공한 맞춤 세그먼트 ID입니다. ID는 1000001 이상 1999999 이하여야 합니다.

TRAQScore

가능한 Integral Ad Science TRAQ (실제 광고 품질) 점수 범위입니다.

열거형
TRAQ_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 실제 광고 품질평가점수를 지정하지는 않습니다.
TRAQ_250 TRAQ 점수는 250~1000점입니다.
TRAQ_500 TRAQ 점수는 500~1000점입니다.
TRAQ_600 TRAQ 점수는 600~1000입니다.
TRAQ_700 TRAQ 점수는 700~1000입니다.
TRAQ_750 TRAQ 점수는 750~1000입니다.
TRAQ_875 TRAQ 점수는 875~1000점입니다.
TRAQ_1000 TRAQ 점수 1000입니다.

성인

가능한 Integral Ad Science 성인용 옵션

열거형
ADULT_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 성인용 옵션을 지정하지 않습니다.
ADULT_HR 성인 - 높은 위험도 제외.
ADULT_HMR 성인 - 높은 위험도 및 중간 위험도 제외.

주류

가능한 Integral Ad Science 주류 옵션입니다.

열거형
ALCOHOL_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 주류 옵션을 지정하지 않습니다.
ALCOHOL_HR 주류 - 높은 위험도 제외.
ALCOHOL_HMR 주류 - 높은 위험도 및 중간 위험도 제외.

IllegalDownloads

가능한 Integral Ad Science 불법 다운로드 옵션

열거형
ILLEGAL_DOWNLOADS_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 잘못된 다운로드 옵션을 지정하지 않습니다.
ILLEGAL_DOWNLOADS_HR 불법 다운로드 - 높은 위험도 제외
ILLEGAL_DOWNLOADS_HMR 불법 다운로드 - 높은 위험도 및 중간 위험도 제외.

마약

가능한 Integral Ad Science 의약품 옵션

열거형
DRUGS_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 약물 옵션을 지정하지 않습니다.
DRUGS_HR 마약 - 높은 위험도 제외.
DRUGS_HMR 약물 - 높은 위험도 및 중간 위험도 제외.

HateSpeech

가능한 Integral Ad Science 증오심 표현 옵션

열거형
HATE_SPEECH_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 증오심 표현 옵션을 지정하지 않습니다.
HATE_SPEECH_HR 증오심 표현 - 높은 위험도 제외.
HATE_SPEECH_HMR 증오심 표현 - 높은 위험도 및 중간 위험도 제외.

OffensiveLanguage

가능한 Integral Ad Science 불쾌감을 주는 언어 옵션입니다.

열거형
OFFENSIVE_LANGUAGE_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 언어 옵션을 지정하지 않습니다.
OFFENSIVE_LANGUAGE_HR 불쾌감을 주는 표현 - 높은 위험도 제외
OFFENSIVE_LANGUAGE_HMR 불쾌감을 주는 표현 - 높은 위험도 및 중간 위험도 제외.

폭력

가능한 Integral Ad Science 폭력 옵션

열거형
VIOLENCE_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 폭력 옵션을 지정하지 않습니다.
VIOLENCE_HR 폭력 - 높은 위험도 제외.
VIOLENCE_HMR 폭력 - 높은 위험도 및 중간 위험도 제외.

도박

가능한 Integral Ad Science 도박 옵션

열거형
GAMBLING_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 도박 옵션을 지정하지 않습니다.
GAMBLING_HR 도박 - 높은 위험도 제외.
GAMBLING_HMR 도박 - 높은 위험도 및 중간 위험도 제외.

AdFraudPrevention

가능한 Integral Ad Science 광고 사기 예방 옵션입니다.

열거형
SUSPICIOUS_ACTIVITY_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 광고 사기 방지 옵션을 지정하지 않습니다.
SUSPICIOUS_ACTIVITY_HR 광고 사기 - 높은 위험 요소를 제외합니다.
SUSPICIOUS_ACTIVITY_HMR 광고 사기 - 높은 위험도 및 중간 위험도 제외.

DisplayViewability

가능한 Integral Ad Science 디스플레이 조회 가능성 옵션입니다.

열거형
PERFORMANCE_VIEWABILITY_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 디스플레이 조회 가능성 옵션을 지정하지 않습니다.
PERFORMANCE_VIEWABILITY_40 40% 이상 조회가능성 타겟팅
PERFORMANCE_VIEWABILITY_50 50% 이상 조회가능성 타겟팅
PERFORMANCE_VIEWABILITY_60 60% 이상 조회가능성 타겟팅
PERFORMANCE_VIEWABILITY_70 70% 이상 조회가능성 타겟팅

VideoViewability

가능한 Integral Ad Science 동영상 조회가능성 옵션입니다.

열거형
VIDEO_VIEWABILITY_UNSPECIFIED 이 enum은 자리표시자일 뿐이며 동영상 조회 가능성 옵션을 지정하지 않습니다.
VIDEO_VIEWABILITY_40 40%이상 조회 (IAB 동영상 조회가능성 표준)
VIDEO_VIEWABILITY_50 50%이상 조회 (IAB 동영상 조회가능성 표준)
VIDEO_VIEWABILITY_60 60%이상 조회 (IAB 동영상 조회가능성 표준)
VIDEO_VIEWABILITY_70 70%이상 조회 (IAB 동영상 조회가능성 표준)

PoiAssignedTargetingOptionDetails

할당된 관심 장소 타겟팅 옵션에 대한 세부정보입니다. targetingType이 TARGETING_TYPE_POI인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

JSON 표현 
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
필드
displayName

string

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

string

필수 항목입니다. TARGETING_TYPE_POI 유형 TargetingOption의 targetingOptionId

허용되는 관심 장소 타겟팅 옵션 ID는 SearchTargetingOptions를 사용하여 가져올 수 있습니다.

특정 위도/경도 좌표를 주소 또는 관심 장소 이름에서 삭제한 경우, 원하는 좌표 값을 소수점 6자리로 반올림하고 소수점 이하 자릿수를 삭제한 후 세미콜론으로 구분된 문자열 값을 연결하여 필요한 타겟팅 옵션 ID를 생성할 수 있습니다. 예를 들어, 타겟팅 옵션 ID '40741469;-74003387'을 사용하여 40.7414691, -74.003387의 위도/경도 쌍을 타겟팅할 수 있습니다.
latitude

number

출력 전용입니다. 6번째 소수점 이하 6자리로 반올림한 관심 장소 위도입니다.
longitude

number

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

number

필수 항목입니다. 타겟팅할 관심 장소 주변 지역의 반경입니다. 반경의 단위는 proximityRadiusUnit로 지정됩니다. 단위가 DISTANCE_UNIT_KILOMETERS이면 1~800이고, 단위가 DISTANCE_UNIT_MILES이면 1~500이어야 합니다.
proximityRadiusUnit

enum (DistanceUnit)

필수 항목입니다. 타겟팅 반경이 측정되는 거리 단위입니다.

DistanceUnit

가능한 거리 단위 옵션입니다.

열거형
DISTANCE_UNIT_UNSPECIFIED 유형 값이 지정되지 않았거나 이 버전에서 알 수 없습니다.
DISTANCE_UNIT_MILES 마일
DISTANCE_UNIT_KILOMETERS 킬로미터를 선택하세요.

BusinessChainAssignedTargetingOptionDetails

할당된 비즈니스 체인 타겟팅 옵션의 세부정보입니다. targetingType이 TARGETING_TYPE_BUSINESS_CHAIN인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

JSON 표현 
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
필드
displayName

string

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

string

필수 항목입니다. TARGETING_TYPE_BUSINESS_CHAIN 유형 TargetingOption의 targetingOptionId

허용되는 비즈니스 체인 타겟팅 옵션 ID는 SearchTargetingOptions를 사용하여 가져올 수 있습니다.
proximityRadiusAmount

number

필수 항목입니다. 타겟팅할 비즈니스 체인 주변 지역의 반경입니다. 반경의 단위는 proximityRadiusUnit로 지정됩니다. 단위가 DISTANCE_UNIT_KILOMETERS이면 1~800이고, 단위가 DISTANCE_UNIT_MILES이면 1~500이어야 합니다. 두 경우 모두 최소 증분은 0.1입니다. 입력 값이 너무 세분화되면 허용되는 가장 가까운 값으로 반올림됩니다(예: 15.57은 15.6이 됩니다.
proximityRadiusUnit

enum (DistanceUnit)

필수 항목입니다. 타겟팅 반경이 측정되는 거리 단위입니다.

ContentDurationAssignedTargetingOptionDetails

콘텐츠 길이에 할당된 타겟팅 옵션에 대한 세부정보입니다. targetingType가 TARGETING_TYPE_CONTENT_DURATION이면 contentDurationDetails 필드에 채워집니다. 모든 옵션을 명시적으로 타겟팅하는 기능은 지원되지 않습니다. 이 효과를 얻으려면 모든 콘텐츠 재생 시간 타겟팅 옵션을 삭제하세요.

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

string

필수 항목입니다. targetingType가 TARGETING_TYPE_CONTENT_DURATION인 경우 targetingOptionId 필드
contentDuration

enum (ContentDuration)

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

ContentStreamTypeAssignedTargetingOptionDetails

타겟팅 옵션이 할당된 콘텐츠 스트림 유형에 대한 세부정보입니다. targetingType가 TARGETING_TYPE_CONTENT_STREAM_TYPE이면 contentStreamTypeDetails 필드에 채워집니다. 모든 옵션을 명시적으로 타겟팅하는 기능은 지원되지 않습니다. 이 효과를 얻으려면 모든 콘텐츠 스트림 유형 타겟팅 옵션을 삭제하세요.

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

string

필수 항목입니다. targetingType가 TARGETING_TYPE_CONTENT_STREAM_TYPE인 경우 targetingOptionId 필드
contentStreamType

enum (ContentStreamType)

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

NativeContentPositionAssignedTargetingOptionDetails

네이티브 콘텐츠 게재위치가 할당된 타겟팅 옵션에 대한 세부정보입니다. targetingType가 TARGETING_TYPE_NATIVE_CONTENT_POSITION이면 nativeContentPositionDetails 필드에 채워집니다. 모든 옵션을 명시적으로 타겟팅하는 기능은 지원되지 않습니다. 이 효과를 얻으려면 모든 네이티브 콘텐츠 게재위치 타겟팅 옵션을 삭제하세요.

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

string

필수 항목입니다. targetingType가 TARGETING_TYPE_NATIVE_CONTENT_POSITION인 경우 targetingOptionId 필드
contentPosition

enum (NativeContentPosition)

콘텐츠 위치입니다.

v1에서만 출력됩니다. v2에서 필수입니다.

OmidAssignedTargetingOptionDetails

타겟팅 가능한 Open Measurement가 사용 설정된 인벤토리 유형을 나타냅니다. targetingType이 TARGETING_TYPE_OMID인 경우 AssignedTargetingOption의 세부정보 필드에 입력됩니다.

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

enum (Omid)

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

v1에서만 출력됩니다. v2에서 필수입니다.
targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_OMID 유형 TargetingOption의 targetingOptionId

AudioContentTypeAssignedTargetingOptionDetails

오디오 콘텐츠 유형에 할당된 타겟팅 옵션에 대한 세부정보입니다. targetingType가 TARGETING_TYPE_AUDIO_CONTENT_TYPE이면 audioContentTypeDetails 필드에 채워집니다. 모든 옵션을 명시적으로 타겟팅하는 기능은 지원되지 않습니다. 이 효과를 얻으려면 모든 오디오 콘텐츠 유형 타겟팅 옵션을 삭제하세요.

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

string

필수 항목입니다. targetingType가 TARGETING_TYPE_AUDIO_CONTENT_TYPE인 경우 targetingOptionId 필드
audioContentType

enum (AudioContentType)

오디오 콘텐츠 유형입니다.

v1에서만 출력됩니다. v2에서 필수입니다.

ContentGenreAssignedTargetingOptionDetails

콘텐츠 장르 할당 타겟팅 옵션에 대한 세부정보입니다. targetingType가 TARGETING_TYPE_CONTENT_GENRE이면 contentGenreDetails 필드에 채워집니다. 모든 옵션을 명시적으로 타겟팅하는 기능은 지원되지 않습니다. 이 효과를 얻으려면 모든 콘텐츠 장르 타겟팅 옵션을 삭제하세요.

JSON 표현 
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
필드
targetingOptionId

string

필수 항목입니다. targetingType가 TARGETING_TYPE_CONTENT_GENRE인 경우 targetingOptionId 필드
displayName

string

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

boolean

이 옵션이 제외 타겟팅되고 있는지를 나타냅니다.

메서드

get

 캠페인에 할당된 단일 타겟팅 옵션을 가져옵니다.

list

 지정된 타겟팅 유형에 대해 캠페인에 할당된 타겟팅 옵션을 나열합니다.