REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

리소스: AssignedTargetingOption

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

JSON 표현
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": 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)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
입력란
name

string

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

assignedTargetingOptionId

string

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

assignedTargetingOptionIdAlias

string

출력 전용. assignedTargetingOptionId의 별칭입니다. 기존 타겟팅을 검색하거나 삭제할 때 이 값을 assignedTargetingOptionId 대신 사용할 수 있습니다.

이 필드는 다음 타겟팅 유형에 할당된 모든 타겟팅 옵션에만 지원됩니다.

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

이 입력란은 다음 타겟팅 유형의 광고 항목에 할당된 타겟팅 옵션에 대해서도 지원됩니다.

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

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

inheritance

enum (Inheritance)

출력 전용. 할당된 타겟팅 옵션의 상속 상태입니다.

통합 필드 details. 할당되는 타겟팅 옵션에 대한 세부정보입니다. 세부정보의 필드 하나만 작성할 수 있으며 targeting_type에 해당해야 합니다. details는 다음 중 하나여야 합니다.
channelDetails

object (ChannelAssignedTargetingOptionDetails)

채널 세부정보 이 필드는 targetingTypeTARGETING_TYPE_CHANNEL일 때 채워집니다.

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

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

appDetails

object (AppAssignedTargetingOptionDetails)

앱 세부정보 이 필드는 targetingTypeTARGETING_TYPE_APP일 때 채워집니다.

urlDetails

object (UrlAssignedTargetingOptionDetails)

URL 세부정보 이 필드는 targetingTypeTARGETING_TYPE_URL일 때 채워집니다.

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

날짜 및 시간 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_DAY_AND_TIME일 때 채워집니다.

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

연령대 세부정보 이 필드는 targetingTypeTARGETING_TYPE_AGE_RANGE일 때 채워집니다.

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

지역 위치 목록 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_REGIONAL_LOCATION_LIST일 때 채워집니다.

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

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

genderDetails

object (GenderAssignedTargetingOptionDetails)

성별 세부정보 이 필드는 targetingTypeTARGETING_TYPE_GENDER일 때 채워집니다.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

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

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

사용자 보상형 콘텐츠 세부정보 이 필드는 targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT일 때 채워집니다.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

자녀 유무 세부정보 이 필드는 targetingTypeTARGETING_TYPE_PARENTAL_STATUS일 때 채워집니다.

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

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

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

콘텐츠 아웃스트림 게재위치 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION일 때 채워집니다.

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

기기 유형 세부정보 이 필드는 targetingTypeTARGETING_TYPE_DEVICE_TYPE일 때 채워집니다.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

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

browserDetails

object (BrowserAssignedTargetingOptionDetails)

브라우저 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_BROWSER일 때 채워집니다.

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

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

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

화면의 위치 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION일 때 채워집니다.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

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

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

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

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

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

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

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

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

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

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

환경 세부정보 이 필드는 targetingTypeTARGETING_TYPE_ENVIRONMENT일 때 채워집니다.

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

인벤토리 소스 세부정보 이 필드는 targetingTypeTARGETING_TYPE_INVENTORY_SOURCE일 때 채워집니다.

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

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

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

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

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

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

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

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

리소스에 승인된 판매자 상태 옵션이 없으면 ads.txt 파일에 직접 또는 리셀러로 표시된 모든 승인된 판매자가 기본적으로 타겟팅됩니다.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

언어 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_LANGUAGE일 때 채워집니다.

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

지리적 리전 세부정보 이 필드는 targetingTypeTARGETING_TYPE_GEO_REGION일 때 채워집니다.

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

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

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

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

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

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Exchange 세부정보 이 필드는 targetingTypeTARGETING_TYPE_EXCHANGE일 때 채워집니다.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

poiDetails

object (PoiAssignedTargetingOptionDetails)

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

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

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

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

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

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

네이티브 콘텐츠 게재순위 세부정보 이 필드는 targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION일 때 채워집니다.

omidDetails

object (OmidAssignedTargetingOptionDetails)

Open Measurement가 사용 설정된 인벤토리 세부정보 이 필드는 targetingTypeTARGETING_TYPE_OMID일 때 채워집니다.

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

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

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

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

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

YouTube 동영상 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_YOUTUBE_VIDEO일 때 채워집니다.

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

