출시 노트

이 페이지에는 Display & Video 360 API의 출시 노트가 나와 있습니다.

최신 API 버전: v3

2024년 4월 23일

새로운 기능

새로운 KPI 유형, 거래소, 앱 플랫폼에 대한 지원이 추가되었습니다.

v3

• 다음 필드가 추가되었습니다.

  리소스	필드
  KPI	kpiAlgorithmId

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  교환	EXCHANGE_DRAX
  KpiType	KPI_TYPE_CPCL KPI_TYPE_CPCV KPI_TYPE_CPV KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST KPI_TYPE_MAXIMIZE_PACING KPI_TYPE_TOS10
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  교환	EXCHANGE_DRAX
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

2024년 2월 28일

새로운 기능

고객 일치 타겟팅 잠재고객에서 회원을 명시적으로 삭제하는 기능이 추가되었습니다.

새로운 거래소 타겟팅에 대한 지원이 추가되었습니다.

v3

• 다음 필드가 추가되었습니다.

  리소스	필드
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  교환	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

v2

• 다음 필드가 추가되었습니다.

  리소스	필드
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  교환	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

2024년 1월 29일

새로운 기능

새로운 floodlightGroups.floodlightActivities 서비스를 통해 플러드라이트 활동을 가져오는 기능이 추가되었습니다.

YouTube + 파트너 광고 항목의 타겟팅에 Google TV 인벤토리가 포함되어 있는지를 알리는 새로운 필드가 추가되었습니다.

Display & Video 360 사용자의 마지막 로그인 시간을 전달하는 새 필드가 추가되었습니다.

v3

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  floodlightGroups.floodlightActivities	get list

• 다음 필드가 추가되었습니다.

  리소스	필드
  사용자(User)	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  floodlightGroups.floodlightActivities	get list

• 다음 필드가 추가되었습니다.

  리소스	필드
  사용자(User)	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

2023년 11월 14일

새로운 기능

모든 실시간 버전에서 고객 일치 타겟팅 잠재고객 구성원을 업로드할 때 최종 사용자 동의를 전달하는 기능이 추가되었습니다.

v3

• 다음 필드가 추가되었습니다.

  리소스	필드
  ContactInfoList	동의
  MobileDeviceIdList	동의

v2

• 다음 필드가 추가되었습니다.

  리소스	필드
  ContactInfoList	동의
  MobileDeviceIdList	동의

2023년 10월 31일

새로운 기능

v3가 공개 베타에서 정식 버전으로 이동했습니다.

관련 형식을 더 정확하게 반영하도록 v3의 AdGroupFormat enum 값 이름이 변경되었습니다.

v2 및 v3에 SDF_VERSION_7 enum 값이 추가되어 구조화된 데이터 파일 v7 지원이 추가되었습니다.

v3

• 다음 열거형 값이 삭제되었습니다.

  enum	값
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

v2

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  SdfVersion	SDF_VERSION_7

2023년 10월 2일

새로운 기능

다음 변경사항이 포함된 v3가 공개 베타로 출시되었습니다.

• 근접 위치 목록을 완전히 관리할 수 있으므로 advertisers.locationLists.assignedLocations 서비스를 사용하여 TARGETING_LOCATION_TYPE_PROXIMITY LocationList 리소스에 할당된 위치를 만들고 삭제할 수 있습니다.
• TargetingExpansionConfig 객체의 targetingExpansionLevel 필드를 대체하는 새로운 불리언 enableOptimizedTargeting 필드
• Advertiser 리소스의 billingConfig 필드 요구사항(advertisers.create 요청 시 포함되어야 함) 및 Partner 리소스에 새 billingConfig 필드 요구사항.
• v2에서 YoutubeAdGroup 및 YoutubeAdGroupAd 리소스를 대체하는 새로운 AdGroup 및 AdGroupAd 리소스가 추가되었습니다.

v2에서 v3로 이전하려면 이전 가이드의 단계를 따르세요.

v2 및 v3에서 3개의 새로운 LineItemType 값, 하나의 새로운 YoutubeAndPartnersBiddingStrategyType, 하나의 새로운 PartnerCostType에 관한 지원이 추가되었습니다.

v3

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  advertisers.adGroupAds	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	만들기 get list

• 다음 메서드가 삭제되었습니다.

  서비스	메서드
  advertisers.manualTriggers	실행 만들기 비활성화 get list patch
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• 다음과 같은 메서드 동작이 변경되었습니다.

  메서드	변경사항
  advertisers.locationLists.create	이제 TARGETING_LOCATION_TYPE_PROXIMITY LocationList 리소스 생성을 지원합니다.
  advertisers.locationLists.patch	이제 TARGETING_LOCATION_TYPE_PROXIMITY LocationList 리소스 업데이트가 지원됩니다.
  advertisers.locationLists.assignedLocations.bulkEdit	이제 TARGETING_LOCATION_TYPE_PROXIMITY개의 LocationList 리소스에서 AssignedLocation 리소스의 일괄 수정을 지원합니다.
  advertisers.locationLists.assignedLocations.create	이제 TARGETING_LOCATION_TYPE_PROXIMITY LocationList 리소스에서 AssignedLocation 리소스 생성을 지원합니다.

