REST Resource: advertisers.adGroups.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)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "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)

채널 세부정보입니다. 이 필드는 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인 경우에 채워집니다.

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

object (ContentThemeAssignedTargetingOptionDetails)

콘텐츠 테마 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_CONTENT_THEME_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)

콘텐츠 재생 시간 세부정보입니다. 이 필드는 TargetingType이 TARGETING_TYPE_CONTENT_STREAM_TYPE인 경우 채워집니다.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

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

object (OmidAssignedTargetingOptionDetails)

공개 측정이 사용 설정된 인벤토리 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_OMID인 경우에 채워집니다.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

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

object (ContentGenreAssignedTargetingOptionDetails)

콘텐츠 장르 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_CONTENT_GENRE인 경우에 채워집니다.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

YouTube 동영상 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_YOUTUBE_VIDEO인 경우에 채워집니다.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

YouTube 채널 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_YOUTUBE_CHANNEL인 경우에 채워집니다.
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

세션 위치 세부정보입니다. 이 필드는 targetingType가 TARGETING_TYPE_SESSION_POSITION인 경우에 채워집니다.

상속

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

열거형
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 플랫폼입니다.
APP_PLATFORM_LG_TV 앱 플랫폼은 LG TV입니다.
APP_PLATFORM_VIZIO_TV 앱 플랫폼은 VIZIO TV입니다.

UrlAssignedTargetingOptionDetails

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

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

string

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

DV360은 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)
}
필드
ageRange

enum (AgeRange)

필수 항목입니다. 시청자의 연령대입니다. 연속된 잠재고객 연령대만 타겟팅할 수 있습니다. 따라서 이 필드에 표시된 연령대는 1) 단독으로 타겟팅하거나 2) 더 큰 연속 연령대의 일부일 수 있습니다. 연속적인 연령대 타겟팅의 도달범위는 연령을 알 수 없는 잠재고객을 타겟팅하여 확대할 수 있습니다.

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,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
필드
proximityLocationListId

string (int64 format)

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

number

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

enum (ProximityRadiusUnit)

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

ProximityRadiusUnit

ProximityRadius의 거리 단위 열거형입니다.

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

GenderAssignedTargetingOptionDetails

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

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

enum (Gender)

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

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

enum (VideoPlayerSize)

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

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)
}
필드
parentalStatus

enum (ParentalStatus)

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

ContentInstreamPositionAssignedTargetingOptionDetails

할당된 콘텐츠 인스트림 위치 타겟팅 옵션 세부정보입니다. targetingType이 TARGETING_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

할당된 콘텐츠 아웃스트림 위치 타겟팅 옵션 세부정보입니다. targetingType이 TARGETING_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

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

JSON 표현 
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
필드
deviceType

enum (DeviceType)

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

number

출력 전용입니다. 입찰가 배수를 사용하면 기기 유형에 따라 광고를 더 게재하거나 덜 게재할 수 있습니다. 원래 입찰가에 배율이 적용됩니다. 이 필드가 0이면 원래 입찰가에 0을 곱하는 대신 이 필드가 적용되지 않음을 나타냅니다.

예를 들어 배율이 적용되지 않은 입찰가가 $10.0이고 태블릿의 배율이 1.5인 경우 태블릿의 최종 입찰가는 $15.0입니다.

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

AudienceGroupAssignedTargetingOptionDetails

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

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

object (FirstAndThirdPartyAudienceGroup)

선택사항입니다. 포함된 퍼스트 파티 및 서드 파티 잠재고객 그룹의 퍼스트 파티 및 서드 파티 잠재고객 ID와 최근성입니다. 각 퍼스트 파티 및 서드 파티 잠재고객 그룹에는 퍼스트 파티 및 서드 파티 잠재고객 ID만 포함됩니다. 각 퍼스트 파티 및 서드 파티 잠재고객 그룹 간의 관계는 교집합이며 결과는 다른 잠재고객 그룹과 합집합됩니다. 설정이 동일한 그룹이 반복되면 무시됩니다.
includedGoogleAudienceGroup

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

선택사항입니다. 포함된 통합 잠재고객 그룹의 통합 잠재고객 ID입니다. 통합 잠재고객 ID만 포함합니다.
excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