YouTube 채널 세부정보 이 필드는 targetingTypeTARGETING_TYPE_YOUTUBE_CHANNEL일 때 채워집니다.

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

세션 위치 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_SESSION_POSITION일 때 채워집니다.

상속

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

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

ChannelAssignedTargetingOptionDetails

할당된 채널 타겟팅 옵션에 대한 세부정보입니다. targetingTypeTARGETING_TYPE_CHANNEL일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "channelId": string,
  "negative": boolean
}
입력란
channelId

string (int64 format)

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

negative

boolean

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

AppCategoryAssignedTargetingOptionDetails

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

JSON 표현
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
입력란
displayName

string

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

targetingOptionId

string

필수 항목입니다. targetingTypeTARGETING_TYPE_APP_CATEGORY인 경우 targetingOptionId 필드

negative

boolean

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

AppAssignedTargetingOptionDetails

할당된 앱 타겟팅 옵션의 세부정보입니다. targetingTypeTARGETING_TYPE_APP일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
입력란
appId

string

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

Android의 Play 스토어 앱은 번들 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 이 버전에 앱 플랫폼이 지정되지 않은 경우의 기본값입니다. 이 열거형은 기본값의 자리표시자이며 실제 플랫폼 옵션을 나타내지 않습니다.
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 타겟팅 옵션에 대한 세부정보입니다. targetingTypeTARGETING_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 (종료 시간) 사이여야 합니다.

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

타겟팅 가능한 연령대를 나타냅니다. targetingTypeTARGETING_TYPE_AGE_RANGE일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "ageRange": enum (AgeRange)
}
입력란
ageRange

enum (AgeRange)

필수 항목입니다. 잠재고객의 연령대입니다. YouTube에서는 특정 연령대의 잠재고객에 대한 타겟팅만 지원합니다. 따라서 이 입력란에 표시되는 연령대는 1) 단독으로 타겟팅되거나 2) 더 큰 연속된 연령대의 일부일 수 있습니다. 연령을 알 수 없는 잠재고객까지 타겟팅하면 지속적인 연령대 타겟팅의 도달범위를 확장할 수 있습니다.

RegionalLocationListAssignedTargetingOptionDetails

지역 위치 목록의 타겟팅 세부정보입니다. targetingTypeTARGETING_TYPE_REGIONAL_LOCATION_LIST일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "regionalLocationListId": string,
  "negative": boolean
}
입력란
regionalLocationListId

string (int64 format)

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

negative

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

인접 위치 목록의 타겟팅 세부정보입니다. targetingTypeTARGETING_TYPE_PROXIMITY_LOCATION_LIST일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
입력란
proximityLocationListId

string (int64 format)

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

proximityRadius

number

필수 항목입니다. proximityRadiusUnit에 설정된 거리 단위로 표시된 반경입니다. 선택된 위치 주변에서 타겟팅될 지역의 크기를 나타냅니다. 반경은 1~500마일 또는 800킬로미터 사이여야 합니다.

proximityRadiusUnit

enum (ProximityRadiusUnit)

필수 항목입니다. 반경 거리 단위입니다.

ProximityRadiusUnit

ProximityRadius의 거리 단위 enum입니다.

열거형
PROXIMITY_RADIUS_UNIT_UNSPECIFIED 이 버전에 거리 단위가 지정되지 않은 경우의 기본값입니다. 이 enum은 기본값의 자리표시자이며 실제 거리 단위를 나타내지 않습니다.
PROXIMITY_RADIUS_UNIT_MILES 반경 거리 단위(마일)
PROXIMITY_RADIUS_UNIT_KILOMETERS 반경 거리 단위(킬로미터)

GenderAssignedTargetingOptionDetails

할당된 성별 타겟팅 옵션에 대한 세부정보입니다. targetingTypeTARGETING_TYPE_GENDER일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "gender": enum (Gender)
}
입력란
gender

enum (Gender)

필수 항목입니다. 잠재고객의 성별입니다.

VideoPlayerSizeAssignedTargetingOptionDetails

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

JSON 표현
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
입력란
videoPlayerSize

enum (VideoPlayerSize)

필수 항목입니다. 동영상 플레이어 크기입니다.

UserRewardedContentAssignedTargetingOptionDetails

사용자 보상형 콘텐츠 타겟팅 옵션 세부정보 targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT일 때 userRewardedContentDetails 필드에 채워집니다.