• 다음과 같은 쿼리 매개변수가 추가되었습니다.

  메서드	매개변수
  inventorySources.get	advertiserId

• 다음은 필수 입력란입니다.

  리소스	필드
  광고주	billingConfig

• 다음 필드가 추가되었습니다.

  리소스	필드
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	kpi
  파트너	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• 다음 필드가 삭제되었습니다.

  리소스	필드
  InsertionOrder	performanceGoal billableOutcome
  TargetingExpansionConfig	excludeFirstPartyAudience targetingExpansionLevel
  YoutubeAndPartnersSettings	biddingStrategy thirdPartyMeasurementSettings
  YoutubeAndPartnersInventorySourceConfig	includeYoutubeSearch includeYoutubeVideos

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  CustomBiddingAlgorithmType	RULE_BASED
  LineItemType	LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
  PartnerCostType	PARTNER_COST_TYPE_SCIBIDS_FEE
  ReadinessState	READINESS_STATE_EVALUATION_FAILURE
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

• 다음 열거형 값이 삭제되었습니다.

  enum	값
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v2

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  LineItemType	LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
  PartnerCostType	PARTNER_COST_TYPE_SCIBIDS_FEE
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

2023년 8월 25일

새로운 기능

2개의 광고 거래소와 2개의 새로운 YouTube + 파트너 입찰 전략 유형에 대한 지원이 추가되었습니다.

광고주 및 광고 항목 수준 모두에서 할당된 값을 고려할 때 광고 항목에서 사용하는 YoutubeAndPartnersContentCategory를 표시하기 위해 YouTube + 파트너 광고 항목에 새로운 effectiveContentCategory 필드를 추가했습니다.

v2

• 다음 필드가 추가되었습니다.

  리소스	필드
  YoutubeAndPartnersSettings	effectiveContentCategory

• 다음 필드가 삭제되었습니다.

  리소스	필드
  InventorySource	subSitePropertyId

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  교환	EXCHANGE_HIVESTACK EXCHANGE_RESET_DIGITAL
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

2023년 6월 5일

새로운 기능

v1 및 v2에서 구조화된 데이터 파일(SDF) v6에 새로운 SdfVersion 값을 추가했습니다.

v2

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  SdfVersion	SDF_VERSION_6

v1

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  SdfVersion	SDF_VERSION_6

2023년 3월 9일

새로운 기능

새 LineItemWarningMessage 값이 추가되었습니다. 이 값은 지원 중단된 excludeFirstPartyAudience 필드가 true로 설정된 경우 광고 항목의 warningMessages 필드에 할당됩니다. 2023년 3월 25일 이후 excludeFirstPartyAudience 필드는 지원 종료되고 false로 설정됩니다.

v2

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

2023년 2월 8일

새로운 기능

YouTubeAdGroup 및 YouTubeAdGroupAd 리소스는 물론 YouTube 광고그룹 리소스 타겟팅을 검색하는 기능이 추가되었습니다. 또한 YouTube 광고그룹 수준에서 사용되는 가져올 수 있는 새로운 타겟팅 유형도 추가되었습니다. 자세한 내용은 YouTube 및 파트너 리소스 검색에 대한 새 가이드 페이지를 참고하세요.

v1 및 v2에 4개의 추가 광고 거래소에 대한 지원이 추가되었습니다.

v2

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• 다음 필드가 추가되었습니다.

  서비스	메서드
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  교환	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
  TargetingType	TARGETING_TYPE_SESSION_POSITION TARGETING_TYPE_YOUTUBE_CHANNEL TARGETING_TYPE_YOUTUBE_VIDEO

v1

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  교환	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

2022년 12월 6일

새로운 기능

v2가 공개 베타에서 정식 버전으로 이동했습니다.

AssignedTargetingOption 리소스에 새 assignedTargetingOptionIdAlias 필드를 추가했습니다. 타겟팅을 검색하고 삭제할 때 assignedTargetingOptionId 대신 사용할 수 있습니다. 이 필드는 enum을 통해 할당된 타겟팅 유형의 할당된 타겟팅 옵션에만 설정됩니다. 별칭 값은 관련 enum 값(문자열)입니다.

Advertiser 리소스에 새 billingConfig 필드를 추가했습니다.