선택사항입니다. 제외된 퍼스트 파티 및 서드 파티 잠재고객 그룹의 퍼스트 파티 및 서드 파티 잠재고객 ID와 최근성입니다. 제외 타겟팅에 사용됩니다. 이 그룹과 다른 제외된 잠재고객 그룹의 합집합의 여집합은 모든 긍정적 잠재고객 타겟팅의 교집합으로 사용됩니다. 모든 항목은 서로 논리적으로 'OR'입니다.
excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

선택사항입니다. 제외된 Google 잠재고객 그룹의 Google 잠재고객 ID입니다. 제외 타겟팅에 사용됩니다. 이 그룹과 다른 제외된 잠재고객 그룹의 합집합의 여집합은 모든 긍정적 잠재고객 타겟팅의 교집합으로 사용됩니다. 관심분야, 구매 의도, 설치된 앱 유형 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개를 초과해서는 안 됩니다. 그렇지 않으면 오류가 발생합니다.

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)
}
필드
householdIncome

enum (HouseholdIncome)

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

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)
}
필드
environment

enum (Environment)

필수 항목입니다. 제공 환경입니다.

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)
}
필드
viewability

enum (Viewability)

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

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 표현 
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
필드
excludedContentRatingTier

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

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

JSON 표현 
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
필드
excludedSensitiveCategory

enum (SensitiveCategory)

필수 항목입니다. DV360 민감한 카테고리 콘텐츠가 제외된 것으로 분류된 enum입니다.

ContentThemeAssignedTargetingOptionDetails

콘텐츠 테마의 타겟팅 세부정보입니다. targetingType이 TARGETING_TYPE_CONTENT_THEME_EXCLUSION인 경우 AssignedTargetingOption의 세부정보 필드에 값이 입력됩니다.

JSON 표현 
{
  "excludedTargetingOptionId": string,
  "contentTheme": enum (ContentTheme),
  "excludedContentTheme": enum (ContentTheme)
}
필드
excludedTargetingOptionId

string

필수 항목입니다. 제외할 콘텐츠 테마의 ID입니다.
contentTheme

enum (ContentTheme)

출력 전용입니다. DV360 콘텐츠 테마 분류 기준의 열거형입니다.
excludedContentTheme

enum (ContentTheme)

필수 항목입니다. 제외된 것으로 분류된 DV360 콘텐츠 테마의 enum입니다.

ExchangeAssignedTargetingOptionDetails

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

JSON 표현 
{
  "exchange": enum (Exchange)
}
필드
exchange

enum (Exchange)

필수 항목입니다. 교환의 enum 값입니다.

SubExchangeAssignedTargetingOptionDetails

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

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

string

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

ThirdPartyVerifierAssignedTargetingOptionDetails

할당된 서드 파티 인증업체 타겟팅 옵션 세부정보입니다. 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)

서드 파티 브랜드 확인업체: Scope3 (이전 명칭: Adloox)
doubleVerify

object (DoubleVerify)

서드 파티 브랜드 인증업체: DoubleVerify
integralAdScience

object (IntegralAdScience)

서드 파티 브랜드 확인업체: Integral Ad Science

Adloox

Scope3 (이전 명칭: Adloox) 브랜드 안전성 설정의 세부정보입니다.

JSON 표현 
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ],
  "excludedFraudIvtMfaCategories": [
    enum (FraudIvtMfaCategory)
  ],
  "adultExplicitSexualContent": enum (GarmRiskExclusion),
  "crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent": enum (GarmRiskExclusion),
  "armsAmmunitionContent": enum (GarmRiskExclusion),
  "deathInjuryMilitaryConflictContent": enum (GarmRiskExclusion),
  "debatedSensitiveSocialIssueContent": enum (GarmRiskExclusion),
  "illegalDrugsTobaccoEcigarettesVapingAlcoholContent": enum (GarmRiskExclusion),
  "onlinePiracyContent": enum (GarmRiskExclusion),
  "hateSpeechActsAggressionContent": enum (GarmRiskExclusion),
  "obscenityProfanityContent": enum (GarmRiskExclusion),
  "spamHarmfulContent": enum (GarmRiskExclusion),
  "terrorismContent": enum (GarmRiskExclusion),
  "misinformationContent": enum (GarmRiskExclusion),
  "displayIabViewability": enum (DisplayIabViewability),
  "videoIabViewability": enum (VideoIabViewability)
}
필드
excludedAdlooxCategories[]