JSON 표현
{
  "targetingOptionId": string,
  "userRewardedContent": enum (UserRewardedContent)
}
입력란
targetingOptionId

string

필수 항목입니다. targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT인 경우 targetingOptionId 필드

userRewardedContent

enum (UserRewardedContent)

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

ParentalStatusAssignedTargetingOptionDetails

할당된 자녀 유무 타겟팅 옵션의 세부정보입니다. targetingTypeTARGETING_TYPE_PARENTAL_STATUS일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "parentalStatus": enum (ParentalStatus)
}
입력란
parentalStatus

enum (ParentalStatus)

필수 항목입니다. 잠재고객의 자녀 유무 상태입니다.

ContentInstreamPositionAssignedTargetingOptionDetails

할당된 콘텐츠 인스트림 게재위치 타겟팅 옵션 세부정보입니다. targetingTypeTARGETING_TYPE_CONTENT_INSTREAM_POSITION일 때 contentInstreamPositionDetails 필드에 채워집니다.

JSON 표현
{
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
입력란
contentInstreamPosition

enum (ContentInstreamPosition)

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

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 이미지 및 HTML5와 같은 디스플레이 광고 소재입니다.
AD_TYPE_VIDEO 동영상 광고 소재(예: 동영상 플레이어에서 콘텐츠가 스트리밍되는 동안 재생되는 동영상 광고)
AD_TYPE_AUDIO 오디오 광고 소재(예: 오디오 콘텐츠 중간에 재생되는 오디오 광고)

ContentOutstreamPositionAssignedTargetingOptionDetails

콘텐츠 아웃스트림 게재위치 타겟팅 옵션 세부정보가 할당되었습니다. targetingTypeTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION일 때 contentOutstreamPositionDetails 필드에 채워집니다.

JSON 표현
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
입력란
contentOutstreamPosition

enum (ContentOutstreamPosition)

필수 항목입니다. 콘텐츠 아웃스트림 게재위치입니다.

adType

enum (AdType)

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

  • AD_TYPE_DISPLAY: lineItemType이(가) LINE_ITEM_TYPE_DISPLAY_DEFAULT이면 새 광고 항목에 설정이 상속됩니다.
  • AD_TYPE_VIDEO: lineItemType이(가) LINE_ITEM_TYPE_VIDEO_DEFAULT이면 새 광고 항목에 설정이 상속됩니다.

DeviceTypeAssignedTargetingOptionDetails

기기 유형의 타겟팅 세부정보입니다. targetingTypeTARGETING_TYPE_DEVICE_TYPE일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
입력란
deviceType

enum (DeviceType)

필수 항목입니다. 기기 유형의 표시 이름입니다.

youtubeAndPartnersBidMultiplier

number

출력 전용. 입찰 배율을 사용하면 기기 유형에 따라 광고 게재 빈도를 늘리거나 줄일 수 있습니다. 원래 입찰가에 배율이 적용됩니다. 이 필드가 0인 경우, 원래 입찰가에 0을 곱하는 대신 이 필드를 적용할 수 없음을 나타냅니다.

예를 들어 배율이 없는 입찰가가 10.0달러이고 배율이 태블릿에서 1.5이면 태블릿의 최종 입찰가는 15달러가 됩니다.

YouTube 및 파트너 광고 항목에만 적용됩니다.

AudienceGroupAssignedTargetingOptionDetails

할당된 잠재고객 그룹 타겟팅 옵션 세부정보입니다. targetingTypeTARGETING_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만 포함됩니다. 각 퍼스트 파티 잠재고객 그룹과 서드 파티 잠재고객 그룹 간의 관계는 subnet이며, 그 결과는 다른 잠재고객 그룹과 합쳐집니다. 설정이 동일한 반복되는 그룹은 무시됩니다.

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

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

includedCustomListGroup

object (CustomListGroup)

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

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

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

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

제외된 퍼스트 파티 및 서드 파티 잠재고객 그룹의 퍼스트 파티 및 서드 파티 잠재고객 ID 및 날짜입니다. 제외 타겟팅에 사용됩니다. 이 그룹 및 기타 제외된 잠재고객 그룹의 UNION을(를) 'COMPLEMENT'하는 항목이 모든 포함 잠재고객 타겟팅에 대해 교차로 사용됩니다. 모든 항목은 논리적으로 서로 'OR'입니다.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

제외된 Google 잠재고객 그룹의 Google 잠재고객 ID입니다. 제외 타겟팅에 사용됩니다. 이 그룹 및 기타 제외된 잠재고객 그룹의 UNION을(를) 'COMPLEMENT'하는 항목이 모든 포함 잠재고객 타겟팅에 대해 교차로 사용됩니다. 관심분야, 구매 의도, 설치된 앱 유형의 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

할당된 브라우저 타겟팅 옵션의 세부정보입니다. targetingTypeTARGETING_TYPE_BROWSER일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
입력란
displayName

string

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

targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_BROWSER 유형 TargetingOptiontargetingOptionId입니다.

negative

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

할당된 가계 소득 타겟팅 옵션의 세부정보입니다. targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "householdIncome": enum (HouseholdIncome)
}
입력란
householdIncome