YouTube + 파트너 오버더톱 광고 항목(3개의 새로운 LineItemType 값으로 식별됨) 검색 지원이 추가되었습니다.

v1 및 v2에서 여러 list 메서드의 최대 페이지 크기가 200으로 늘어났습니다. 기본 페이지 크기는 변경되지 않습니다.

v2

• 다음 필드가 추가되었습니다.

  리소스	필드
  광고주	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

• 다음 목록 메서드의 최대 페이지 크기가 늘어났습니다.

  메서드	새 최대 페이지 크기
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

v1

• 다음 목록 메서드의 최대 페이지 크기가 늘어났습니다.

  메서드	새 최대 페이지 크기
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

알려진 문제

이 업데이트는 다음과 같은 v2의 알려진 문제를 해결합니다.

• v2에서 열거형 값을 사용하여 할당된 타겟팅 유형의 할당된 타겟팅 옵션은 assignedTargetingOptionId를 사용하여 삭제하거나 가져올 수 없었으며, 대신 사용자가 enum 값을 사용해야 했습니다. 이번 업데이트를 통해 할당된 타겟팅 옵션은 assignedTargetingOptionId 또는 AssignedTargetingOption 리소스의 새 assignedTargetingOptionIdAlias 필드로 식별되는 enum 값을 사용하여 삭제하거나 가져올 수 있습니다.
• 광고 항목 bulkUpdate 요청이 advertisersId 요청 매개변수를 올바르게 사용하지 않아 오류가 반환되었습니다. 이 업데이트로 메서드가 수정되고 요청 매개변수의 이름이 advertisersId에서 advertiserId로 변경되었습니다.

2022년 10월 27일

상위 InsertionOrder 내에서 기존 광고 항목을 복제하는 기능이 추가되었습니다.

advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 서비스에 create 및 delete 메서드를 추가하여 타겟팅 유형의 하위 집합에 대한 부분 게재 신청서 타겟팅 쓰기 지원을 도입했습니다.

새로운 기능

v2

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	만들기 삭제
  advertisers.lineItems	중복

v1

v1에 추가된 새로운 기능은 없습니다.

2022년 9월 20일

다음 변경사항이 포함된 v2가 공개 베타로 출시되었습니다.

• advertisers.lineItems 및 advertisers.lineItems.targetingTypes.assignedTargetingOptions 서비스에서 get 및 list 메서드를 사용하여 YouTube + 파트너 광고 항목과 타겟팅 설정을 가져오는 기능
• advertisers.lineItems 서비스에 포함된 두 가지 새로운 일괄 타겟팅 방법으로, 단일 요청으로 여러 광고 항목에서 할당된 타겟팅을 수정 및 가져올 수 있습니다.
• 사용자가 단일 요청으로 여러 광고 항목의 entityStatus를 업데이트할 수 있는 새로운 bulkUpdate 메서드
• targetingTypes.targetingOptions 서비스를 사용하여 검색한 타겟팅 옵션 ID 대신 enum 값을 사용하여 타겟팅 유형의 하위 집합의 AssignedTargetingOption 리소스를 할당하고 검색해야 하는 새로운 타겟팅 로직

v1에서 v2로 이전하려면 이전 가이드의 단계를 따르세요.

v1에서 3개의 새로운 광고 거래소에 대한 지원이 추가되었습니다.

새로운 기능

v2

다음은 v1과 v2의 변경사항 목록입니다.

• 다음 메서드가 v2에 추가되었습니다.

  서비스	메서드
  advertisers.lineItems	bulkEditAssignedTargetingOptions bulkListAssignedTargetingOptions bulkUpdate

• 다음 메서드는 v2에서 삭제되었습니다.

  서비스	메서드
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• 다음 메서드의 이름이 v2에서 변경되었습니다.

  서비스	이전 방법 이름	새 메서드 이름
  advertisers	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  partners	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• 다음 타겟팅 유형의 AssignedTargetingOption 리소스는 v2에서 타겟팅 할당에 enum을 사용합니다. 이러한 타겟팅 유형의 AssignedTargetingOption 리소스에 대한 assignedTargetingOptionId 필드도 v2에서 enum 값의 문자열 버전을 사용하도록 업데이트되었습니다.

  타겟팅 유형	Enum 유형
  TARGETING_TYPE_AGE_RANGE	AgeRange
  TARGETING_TYPE_CONTENT_INSTREAM_POSITION	ContentInstreamPosition
  TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION	ContentOutstreamPosition
  TARGETING_TYPE_DEVICE_TYPE	DeviceType
  TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION	ContentRatingTier
  TARGETING_TYPE_ENVIRONMENT	환경
  TARGETING_TYPE_EXCHANGE	교환
  TARGETING_TYPE_GENDER	성별
  TARGETING_TYPE_HOUSEHOLD_INCOME	HouseholdIncome
  TARGETING_TYPE_NATIVE_CONTENT_POSITION	NativeContentPosition
  TARGETING_TYPE_OMID	Omid
  TARGETING_TYPE_PARENTAL_STATUS	ParentalStatus
  TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION	SensitiveCategory
  TARGETING_TYPE_VIDEO_PLAYER_SIZE	VideoPlayerSize
  TARGETING_TYPE_VIEWABILITY	조회가능성

