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. 할당 중인 타겟팅 옵션에 대한 세부정보입니다. 세부정보에서 하나의 필드만 작성할 수 있으며 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)

Open Measurement가 사용 설정된 인벤토리 세부정보 이 필드는 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 스토어 앱은 번들 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 타겟팅 옵션에 대한 세부정보입니다. 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)과 다섯 가지 수준의 하위 도메인 타겟팅(예: 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

타겟팅 가능한 연령대를 나타냅니다. 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 타겟팅된 반경 범위가 지정되지 않았거나 알 수 없습니다. 이 버전에서 반경 범위가 지정되지 않은 경우의 기본값입니다. 이 열거형은 기본값의 자리표시자이며 실제 반경 범위 옵션을 나타내지 않습니다.
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 이미지 및 HTML5와 같은 디스플레이 광고 소재입니다.
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입니다. 제외되는 FirstAndThirdPartyAudienceGroup과 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을 보완하는 요소가 포함 잠재고객 타겟팅에 활용됩니다. 모든 항목은 논리적으로 서로 '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. 서드 파티 인증업체를 타겟팅하여 노출에 대한 브랜드 안전성 기준을 적용할 수 있습니다. 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)

이전에 사기 및 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 이 열거형은 자리표시자일 뿐이며 실제 광고 품질평가점수를 지정하지 않습니다.
TRAQ_250 TRAQ 점수는 250~1,000입니다.
TRAQ_500 TRAQ 점수는 500~1000점입니다.
TRAQ_600 TRAQ 점수는 600~1,000점입니다.
TRAQ_700 TRAQ 점수는 700~1,000입니다.
TRAQ_750 TRAQ 점수는 750~1,000점입니다.
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_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_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자리로 반올림한 POI의 위도입니다.
longitude

number

출력 전용. 소수점 6자리로 반올림되는 POI의 경도입니다.
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', 'Chase Bank').
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

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