enum (AdlooxCategory)

제외할 Scope3 카테고리입니다.
excludedFraudIvtMfaCategories[]

enum (FraudIvtMfaCategory)

선택사항입니다. 제외할 Scope3의 사기 IVT MFA 카테고리입니다.
adultExplicitSexualContent

enum (GarmRiskExclusion)

선택사항입니다. 제외할 성인용/성적인 콘텐츠 GARM 위험 범위입니다.
crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum (GarmRiskExclusion)

선택사항입니다. 범죄 및 유해 행위 관련 콘텐츠에서 제외할 GARM 위험 범위입니다.
armsAmmunitionContent

enum (GarmRiskExclusion)

선택사항입니다. 제외할 무기류 및 탄약 관련 콘텐츠 GARM 위험 범위입니다.
deathInjuryMilitaryConflictContent

enum (GarmRiskExclusion)

선택사항입니다. 제외할 사망, 부상 또는 무력 충돌 관련 콘텐츠 GARM 위험 범위
debatedSensitiveSocialIssueContent

enum (GarmRiskExclusion)

선택사항입니다. 제외할 논란이 되는 민감한 사회 문제 관련 콘텐츠 GARM 위험 범위입니다.
illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum (GarmRiskExclusion)

선택사항입니다. 제외할 불법 약물/주류 관련 콘텐츠 GARM 위험 범위입니다.
onlinePiracyContent

enum (GarmRiskExclusion)

선택사항입니다. 제외할 온라인 불법 복제 콘텐츠 GARM 위험 범위입니다.
hateSpeechActsAggressionContent

enum (GarmRiskExclusion)

선택사항입니다. 증오심 표현 및 공격 행위 관련 콘텐츠에서 제외할 GARM 위험 범위입니다.
obscenityProfanityContent

enum (GarmRiskExclusion)

선택사항입니다. 외설 및 욕설 관련 콘텐츠 GARM 위험 범위(제외 대상)
spamHarmfulContent

enum (GarmRiskExclusion)

선택사항입니다. 제외할 스팸 또는 유해한 콘텐츠 GARM 위험 범위입니다.
terrorismContent

enum (GarmRiskExclusion)

선택사항입니다. 제외할 테러 관련 콘텐츠 GARM 위험 범위입니다.
misinformationContent

enum (GarmRiskExclusion)

선택사항입니다. 제외할 잘못된 정보 콘텐츠 GARM 위험 범위입니다.
displayIabViewability

enum (DisplayIabViewability)

선택사항입니다. 디스플레이 광고의 IAB 조회 가능성 기준입니다.
videoIabViewability

enum (VideoIabViewability)

선택사항입니다. 동영상 광고의 IAB 조회 가능성 기준입니다.

AdlooxCategory

사용 가능한 Scope3 (이전 명칭: Adloox) 카테고리입니다.

열거형
ADLOOX_UNSPECIFIED 이 버전에서 범위 3 카테고리가 지정되지 않았거나 알 수 없는 경우의 기본값입니다.
ADULT_CONTENT_HARD 성인용 콘텐츠 (하드).
ADULT_CONTENT_SOFT 성인용 콘텐츠 (약함).
ILLEGAL_CONTENT 불법 콘텐츠
BORDERLINE_CONTENT 정책 위반 가능성이 있는 콘텐츠
DISCRIMINATORY_CONTENT 차별적인 콘텐츠
VIOLENT_CONTENT_WEAPONS 폭력적인 콘텐츠 및 무기
LOW_VIEWABILITY_DOMAINS 조회 가능성이 낮은 도메인
FRAUD 사기

FraudIvtMfaCategory

사용 가능한 Scope3 (이전 명칭: Adloox) 사기, IVT, MFA 카테고리