• 다음 필드가 v2에 추가되었습니다.

  리소스	필드
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	거래소
  FrequencyCap	maxViews
  LineItem	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• 다음 필드가 v2에서 삭제되었습니다.

  리소스	필드
  AgeRangeAssignedTargetingOptionDetails	targetingOptionId
  ContentInstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  ContentOutstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  CustomBiddingAlgorithm	customBiddingAlgorithmState
  DeviceTypeAssignedTargetingOptionDetails	targetingOptionId
  DigitalContentLabelAssignedTargetingOptionDetails	contentRatingTier excludedTargetingOptionId
  EnvironmentAssignedTargetingOptionDetails	targetingOptionId
  ExchangeAssignedTargetingOptionDetails	targetingOptionId
  GenderAssignedTargetingOptionDetails	targetingOptionId
  HouseholdIncomeAssignedTargetingOptionDetails	targetingOptionId
  LineItem	inventorySourceIds
  LineItemFlight	triggerId
  NativeContentPositionAssignedTargetingOptionDetails	targetingOptionId
  OmidAssignedTargetingOptionDetails	targetingOptionId
  ParentalStatusAssignedTargetingOptionDetails	targetingOptionId
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadiusRange
  SensitiveCategoryAssignedTargetingOptionDetails	excludedTargetingOptionId sensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	targetingOptionId
  ViewabilityAssignedTargetingOptionDetails	targetingOptionId

• 다음 필드는 v2에서 필수 필드입니다.

  리소스	필드
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	environment
  ExchangeAssignedTargetingOptionDetails	거래소
  GenderAssignedTargetingOptionDetails	gender[성별]
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	조회가능성

• 다음 열거형 값이 v2에 추가되었습니다.

  enum	값
  AgeRange	AGE_RANGE_18_20 AGE_RANGE_21_24 AGE_RANGE_25_29 AGE_RANGE_30_34 AGE_RANGE_35_39 AGE_RANGE_40_44 AGE_RANGE_45_49 AGE_RANGE_50_54 AGE_RANGE_55_59 AGE_RANGE_60_64
  ContentRatingTier	CONTENT_RATING_TIER_FAMILIES
  교환	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
  ReservationType	RESERVATION_TYPE_INSTANT_RESERVE RESERVATION_TYPE_PETRA_VIRAL
  SensitiveCategory	SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

• 다음 열거형 값이 v2에서 삭제되었습니다.

  enum	값
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
  LineItemWarningMessage	APP_INSTALL_NO_CONVERSION_PIXEL APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS NO_CREATIVE_FOR_TARGETED_DEALS NO_POSITIVE_AUDIENCE_LIST_TARGETED TARGETING_DEPRECATED_GEO_TARGET TARGETING_REVOKED_OR_CLOSED_USER_LIST

v1

• 다음 열거형 값이 v1에 추가되었습니다.

  enum	값
  교환	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

2022년 5월 26일

새로운 inventorySources 서비스 쓰기 메서드와 새로운 guaranteedOrders 서비스를 통해 InventorySource 리소스를 만들고 GuaranteedOrder 리소스를 관리하는 기능이 추가되었습니다.

CustomBiddingAlgorithm 리소스에 modelReadiness 필드가 도입되었습니다. 이 필드는 알고리즘 모델에 액세스할 수 있는 각 광고주에 대한 알고리즘 모델의 준비 상태를 나열합니다.

사용자가 특정 타임스탬프 전후의 updateTime가 있는 광고 소재만 검색할 수 있도록 advertisers.creatives.list 메서드에서 새로운 filter 쿼리 매개변수 기능이 사용 설정되었습니다.

SdfVersion 열거형 값을 추가하여 최신 SDF 버전 v5.5 지원 기능이 추가되었습니다.

새로운 기능

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  guaranteedOrders	만들기 editGuaranteedOrderReadAccessors get list patch
  inventorySources	만들기 editInventorySourceReadWriteAccessors patch

• 다음 필드가 추가되었습니다.

  리소스	필드
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  SdfVersion	SDF_VERSION_5_5

• 이제 다음 목록 메서드를 다음 속성으로 필터링할 수 있습니다.

  메서드	필드
  advertisers.creatives.list	updateTime

2022년 3월 31일

콘텐츠 길이, 스트림 유형, 장르를 검색하고 타겟팅을 설정하는 지원이 추가되었습니다.