enum (HouseholdIncome)

필수 항목입니다. 잠재고객의 가계 소득입니다.

OnScreenPositionAssignedTargetingOptionDetails

화면상의 위치 타겟팅 옵션 세부정보입니다. targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION일 때 onScreenPositionDetails 필드에 채워집니다.

JSON 표현
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
입력란
targetingOptionId

string

필수 항목입니다. targetingTypeTARGETING_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 타겟팅 옵션에 대한 세부정보입니다. targetingTypeTARGETING_TYPE_CARRIER_AND_ISP일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
입력란
displayName

string

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

targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_CARRIER_AND_ISP 유형 TargetingOptiontargetingOptionId입니다.

negative

boolean

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

KeywordAssignedTargetingOptionDetails

할당된 키워드 타겟팅 옵션의 세부정보입니다. targetingTypeTARGETING_TYPE_KEYWORD일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "keyword": string,
  "negative": boolean
}
입력란
keyword

string

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

포함 키워드는 불쾌감을 주는 단어일 수 없습니다. UTF-8 형식으로 인코딩되어야 하며 최대 크기는 255바이트여야 합니다. 최대 문자 수는 80자(영문 기준)입니다. 최대 단어 수는 10개입니다.

negative

boolean

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

NegativeKeywordListAssignedTargetingOptionDetails

제외 키워드 목록의 타겟팅 세부정보입니다. targetingTypeTARGETING_TYPE_NEGATIVE_KEYWORD_LIST일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "negativeKeywordListId": string
}
입력란
negativeKeywordListId

string (int64 format)

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

OperatingSystemAssignedTargetingOptionDetails

할당된 운영체제 타겟팅 옵션 세부정보입니다. targetingTypeTARGETING_TYPE_OPERATING_SYSTEM일 때 operatingSystemDetails 필드에 채워집니다.

JSON 표현
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
입력란
displayName

string

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

targetingOptionId

string

필수 항목입니다. targetingTypeTARGETING_TYPE_OPERATING_SYSTEM일 때 targetingOptionId 필드에 채워진 타겟팅 옵션 ID입니다.

negative

boolean

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

DeviceMakeModelAssignedTargetingOptionDetails

할당된 기기 제조업체 및 모델 타겟팅 옵션 세부정보입니다. targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL일 때 deviceMakeModelDetails 필드에 채워집니다.

JSON 표현
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
입력란
displayName

string

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

targetingOptionId

string

필수 항목입니다. targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL인 경우 targetingOptionId 필드

negative

boolean

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

EnvironmentAssignedTargetingOptionDetails

할당된 환경 타겟팅 옵션 세부정보입니다. targetingTypeTARGETING_TYPE_ENVIRONMENT일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "environment": enum (Environment)
}
입력란
environment

enum (Environment)

필수 항목입니다. 게재 환경입니다.

InventorySourceAssignedTargetingOptionDetails

인벤토리 소스의 타겟팅 세부정보입니다. targetingTypeTARGETING_TYPE_INVENTORY_SOURCE일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "inventorySourceId": string
}
입력란
inventorySourceId

string (int64 format)

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

CategoryAssignedTargetingOptionDetails

할당된 카테고리 타겟팅 옵션 세부정보입니다. targetingTypeTARGETING_TYPE_CATEGORY일 때 categoryDetails 필드에 채워집니다.

JSON 표현
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
입력란
displayName

string

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

targetingOptionId

string

필수 항목입니다. targetingTypeTARGETING_TYPE_CATEGORY인 경우 targetingOptionId 필드

negative

boolean

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

ViewabilityAssignedTargetingOptionDetails

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

