보관처리된 출시 노트

이 페이지에서는 지원이 종료된 버전의 Display & Video 360 API의 출시 노트를 제공합니다.

모든 출시의 라이브 버전에 대한 기본 출시 노트 페이지로 이동하세요.

2024년 12월 4일

새로운 기능

Core 및 Tubi Exchange 값에 대한 지원이 추가되었습니다.

firstAndThirdPartyAudiences.list의 최대 허용 페이지 크기가 200에서 5000로 증가했습니다. firstAndThirdPartyAudiences.list 요청의 pageSize 파라미터를 업데이트하여 할당량 사용을 추가로 최적화합니다.

v3

• 다음 enum 값이 추가되었습니다.

  열거형	값
  Exchange	EXCHANGE_CORE EXCHANGE_TUBI

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

  메서드	새 최대 페이지 크기
  firstAndThirdPartyAudiences.list	5000

2024년 10월 22일

새로운 기능

조회당비용 실적 목표에 대한 지원이 추가되었습니다.

연결된 기기의 타겟팅을 설정하고 검색하는 기능이 추가되었습니다.

서드 파티 검증 기관 타겟팅에 새로운 Adloox 브랜드 안정성 설정이 추가되었습니다.

현재 비공개 베타로 제공되는 v8 구조화된 데이터 파일 다운로드 지원이 추가되었습니다.

v3

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

  객체

  필드

  Adloox

  adultExplicitSexualContent armsAmmunitionContent crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent deathInjuryMilitaryConflictContent debatedSensitiveSocialIssueContent displayIabViewability excludedFraudIvtMfaCategories hateSpeechActsAggressionContent illegalDrugsTobaccoEcigarettesVapingAlcoholContent misinformationContent obscenityProfanityContent onlinePiracyContent spamHarmfulContent terrorismContent videoIabViewability

• 다음 enum 값이 추가되었습니다.

  열거형	값
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

지원 중단된 값

2024년 10월 3일에 지원이 종료됨에 따라 SDF v5.5 지원이 삭제되었습니다.

v3

• 다음 열거형 값은 지원 중단되었습니다.

  열거형	값
  SdfVersion	SDF_VERSION_5_5

2024년 8월 15일

새로운 기능

Netflix Exchange 유형 지원이 추가되었습니다.

v3

• 다음 enum 값이 추가되었습니다.

  열거형	값
  Exchange	EXCHANGE_NETFLIX

v2

• 다음 enum 값이 추가되었습니다.

  열거형	값
  Exchange	EXCHANGE_NETFLIX

2024년 7월 15일

새로운 기능

v3에서 QA 형식으로 광고 항목 및 광고 그룹 구조화된 데이터 파일을 다운로드하는 기능이 추가되었습니다.

v3

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

  리소스	필드
  IdFilter	adGroupQaIds lineItemQaIds

• 다음 enum 값이 추가되었습니다.

  열거형	값
  FileType	FILE_TYPE_AD_GROUP_QA FILE_TYPE_LINE_ITEM_QA

2024년 6월 17일

새로운 기능

광고주 수준에서 할당된 키워드 타겟팅 관리에 대한 지원이 추가되었습니다.

삽입 주문 리소스에 새 optimizationObjective 필드가 추가되었습니다. optimizationObjective는 허용 목록에 포함된 고객에게만 제공됩니다.

v3

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

  리소스	필드
  InsertionOrder	optimizationObjective

• 이제 다음 메서드에서 다음 타겟팅 유형을 지원합니다.

  타겟팅 유형	메서드
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

v2

• 이제 다음 메서드에서 다음 타겟팅 유형을 지원합니다.

  타겟팅 유형	메서드
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

2024년 5월 30일

새로운 기능

구조화된 데이터 파일 (SDF) 버전 7.1 지원이 추가되었습니다.

v3

• 다음 enum 값이 추가되었습니다.

  열거형	값
  SdfVersion	SDF_VERSION_7_1

v2

• 다음 enum 값이 추가되었습니다.

  열거형	값
  SdfVersion	SDF_VERSION_7_1

2024년 4월 23일

새로운 기능

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

v3

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

  리소스	필드
  Kpi	kpiAlgorithmId

• 다음 enum 값이 추가되었습니다.

  열거형	값
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	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	EXCHANGE_DRAX
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

2024년 2월 28일

새로운 기능

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

새 거래소 타겟팅 지원이 추가되었습니다.