InsertionOrder 객체에 billableOutcome 필드를 추가했습니다.

MaximizeSpendBidStrategy 객체에 raiseBidForDeals 필드를 도입하여 사용자가 입찰 전략에서 타겟팅된 거래에 광고주 가격 하한선을 적용할지를 설정할 수 있도록 했습니다.

새로운 기능

• 다음 필드가 추가되었습니다.

  리소스	필드
  AssignedTargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2022년 2월 2일

특정 고객 일치 타겟팅 FirstAndThirdPartyAudience 리소스의 생성, 업데이트, 구성원 수정에 대한 지원이 추가되었습니다. 이 새로운 기능을 사용하는 방법은 새로운 잠재고객 사용 가이드의 고객 일치 타겟팅 잠재고객 업로드 페이지에서 자세히 설명합니다.

리소스가 태그 보장, 보장 프로그래매틱 또는 보장되지 않는지 여부를 식별하는 InsertionOrder 및 LineItem 리소스에 새로운 reservationType 필드가 도입되었습니다.

광고 항목이 새로운 excludeNewExchanges 필드를 통해 새로운 광고 거래소를 자동으로 타겟팅할지 여부를 검색하고 설정하는 기능이 추가되었습니다.

새로운 기능 외에 기본 할당량 한도가 두 배로 늘어났습니다.

새로운 기능

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  firstAndThirdPartyAudiences	만들기 editCustomerMatchMembers patch

• 다음 필드가 추가되었습니다.

  리소스	필드
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

2021년 12월 8일

타겟팅 유형 TARGETING_TYPE_AUDIO_CONTENT_TYPE에서 오디오 콘텐츠 유형 타겟팅 지원을 추가했습니다.

새로운 기능

• 다음 필드가 추가되었습니다.

  리소스	필드
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

2021년 11월 8일

맞춤 입찰 알고리즘과 스크립트를 관리하기 위한 전체 지원이 추가되었습니다. 여기에는 다음과 같은 콘텐츠가 포함됩니다.

• 기존 customBiddingAlgorithms을 새로 만들고 업데이트하는 함수
• 사용 가능한 리소스 위치를 검색한 후 해당 위치에 파일을 업로드하는 프로세스를 통해 스크립트를 업로드하는 기능
• customBiddingScripts를 가져오고 생성하는 새 customBiddingAlgorithms.scripts 서비스

광고 항목 관리 가이드에 새로운 맞춤 입찰 구현 페이지가 추가되었습니다. 이 페이지에서는 맞춤 입찰 알고리즘을 만들고 스크립트를 업로드하며 맞춤 입찰 알고리즘을 광고 항목의 입찰 전략으로 할당하는 프로세스를 설명합니다.

SdfVersion 열거형 값을 추가하여 최신 SDF 버전 v5.4 지원 기능이 추가되었습니다.

새로운 기능

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  customBiddingAlgorithms	만들기 patch uploadScript
  customBiddingAlgorithms.scripts	만들기 get list
  media	업로드

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  SdfVersion	SDF_VERSION_5_4

2021년 9월 14일

타겟팅 유형 TARGETING_TYPE_BUSINESS_CHAIN 및 TARGETING_TYPE_POI에서 인접 타겟팅에 대한 지원을 추가했습니다.

사용 가능한 TARGETING_TYPE_BUSINESS_CHAIN 및 TARGETING_TYPE_POI 타겟팅 옵션을 targetingTypes.targetingOptions.search를 사용하여 검색하는 기능이 추가되었습니다. 이러한 옵션은 targetingTypes.targetingOptions.get 또는 targetingTypes.targetingOptions.list 메서드를 통해 가져올 수 없기 때문입니다.

맞춤 입찰 알고리즘 리소스에 새로운 sharedAdvertiserIds 및 customBiddingAlgorithmState 필드를 도입하고 GOAL_BUILDER_BASED 맞춤 입찰 알고리즘 유형에 관한 지원을 추가했습니다.

Exchange enum에 새 값 두 개를 추가했습니다.

새로운 기능

• 다음 필드가 추가되었습니다.

  리소스	필드
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  TargetingOptions.search 요청 본문	businessChainSearchTerms poiSearchTerms

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  교환	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• 이제 다음 목록 메서드를 다음 속성으로 필터링할 수 있습니다.

  메서드	필드
  customBiddingAlgorithms.list	customBiddingAlgorithmState

2021년 8월 4일

타겟팅 유형 TARGETING_TYPE_OMID에서 Open Measurement 지원 인벤토리 타겟팅에 관한 지원이 추가되었습니다.