열거형
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED 이 버전에서 Scope3 사기, IVT, MFA 카테고리가 지정되지 않았거나 알 수 없는 경우의 기본값입니다.
FRAUD_IVT_MFA 사기, 무효 트래픽, MFA

GarmRiskExclusion

사용 가능한 GARM 위험 수준 제외 옵션입니다.

열거형
GARM_RISK_EXCLUSION_UNSPECIFIED 이 열거형은 자리표시자일 뿐이며 GARM 위험 제외 옵션을 지정하지 않습니다.
GARM_RISK_EXCLUSION_FLOOR 최저 위험도 제외
GARM_RISK_EXCLUSION_HIGH 높은 위험도 및 최저 위험도 제외
GARM_RISK_EXCLUSION_MEDIUM 위험도 중간, 높음, 최저 제외
GARM_RISK_EXCLUSION_LOW 모든 위험도 (낮음, 보통, 높음, 최저)를 제외합니다.

DisplayIabViewability

사용 가능한 Scope3 (이전 명칭: Adloox) IAB 디스플레이 조회 가능성 기준입니다.

열거형
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED 이 버전에서 지정되지 않았거나 알 수 없는 경우의 기본값입니다.
DISPLAY_IAB_VIEWABILITY_10 10%이상이 조회 가능해야 합니다 (IAB 디스플레이 조회 가능성 표준).
DISPLAY_IAB_VIEWABILITY_20 조회 가능성 20%이상 (IAB 디스플레이 조회 가능성 표준)
DISPLAY_IAB_VIEWABILITY_35 35%이상이 조회 가능해야 합니다 (IAB 디스플레이 조회 가능성 표준).
DISPLAY_IAB_VIEWABILITY_50 50%이상이 조회 가능해야 합니다 (IAB 디스플레이 조회 가능성 표준).
DISPLAY_IAB_VIEWABILITY_75 조회 상태 75%이상 (IAB 디스플레이 조회 가능성 표준)

VideoIabViewability

사용 가능한 Scope3 (이전 명칭: Adloox) IAB 동영상 조회 가능성 기준입니다.

열거형
VIDEO_IAB_VIEWABILITY_UNSPECIFIED 이 버전에서 지정되지 않았거나 알 수 없는 경우의 기본값입니다.
VIDEO_IAB_VIEWABILITY_10 조회 가능성 (IAB 동영상 조회 가능성 표준)이 10%이상입니다.
VIDEO_IAB_VIEWABILITY_20 조회 가능 상태 (IAB 동영상 조회 가능성 표준)가 20%이상입니다.
VIDEO_IAB_VIEWABILITY_35 조회 가능성 35%이상 (IAB 동영상 조회 가능성 표준)
VIDEO_IAB_VIEWABILITY_50 50%이상 조회 (IAB 동영상 조회가능성 표준)
VIDEO_IAB_VIEWABILITY_75 조회 가능성 75%이상 (IAB 동영상 조회 가능성 표준)

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 이 열거형은 자리표시자일 뿐이며 심각도가 높은 카테고리를 지정하지 않습니다.
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 이 열거형은 자리표시자일 뿐이며 앱 별점 옵션을 지정하지 않습니다.
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 이 열거형은 자리표시자일 뿐 평균 조회 시간 옵션을 지정하지 않습니다.
AVERAGE_VIEW_DURATION_5_SEC 100% 조회 가능 기간이 5초 이상이 되도록 웹 및 앱 인벤토리 타겟팅
AVERAGE_VIEW_DURATION_10_SEC 100% 조회 가능 기간이 10초 이상이 되도록 웹 및 앱 인벤토리를 타겟팅합니다.
AVERAGE_VIEW_DURATION_15_SEC 100% 조회 가능 기간이 15초 이상이 되도록 웹 및 앱 인벤토리 타겟팅

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 이 열거형은 자리표시자일 뿐이며 사기 및 무효 트래픽 옵션을 지정하지 않습니다.
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
  ],
  "qualitySyncCustomSegmentId": [
    string
  ]
}
필드
traqScoreOption

enum (TRAQScore)