v3

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

  리소스	필드
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• 다음 enum 값이 추가되었습니다.

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

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

  리소스	필드
  사용자	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

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

  서비스	메서드
  floodlightGroups.floodlightActivities	get list

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

  리소스	필드
  사용자	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

2023년 11월 14일

새로운 기능

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

v3

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

  리소스	필드
  ContactInfoList	동의
  MobileDeviceIdList	동의

v2

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

  리소스	필드
  ContactInfoList	동의
  MobileDeviceIdList	동의

2023년 10월 31일

새로운 기능

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

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

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 필드
• advertisers.create 요청 시 포함해야 하는 Advertiser 리소스의 billingConfig 필드 요구사항과 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	create get list

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

  서비스	메서드
  advertisers.manualTriggers	실행 create 비활성화 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일

새로운 기능

두 개의 거래소와 두 개의 새로운 YouTube 및 파트너 입찰 전략 유형이 추가되었습니다.

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

v2

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

  리소스	필드
  YoutubeAndPartnersSettings	effectiveContentCategory

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

  리소스	필드
  InventorySource	subSitePropertyId

• 다음 enum 값이 추가되었습니다.

  열거형	값
  Exchange	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일

새로운 기능

지원 중단된 excludeFirstPartyAudience 필드가 true로 설정된 경우 광고 항목의 warningMessages 필드에 할당되는 새로운 LineItemWarningMessage 값이 추가되었습니다. excludeFirstPartyAudience 필드는 2023년 3월 25일 이후 지원이 중단되고 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	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	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

2022년 12월 6일

새로운 기능

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

타겟팅을 가져오고 삭제할 때 assignedTargetingOptionId 대신 사용할 수 있는 새 assignedTargetingOptionIdAlias 필드가 AssignedTargetingOption 리소스에 추가되었습니다. 이 필드는 열거형을 통해 할당된 타겟팅 유형의 할당된 타겟팅 옵션에만 설정됩니다. 별칭 값은 관련 enum 값을 문자열로 나타낸 것입니다.

Advertiser 리소스에 새로운 billingConfig 필드가 추가되었습니다.

세 개의 새로운 LineItemType 값으로 식별되는 YouTube + 파트너 OTT 광고 항목을 가져오는 지원이 추가되었습니다.

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

2022년 10월 27일

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

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

새로운 기능

v2

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

  서비스	메서드
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	create 삭제
  advertisers.lineItems	duplicate

v1

v1에 새로운 기능이 추가되지 않았습니다.

2022년 9월 20일

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

• advertisers.lineItems 및 advertisers.lineItems.targetingTypes.assignedTargetingOptions 서비스에서 get 및 list 메서드를 사용하여 YouTube + 파트너 광고 항목과 타겟팅 설정을 가져올 수 있습니다.
• 단일 요청으로 여러 광고 항목에 할당된 타겟팅을 수정하고 검색 할 수 있는 advertisers.lineItems 서비스의 두 가지 새로운 대량 타겟팅 방법
• 사용자가 단일 요청으로 여러 광고 항목의 entityStatus을 업데이트할 수 있는 새로운 bulkUpdate 메서드
• targetingTypes.targetingOptions 서비스를 사용하여 검색된 타겟팅 옵션 ID 대신 열거형 값을 사용하여 할당되고 검색되는 타겟팅 유형의 하위 집합의 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
  파트너	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

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

  타겟팅 유형	열거형 유형
  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	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	exchange
  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	exchange
  GenderAssignedTargetingOptionDetails	gender
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	viewability

• 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	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에서 다음 열거형 값이 삭제되었습니다.

  열거형	값
  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에 다음 열거형 값이 추가되었습니다.

  열거형	값
  Exchange	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	create editGuaranteedOrderReadAccessors get list patch
  inventorySources	create 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	create 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를 만들고 기존 customBiddingAlgorithms를 업데이트하는 함수
• 사용 가능한 리소스 위치를 가져온 다음 해당 위치에 파일을 업로드하는 프로세스를 통해 스크립트를 업로드하는 기능
• customBiddingScripts을 가져오고 만드는 새 customBiddingAlgorithms.scripts 서비스

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

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

새로운 기능

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

  서비스	메서드
  customBiddingAlgorithms	create patch uploadScript
  customBiddingAlgorithms.scripts	create get list
  media	upload

• 다음 enum 값이 추가되었습니다.

  열거형	값
  SdfVersion	SDF_VERSION_5_4

2021년 9월 14일

타겟팅 유형 TARGETING_TYPE_BUSINESS_CHAIN 및 TARGETING_TYPE_POI에 근접성 타겟팅 지원이 추가되었습니다.