pageSize 메서드 매개변수를 사용하여 다양한 광고주, 캠페인, 게재 신청서 및 광고 항목에 할당된 타겟팅 옵션 목록 메서드의 단일 페이지에 반환될 수 있는 할당된 타겟팅 옵션의 최대 개수를 늘렸습니다.

새로운 기능

• 다음 필드가 추가되었습니다.

  리소스	필드
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  TargetingType	TARGETING_TYPE_OMID

• 다음 목록 메서드의 최대 페이지 크기가 늘어났습니다.

  메서드	새 최대 페이지 크기
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.targetingTypes.assignedTargetingOptions.list	5000

2021년 5월 26일

사용자가 다음을 수행할 수 있는 advertisers.invoices 서비스가 출시되었습니다.

• 특정 월에 광고주에게 발행된 인보이스를 검색합니다.
• 특정 월에 광고주가 사용한 통화 코드 조회

캠페인 리소스에 campaignBudgets 필드를 추가했습니다. 게재 신청서 예산 세그먼트를 캠페인 예산에 연결하여 관련 세그먼트의 예산 합계를 총 캠페인 예산 금액으로 제한할 수 있습니다.

새로운 타겟팅 유형 TARGETING_TYPE_NATIVE_CONTENT_POSITION에 네이티브 콘텐츠 게재위치 타겟팅에 대한 지원이 추가되었습니다.

사용자가 Mediaocean의 Prisma 도구와 통합할 수 있도록 광고주 리소스에 새 prismaEnabled 필드를 도입했습니다.

광고주의 entityStatus 필드에 대한 ENTITY_STATUS_PAUSED 열거형 값 지원이 사용 설정되었습니다.

새로운 기능

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  advertisers.invoices	list lookupInvoiceCurrency

• 다음 필드가 추가되었습니다.

  리소스	필드
  광고주	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  Campaign	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Exchange	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• 이제 다음 열거형 값이 다음 필드에 유효합니다.

  리소스	필드	값
  광고주	entityStatus	ENTITY_STATUS_PAUSED

2021년 4월 29일

타겟팅에 리소스를 사용하는 광고 항목 수를 반환하는 채널 및 제외 키워드 목록 리소스에 새 필드가 추가되었습니다. 사용자가 타겟팅에서 특정 채널 또는 제외 키워드 목록을 사용하는 광고 항목만 검색할 수 있도록 하는 광고 항목 목록 메서드의 새로운 filter 속성을 사용 설정했습니다.

새로운 기능

• 다음 필드가 추가되었습니다.

  리소스	필드
  해협	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• 이제 다음 목록 메서드를 다음 속성으로 필터링할 수 있습니다.

  메서드	필드
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

2021년 3월 30일

기본 구성으로 광고 항목을 생성하는 새 메서드를 광고 항목 서비스에 추가했습니다. 이러한 기본값은 지정된 광고 항목 유형뿐만 아니라 상위 게재 신청서의 설정 및 할당된 타겟팅을 기반으로 합니다.

새 캠페인 타겟팅 서비스 및 추가 일괄 목록 방법을 통해 캠페인 타겟팅을 가져올 수 있습니다.

더 많은 플랫폼에서 앱을 타겟팅할 수 있도록 앱 타겟팅이 확장되었습니다.

채널 및 제외 키워드 목록 콘텐츠를 보다 쉽게 관리할 수 있도록 advertisers.channels.sites, partners.channels.sites, advertisers.negativeKeywordLists.negativeKeywords 서비스를 여러 번 변경했습니다. 이러한 변경사항은 다음과 같습니다.

• 사용자가 채널 또는 제외 키워드 목록의 기존 콘텐츠를 완전히 덮어쓸 수 있는 replace 메서드 추가
• 일괄 수정 요청의 createdSites 또는 createdNegativeKeywords 필드에 기존 항목이 포함되어서는 안 된다는 요구사항이 삭제됩니다.
• 사이트 목록 또는 제외 키워드 나열 응답의 단일 페이지에 반환할 수 있는 최대 항목 수의 증가입니다.

새로운 기능

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	get list
  advertisers.channels.sites	replace
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	replace
  partners.channels.sites	replace

• 다음 필드가 추가되었습니다.

  리소스	필드
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• 다음 목록 메서드의 최대 페이지 크기가 늘어났습니다.

  메서드	이전 최대 페이지 크기	새 최대 페이지 크기
  advertisers.channels.sites.list	100	10000
  advertisers.negativeKeywordLists.negativeKeywords.list	100	1000
  partners.channels.sites.list	100	10000

지원 중단

• 다음 열거형 값은 더 이상 신규 또는 기존 리소스에 할당할 수 없습니다.

  enum	값
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

2021년 2월 24일