JSON 표현
{
  "viewability": enum (Viewability)
}
입력란
viewability

enum (Viewability)

필수 항목입니다. 예상 조회가능성 비율입니다.

AuthorizedSellerStatusAssignedTargetingOptionDetails

할당된 승인된 판매자 상태를 나타냅니다. targetingTypeTARGETING_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 유형 TargetingOptiontargetingOptionId입니다.

LanguageAssignedTargetingOptionDetails

할당된 언어 타겟팅 옵션의 세부정보입니다. targetingTypeTARGETING_TYPE_LANGUAGE일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
입력란
displayName

string

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

targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_LANGUAGE 유형 TargetingOptiontargetingOptionId입니다.

negative

boolean

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

GeoRegionAssignedTargetingOptionDetails

할당된 지역 타겟팅 옵션에 대한 세부정보입니다. targetingTypeTARGETING_TYPE_GEO_REGION일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "displayName": string,
  "targetingOptionId": string,
  "geoRegionType": enum (GeoRegionType),
  "negative": boolean
}
입력란
displayName

string

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

targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_GEO_REGION 유형 TargetingOptiontargetingOptionId입니다.

geoRegionType

enum (GeoRegionType)

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

negative

boolean

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

InventorySourceGroupAssignedTargetingOptionDetails

인벤토리 소스 그룹의 타겟팅 세부정보입니다. targetingTypeTARGETING_TYPE_INVENTORY_SOURCE_GROUP일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "inventorySourceGroupId": string
}
입력란
inventorySourceGroupId

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

디지털 콘텐츠 라벨의 타겟팅 세부정보입니다. targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
입력란
excludedContentRatingTier

enum (ContentRatingTier)

필수 항목입니다. 제외될 디지털 콘텐츠 라벨 등급 등급의 표시 이름입니다.

SensitiveCategoryAssignedTargetingOptionDetails

민감한 카테고리의 타겟팅 세부정보입니다. targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
입력란
excludedSensitiveCategory

enum (SensitiveCategory)

필수 항목입니다. 제외로 분류된 DV360 민감한 카테고리 콘텐츠의 열거형입니다.

ExchangeAssignedTargetingOptionDetails

할당된 거래소 타겟팅 옵션의 세부정보입니다. targetingTypeTARGETING_TYPE_EXCHANGE일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "exchange": enum (Exchange)
}
입력란
exchange

enum (Exchange)

필수 항목입니다. 거래소의 열거형 값입니다.

SubExchangeAssignedTargetingOptionDetails

할당된 하위 거래소 타겟팅 옵션에 대한 세부정보입니다. targetingTypeTARGETING_TYPE_SUB_EXCHANGE일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "targetingOptionId": string
}
입력란
targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_SUB_EXCHANGE 유형 TargetingOptiontargetingOptionId입니다.

ThirdPartyVerifierAssignedTargetingOptionDetails

할당된 서드 파티 인증 기관 타겟팅 옵션 세부정보입니다. targetingTypeTARGETING_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. 타사 인증업체를 타겟팅하여 노출에 대한 브랜드 안전성 기준을 적용할 수 있습니다. 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 이 열거형은 자리표시자일 뿐이며 노출 옵션을 지정하지 않습니다.
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)

과거 사기 및 IVT가 있는 사이트 및 앱을 피합니다.

avoidInsufficientOption

boolean

이전 사기 및 IVT 통계가 충분하지 않습니다.

FraudOption

이전 사기 및 IVT 비율의 가능한 옵션

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

Adult

가능한 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 옵션

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

HateSpeech

가능한 Integral Ad Science 증오심 표현 옵션입니다.

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

OffensiveLanguage

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

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

폭력

가능한 Integral Ad Science Violence 옵션

열거형
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

할당된 관심 장소 타겟팅 옵션의 세부정보입니다. targetingTypeTARGETING_TYPE_POI일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

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

string

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

targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_POI 유형 TargetingOptiontargetingOptionId입니다.

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

주소 또는 관심 장소 이름에서 삭제된 특정 위도/경도 좌표를 타겟팅하는 경우 원하는 좌표 값을 소수점 6자리로 반올림하고 소수를 삭제한 다음 세미콜론으로 구분된 문자열 값을 연결하여 필요한 타겟팅 옵션 ID를 생성할 수 있습니다. 예를 들어 타겟팅 옵션 ID '40741469;-74003387'을 사용하여 위도/경도 쌍 40.7414691, -74.003387을 타겟팅할 수 있습니다. 위도/경도 좌표만 제공되는 경우 이 필드 값은 세미콜론과 영숫자 해시 값을 추가하도록 업데이트됩니다 .

