출시 노트

이 페이지에서는 Display & Video 360 API의 출시 노트를 제공합니다.

최신 API 버전: v3

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

• 다음 enum 값은 지원 중단되었습니다.

  열거형	값
  SdfVersion	SDF_VERSION_5_5

2024년 8월 15일

새로운 기능

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

v3

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

  열거형	값
  거래소	EXCHANGE_NETFLIX

v2

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

  열거형	값
  거래소	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_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

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

  리소스	필드
  사용자	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 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에서 새로운 LineItemType 값 3개, 새로운 YoutubeAndPartnersBiddingStrategyType 1개, 새로운 PartnerCostType 1개에 대한 지원을 추가했습니다.

v3

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

  서비스	방법
  advertisers.adGroupAds	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	만들기 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_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_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를 공개 베타에서 정식 버전으로 이전했습니다.

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

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

세 가지 새로운 LineItemType 값으로 식별되는 YouTube 및 파트너 프리미엄 광고 항목을 검색하는 지원을 추가했습니다.

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	만들기 삭제
  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에 세 가지 새로운 거래소에 대한 지원이 추가되었습니다.

새로운 기능

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에서 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	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	환경
  ExchangeAssignedTargetingOptionDetails	exchange
  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가 있는 광고만 검색할 수 있는 새로운 filter 쿼리 매개변수 기능을 advertisers.creatives.list 메서드에 사용 설정했습니다.

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를 만들고 기존 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에 근접 타겟팅 지원을 추가했습니다.

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

맞춤 입찰 알고리즘 리소스에 새로운 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에 개방형 측정이 사용 설정된 인벤토리 타겟팅에 대한 지원을 추가했습니다.

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에 네이티브 콘텐츠 위치 타겟팅 지원을 추가했습니다.

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

광고주의 entityStatus 필드에 ENTITY_STATUS_PAUSED enum 값 지원을 사용 설정했습니다.

새로운 기능

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

  서비스	방법
  advertisers.invoices	list lookupInvoiceCurrency

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

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

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

  열거형	값
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  교환	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• 이제 다음 필드에 다음 enum 값을 사용할 수 있습니다.

  리소스	필드	값
  광고주	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	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 광고 항목 필드를 통한 모바일 앱 광고 항목 지원을 추가했습니다. 추가 enum 값을 통해 exchange, google audience, SDF 지원을 확장했습니다. 최근 업데이트 시간을 기준으로 advertisers.list 값을 필터링하고 정렬하는 기능을 도입했습니다.

새로운 기능

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

  리소스	필드
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

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

  열거형	값
  교환	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	search

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

  열거형	값
  교환	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 만들기 비활성화 get list 패치

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

  리소스	필드
  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	만들기 삭제 get list
  users	bulkEditAssignedUserRoles 만들기 삭제 get list 패치

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

  서비스	방법
  광고주	감사

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

  리소스	필드
  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 필드, 추가 exchange enum 값을 추가하는 소규모 업데이트를 출시했습니다.

새로운 기능

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

  서비스	방법
  advertisers.channels	만들기
  partners.channels	만들기

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

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

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

  열거형	값
  교환	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	만들기 삭제 get list
  inventorySourceGroups.assignedInventorySources	bulkEdit 만들기 삭제 list
  partners.channels.sites	bulkEdit 만들기 삭제 list

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

  서비스	방법
  광고주	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	패치
  advertisers.locationLists	만들기 패치
  advertisers.negativeKeywordLists	만들기 삭제 패치
  inventorySourceGroups	만들기 삭제 패치
  partners.channels	패치

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

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

2020년 4월 27일

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

새로운 기능

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

서비스	방법
광고주	만들기 삭제 get list 패치
advertisers.assets	업로드
advertisers.campaigns	만들기 삭제 get list 패치
advertisers.channels	get list
advertisers.creatives	만들기 삭제 get list 패치
advertisers.insertionOrders	만들기 삭제 get list 패치
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions 만들기 삭제 get list 패치
advertisers.lineItems.targetingTypes.assignedTargetingOptions	만들기 삭제 get list
advertisers.locationLists	get list
advertisers.negativeKeywordLists	get list
combinedAudiences	get list
customLists	get list
firstAndThirdPartyAudiences	get list
floodlightGroups	get 패치
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의 초기 버전입니다.

알려진 문제

없음