게재 신청서에 할당된 타겟팅을 가져올 수 있는 새로운 게재 신청서 타겟팅 서비스 및 추가 일괄 목록 메서드가 도입되었습니다. 광고 소재 리소스가 확장되어 서드 파티 오디오 광고 소재가 사용할 수 있는 출력 전용 광고 소재 입력란이 추가되었습니다. 게재 신청서 및 캠페인 리소스에서 사용할 새로운 실적 목표 유형을 추가했습니다.

새로운 기능

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	받기 list

• 다음 필드가 추가되었습니다.

  리소스	필드
  광고 소재	mp3Audio oggAudio

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  ContentInstreamPosition	CONTENT_INSTREAM_POSITION_UNKNOWN
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_CLICK_CVR PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR PERFORMANCE_GOAL_TYPE_VCPM PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_VTR

2021년 1월 27일

새로운 삽입 주문 유형 필드와 새로운 LineItemType 열거형 값을 도입하여 TV 게재 신청서 및 오버더톱 광고 항목을 검색하고 관리할 수 있습니다. mobileApp 광고 항목 필드를 통해 모바일 앱 광고 항목에 대한 지원이 추가되었습니다. 추가 enum 값을 통해 Exchange, google Audience, SDF 지원이 확장되었습니다. 마지막 업데이트 시간을 기준으로 advertisers.list 값을 필터링하고 정렬할 수 있는 기능을 도입했습니다.

새로운 기능

• 다음 필드가 추가되었습니다.

  리소스	필드
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  Exchange	EXCHANGE_SHARETHROUGH EXCHANGE_SOUNDCAST
  GoogleAudienceType	GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC GOOGLE_AUDIENCE_TYPE_LIFE_EVENT
  LineItemType	LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP
  SdfVersion	SDF_VERSION_5_3

• 이제 다음 목록 메서드를 다음 필드를 기준으로 정렬하고 필터링할 수 있습니다.

  메서드	필드
  광고주	updateTime

2020년 12월 4일

지역 지역 타겟팅 옵션을 검색하고 여러 리소스 목록 메서드 결과를 최종 업데이트 시간을 기준으로 필터링하는 기능이 추가되었습니다. 광고 항목에서 지원 중단된 지역 타겟팅을 사용하는 경우를 사용자에게 알리는 새로운 LineItemWarningMessage가 도입되었습니다.

새로운 기능

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  targetingTypes.targetingOptions	검색

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  Exchange	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• 이제 다음 목록 메서드를 다음 필드를 기준으로 정렬하고 필터링할 수 있습니다.

  메서드	필드
  advertisers.campaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

2020년 11월 5일

관련 광고 항목 지출을 시작하는 수동 트리거를 생성, 할당, 활성화하는 기능이 추가되었습니다. 설정된 경우 타겟팅된 잠재고객과 유사한 사용자를 포함하도록 광고 항목의 타겟팅을 확장할 수 있는 타겟팅 확장 옵션이 도입되었습니다. 제3자 인증 타겟팅에 사용되는 DoubleVerify 및 Integral Ad Science 객체에 맞춤 세그먼트 ID 필드를 추가했습니다.

새로운 기능

• 다음 서비스가 추가되었습니다.

  서비스	메서드
  advertisers.manualTriggers	활성화 만들기 비활성화 받기 list patch

• 다음 필드가 추가되었습니다.

  리소스	필드
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• 이제 다음 목록 메서드를 다음 필드로 필터링할 수 있습니다.

  메서드	필드
  advertisers.lineItems.list	filter.triggerId

2020년 10월 12일

광고 항목 리소스와 클릭률 (CTR) 실적 목표 유형에 검색 가능한 경고 메시지가 도입되었습니다. 광고 항목을 나열할 때 warningMessages를 필터링 가능한 필드로 추가했습니다.

새로운 기능 외에 새로운 할당량 한도가 적용되며 일괄 요청 활용에 대한 새 문서도 제공됩니다.

새로운 기능

• 다음 필드가 추가되었습니다.

  리소스	필드
  LineItem	warningMessages

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• 이제 다음 목록 메서드를 다음 필드로 필터링할 수 있습니다.

  메서드	필드
  advertisers.lineItems.list	warningMessages

2020년 8월 28일

광고주 감사 방법의 응답에 새 필드를 추가하고 다양한 목록 메서드에 새 필터링 가능한 필드를 추가했습니다.

새로운 기능

• 다음 필드가 추가되었습니다.

  리소스	필드
  광고주.감사 응답 본문	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• 이제 다음 목록 메서드를 다음 필드로 필터링할 수 있습니다.

  메서드	필드
  advertisers.list	advertiserId displayName
  advertisers.campaigns.list	campaignId displayName
  advertisers.insertionOrders.list	budget.budget_segments.date_range.end_date displayName
  advertisers.lineItems.list	displayName lineItemId
  targetingTypes.targetingOptions.list	carrierAndIspDetails.type geoRegionDetails.geo_region_type