targetingTypes.targetingOptions.get 또는 targetingTypes.targetingOptions.list 메서드를 통해 검색할 수 없으므로 targetingTypes.targetingOptions.search를 사용하여 사용 가능한 TARGETING_TYPE_BUSINESS_CHAIN 및 TARGETING_TYPE_POI 타겟팅 옵션을 검색하는 기능이 추가되었습니다.

맞춤 입찰 알고리즘 리소스에 새로운 sharedAdvertiserIds 및 customBiddingAlgorithmState 필드가 도입되었으며 GOAL_BUILDER_BASED 맞춤 입찰 알고리즘 유형에 대한 지원이 추가되었습니다.

Exchange 열거형에 두 개의 새 값이 추가되었습니다.

새로운 기능

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

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

• 다음 enum 값이 추가되었습니다.

  열거형	값
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Exchange	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 enum 값 지원이 사용 설정되었습니다.

새로운 기능

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

  서비스	메서드
  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 필드에 포함되지 않아야 한다는 요구사항이 삭제되었습니다.
• list sites 또는 list negative keywords 응답의 단일 페이지에서 반환할 수 있는 최대 항목 수가 증가했습니다.

새로운 기능

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

  서비스	메서드
  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	get 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일

새 InsertionOrderType 필드와 새 LineItemType enum 값을 도입하여 TV 게재 신청서와 오버더톱 광고 항목의 검색 및 관리를 사용 설정했습니다. mobileApp 광고 항목 필드를 통해 모바일 앱 광고 항목 지원이 추가되었습니다. 추가 열거형 값을 통해 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일

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

새로운 기능

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

  서비스	메서드
  targetingTypes.targetingOptions	search

• 다음 enum 값이 추가되었습니다.

  열거형	값
  Exchange	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

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

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

2020년 11월 5일

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

새로운 기능

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

  서비스	메서드
  advertisers.manualTriggers	activate create deactivate get 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일

광고주 감사 메서드의 응답에 새 필드가 추가되었고 다양한 목록 메서드에 필터링 가능한 새 필드가 추가되었습니다.

새로운 기능

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

  리소스	필드
  Advertisers.Audit 응답 본문	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	get list
  파트너	bulkEditPartnerAssignedTargetingOptions get list
  partners.targetingTypes.assignedTargetingOptions	create delete get list
  users	bulkEditAssignedUserRoles create delete get list patch

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

  서비스	메서드
  광고주	audit

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

  리소스	필드
  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	users

2020년 6월 24일

파트너 및 광고주 채널의 생성 메서드, 새로운 FirstAndThirdPartyAudience 필드, 추가 exchange enum 값을 추가하는 작은 업데이트가 출시되었습니다.

새로운 기능

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

  서비스	메서드
  advertisers.channels	create
  partners.channels	create

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

  리소스	필드
  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 create delete list
  advertisers.locationLists.assignedLocations	bulkEdit create delete list
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit create delete list
  advertisers.targetingTypes.assignedTargetingOptions	create delete get list
  inventorySourceGroups.assignedInventorySources	bulkEdit create delete list
  partners.channels.sites	bulkEdit create delete list

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

  서비스	메서드
  광고주	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	patch
  advertisers.locationLists	create patch
  advertisers.negativeKeywordLists	create delete patch
  inventorySourceGroups	create delete patch
  partners.channels	patch

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

  리소스	필드
  advertiser	servingConfig
  creative	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

2020년 4월 27일

SDF를 넘어 API 범위를 확장하는 대규모 기능 세트가 출시되었습니다. 광고주, 캠페인, 삽입 주문, 광고 항목, 광고 소재와 같은 항목을 생성, 검색, 업데이트, 삭제할 수 있는 핵심 리소스 관리가 추가되었습니다. 또한 새로운 기능을 통해 광고 항목 수준에서 타겟팅을 수정할 수 있습니다.

새로운 기능

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

서비스	메서드
광고주	create delete get list patch
advertisers.assets	upload
advertisers.campaigns	create delete get list patch
advertisers.channels	get list
advertisers.creatives	create delete get list patch
advertisers.insertionOrders	create delete get list patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create delete get list patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	create delete get list
advertisers.locationLists	get list
advertisers.negativeKeywordLists	get list
combinedAudiences	get list
customLists	get list
firstAndThirdPartyAudiences	get list
floodlightGroups	get patch
googleAudiences	get list
inventorySourceGroups	get list
inventorySources	get list
partners.channels	get list
partners.channels	get list

2020년 3월 9일

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

알려진 문제

없음