latitude

number

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

longitude

number

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

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

할당된 비즈니스 체인 타겟팅 옵션의 세부정보입니다. targetingTypeTARGETING_TYPE_BUSINESS_CHAIN일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
입력란
displayName

string

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

targetingOptionId

string

필수 항목입니다. TARGETING_TYPE_BUSINESS_CHAIN 유형 TargetingOptiontargetingOptionId입니다.

허용되는 비즈니스 체인 타겟팅 옵션 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

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

JSON 표현
{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}
입력란
targetingOptionId

string

필수 항목입니다. targetingTypeTARGETING_TYPE_CONTENT_DURATION인 경우 targetingOptionId 필드

contentDuration

enum (ContentDuration)

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

ContentStreamTypeAssignedTargetingOptionDetails

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

JSON 표현
{
  "targetingOptionId": string,
  "contentStreamType": enum (ContentStreamType)
}
입력란
targetingOptionId

string

필수 항목입니다. targetingTypeTARGETING_TYPE_CONTENT_STREAM_TYPE인 경우 targetingOptionId 필드

contentStreamType

enum (ContentStreamType)

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

NativeContentPositionAssignedTargetingOptionDetails

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

JSON 표현
{
  "contentPosition": enum (NativeContentPosition)
}
입력란
contentPosition

enum (NativeContentPosition)

필수 항목입니다. 콘텐츠 위치입니다.

OmidAssignedTargetingOptionDetails

타겟팅 가능한 Open Measurement가 사용 설정된 인벤토리 유형을 나타냅니다. targetingTypeTARGETING_TYPE_OMID일 때 AssignedTargetingOption의 세부정보 필드에 채워집니다.

JSON 표현
{
  "omid": enum (Omid)
}
입력란
omid

enum (Omid)

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

AudioContentTypeAssignedTargetingOptionDetails

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

JSON 표현
{
  "audioContentType": enum (AudioContentType)
}
입력란
audioContentType

enum (AudioContentType)

필수 항목입니다. 오디오 콘텐츠 유형입니다.

ContentGenreAssignedTargetingOptionDetails

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

JSON 표현
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
입력란
targetingOptionId

string

필수 항목입니다. targetingTypeTARGETING_TYPE_CONTENT_GENRE인 경우 targetingOptionId 필드

displayName

string

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

negative

boolean

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

YoutubeVideoAssignedTargetingOptionDetails

YouTube 동영상 할당 타겟팅 옵션에 대한 세부정보입니다. targetingTypeTARGETING_TYPE_YOUTUBE_VIDEO일 때 youtubeVideoDetails 필드에 채워집니다.

JSON 표현
{
  "videoId": string,
  "negative": boolean
}
입력란
videoId

string

YouTube 보기 페이지에 표시되는 YouTube 동영상 ID입니다.

negative

boolean

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

YoutubeChannelAssignedTargetingOptionDetails

YouTube 채널에 할당된 타겟팅 옵션의 세부정보입니다. targetingTypeTARGETING_TYPE_YOUTUBE_CHANNEL일 때 youtubeChannelDetails 필드에 채워집니다.

JSON 표현
{
  "channelId": string,
  "negative": boolean
}
입력란
channelId

string

YouTube 업로더 채널 ID 또는 YouTube 채널의 채널 코드입니다.

negative

boolean

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

SessionPositionAssignedTargetingOptionDetails

세션 위치에 할당된 타겟팅 옵션에 대한 세부정보입니다. targetingTypeTARGETING_TYPE_SESSION_POSITION일 때 sessionPositionDetails 필드에 채워집니다.

JSON 표현
{
  "sessionPosition": enum (SessionPosition)
}
입력란
sessionPosition

enum (SessionPosition)

세션에서 광고가 게재되는 위치입니다.

SessionPosition

세션에서 가능한 위치입니다.

열거형
SESSION_POSITION_UNSPECIFIED 자리표시자이므로 위치를 나타내지 않습니다.
SESSION_POSITION_FIRST_IMPRESSION 세션의 첫 번째 노출입니다.

방법

get

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

list

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