2020년 8월 4일

새로운 사용자 관리, 파트너, 파트너 타겟팅 서비스가 출시되었습니다. 사용자가 계정 항목 한도에 도달하지 않도록 사전에 방지하는 도구를 도입했습니다. 오디오 광고 항목, 그리고 광고 항목 및 게재 신청서 입찰 전략의 맞춤 입찰 알고리즘 사용에 대한 지원이 추가되었습니다.

새로운 기능

• 다음 서비스가 추가되었습니다.

  서비스	메서드
  customBiddingAlgorithms	받기 list
  파트너	bulkEditPartnerAssignedTargetingOptions 받기 list
  partners.targetingTypes.assignedTargetingOptions	만들기 삭제 받기 list
  사용자	bulkEditAssignedUserRoles 만들기 삭제 받기 list patch

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  광고주	감사

• 다음 필드가 추가되었습니다.

  리소스	필드
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• 이제 다음 목록 메서드를 다음 필드를 기준으로 정렬하고 필터링할 수 있습니다.

  메서드	필드
  advertisers.lineItems.list	flight.dateRange.endDate

• 다음 서비스에 사용할 범위가 추가되었습니다.

  범위	서비스
  https://www.googleapis.com/auth/display-video-user-management	사용자

2020년 6월 24일

파트너 및 광고주 채널의 생성 메서드, 새로운 FirstAndThirdPartyAudience 필드, 추가 교환 열거형 값이 추가된 소규모 업데이트가 출시되었습니다.

새로운 기능

• 다음 서비스가 추가되었습니다.

  서비스	메서드
  advertisers.channels	만들기
  partners.channels	만들기

• 다음 필드가 추가되었습니다.

  리소스	필드
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType description displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• 다음과 같은 열거형 값이 추가되었습니다.

  enum	값
  Exchange	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• 이제 다음 목록 메서드를 다음 필드로 필터링할 수 있습니다.

  메서드	필드
  advertisers.creatives.list	creativeId

2020년 6월 2일

타겟팅 가능한 항목의 하위 집합을 생성, 패치, 채우는 기능이 도입되었으며 채널, 디지털 콘텐츠 라벨 제외, 민감한 카테고리 제외의 세 가지 타겟팅 유형에 대해 광고주 수준 타겟팅을 수정할 수 있는 기능이 추가되었습니다.

새로운 기능

• 다음 서비스가 추가되었습니다.

  서비스	메서드
  advertisers.channels.sites	bulkEdit 만들기 삭제 list
  advertisers.locationLists.assignedLocations	bulkEdit 만들기 삭제 list
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit 만들기 삭제 list
  advertisers.targetingTypes.assignedTargetingOptions	만들기 삭제 받기 list
  inventorySourceGroups.assignedInventorySources	bulkEdit 만들기 삭제 list
  partners.channels.sites	bulkEdit 만들기 삭제 list

• 다음 메서드가 추가되었습니다.

  서비스	메서드
  광고주	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	patch
  advertisers.locationLists	만들기 patch
  advertisers.negativeKeywordLists	만들기 삭제 patch
  inventorySourceGroups	만들기 삭제 patch
  partners.channels	patch

• 다음 필드가 추가되었습니다.

  리소스	필드
  광고주	servingConfig
  광고 소재	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

2020년 4월 27일

대규모 기능 세트가 출시되어 API의 범위가 SDF 이상으로 확장되었습니다. 광고주, 캠페인, 게재 신청서, 광고 항목, 광고 소재와 같은 항목을 생성, 검색, 업데이트, 삭제할 수 있는 핵심 리소스 관리가 추가되었습니다. 새로운 기능을 사용하면 광고 항목 수준에서 타겟팅을 수정할 수도 있습니다.

새로운 기능

다음 서비스가 추가되었습니다.

서비스	메서드
광고주	만들기 삭제 받기 list patch
advertisers.assets	업로드
advertisers.campaigns	만들기 삭제 받기 list patch
advertisers.channels	받기 list
advertisers.creatives	만들기 삭제 받기 list patch
advertisers.insertionOrders	만들기 삭제 받기 list patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions 만들기 삭제 받기 list patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	만들기 삭제 받기 list
advertisers.locationLists	받기 list
advertisers.negativeKeywordLists	받기 list
combinedAudiences	받기 list
customLists	받기 list
firstAndThirdPartyAudiences	받기 list
floodlightGroups	받기 patch
googleAudiences	받기 list
inventorySourceGroups	받기 list
inventorySources	받기 list
partners.channels	받기 list
partners.channels	받기 list

2020년 3월 9일

Display & Video 360 API v1이 출시되었습니다. API의 초기 버전입니다.

알려진 문제

없음