True Advertising Quality (디스플레이 광고 항목에만 적용)
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 또는 3000001~3999999 사이여야 합니다.
qualitySyncCustomSegmentId[]

string (int64 format)

선택사항입니다. Integral Ad Science에서 제공하는 품질 동기화 맞춤 세그먼트 ID입니다. ID는 3000000 이상 4999999 이하여야 합니다.

TRAQScore

가능한 Integral Ad Science TRAQ (true advertising quality) 점수 범위입니다.

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

성인

Integral Ad Science 성인 옵션입니다.

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

주류

Integral Ad Science 주류 옵션

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

IllegalDownloads

Integral Ad Science 불법 다운로드 옵션이 있을 수 있습니다.

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

마약

Integral Ad Science Drugs 옵션

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

HateSpeech

Integral Ad Science 증오심 표현 옵션

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

OffensiveLanguage

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

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

폭력

Integral Ad Science 폭력 옵션입니다.

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

도박

Integral Ad Science 도박 옵션입니다.

열거형
GAMBLING_UNSPECIFIED 이 열거형은 자리표시자일 뿐이며 도박 옵션을 지정하지 않습니다.
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 이 열거형은 자리표시자일 뿐이며 표시 가시성 옵션을 지정하지 않습니다.
PERFORMANCE_VIEWABILITY_40 조회가능성 40% 이상을 타겟팅합니다.
PERFORMANCE_VIEWABILITY_50 조회가능성 50% 이상을 타겟팅합니다.
PERFORMANCE_VIEWABILITY_60 조회가능성 60% 이상을 타겟팅합니다.
PERFORMANCE_VIEWABILITY_70 조회가능성 70% 이상을 타겟팅합니다.

VideoViewability

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

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

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는 targetingTypes.targetingOptions.search를 사용하여 가져올 수 있습니다.

주소 또는 POI 이름에서 삭제된 특정 위도/경도 좌표를 타겟팅하는 경우 원하는 좌표 값을 소수점 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

할당된 비즈니스 체인 타겟팅 옵션의 세부정보입니다. 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 표현 
{
  "contentPosition": enum (NativeContentPosition)
}
필드
contentPosition

enum (NativeContentPosition)

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

OmidAssignedTargetingOptionDetails

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

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

enum (Omid)

필수 항목입니다. 공개 측정이 사용 설정된 인벤토리의 유형입니다.

AudioContentTypeAssignedTargetingOptionDetails

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

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

enum (AudioContentType)

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

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

이 옵션이 부정적으로 타겟팅되는지 여부를 나타냅니다.

YoutubeVideoAssignedTargetingOptionDetails

할당된 YouTube 동영상 타겟팅 옵션의 세부정보입니다. targetingType이 TARGETING_TYPE_YOUTUBE_VIDEO이면 youtubeVideoDetails 필드에 채워집니다.

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

string

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

boolean

이 옵션이 부정적으로 타겟팅되는지 여부를 나타냅니다.

YoutubeChannelAssignedTargetingOptionDetails

할당된 YouTube 채널 타겟팅 옵션의 세부정보입니다. targetingType이 TARGETING_TYPE_YOUTUBE_CHANNEL이면 youtubeChannelDetails 필드에 채워집니다.

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

string

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

boolean

이 옵션이 부정적으로 타겟팅되는지 여부를 나타냅니다.

SessionPositionAssignedTargetingOptionDetails

할당된 세션 위치 타겟팅 옵션의 세부정보입니다. targetingType이 TARGETING_TYPE_SESSION_POSITION이면 sessionPositionDetails 필드에 채워집니다.

JSON 표현 
{
  "sessionPosition": enum (SessionPosition)
}
필드
sessionPosition

enum (SessionPosition)

세션에서 광고가 표시될 위치입니다.

SessionPosition

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

열거형
SESSION_POSITION_UNSPECIFIED 자리표시자이며 위치를 나타내지 않습니다.
SESSION_POSITION_FIRST_IMPRESSION 세션의 첫인상입니다.

메서드

get

 광고 그룹에 할당된 단일 타겟팅 옵션을 가져옵니다.

list

 광고 그룹에 할당된 타겟팅 옵션을 나열합니다.