Ghi chú phát hành

Trang này cung cấp ghi chú phát hành cho API Display & Video 360.

Phiên bản API mới nhất: v3

Ngày 22 tháng 10 năm 2024

Tính năng mới

Thêm tính năng hỗ trợ cho mục tiêu hiệu suất về chi phí cho mỗi lượt xem.

Thêm chức năng đặt và truy xuất tiêu chí nhắm mục tiêu của các thiết bị đã kết nối.

Thêm chế độ cài đặt mới về sự an toàn cho thương hiệu Adloox trong phần nhắm mục tiêu theo trình xác minh bên thứ ba.

Thêm tính năng hỗ trợ tải Tệp dữ liệu có cấu trúc v8 xuống. Tính năng này hiện đang ở giai đoạn thử nghiệm beta kín.

v3

• Các trường sau đã được thêm:

  Đối tượng

  (Các) trường

  Adloox

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

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

Các giá trị không dùng nữa

Ngừng hỗ trợ SDF phiên bản 5.5 do ngừng hoạt động từ ngày 3 tháng 10 năm 2024.

v3

• Các giá trị enum sau đây không còn được dùng nữa:

  Enum	(Các) giá trị
  SdfVersion	SDF_VERSION_5_5

Ngày 15 tháng 8 năm 2024

Tính năng mới

Thêm tính năng hỗ trợ cho loại Exchange của Netflix.

v3

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  Sàn giao dịch	EXCHANGE_NETFLIX

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  Sàn giao dịch	EXCHANGE_NETFLIX

Ngày 15 tháng 7 năm 2024

Tính năng mới

Thêm tính năng hỗ trợ tải Tệp dữ liệu có cấu trúc của Mục hàng và Nhóm quảng cáo xuống ở định dạng QA trong phiên bản 3.

v3

• Các trường sau đây đã được thêm:

  Tài nguyên	(Các) trường
  IdFilter	adGroupQaIds lineItemQaIds

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  FileType	FILE_TYPE_AD_GROUP_QA FILE_TYPE_LINE_ITEM_QA

Ngày 17 tháng 6 năm 2024

Tính năng mới

Thêm tính năng hỗ trợ quản lý tiêu chí nhắm mục tiêu theo từ khoá được chỉ định ở cấp nhà quảng cáo.

Thêm trường optimizationObjective mới vào tài nguyên đơn đặt hàng chèn. optimizationObjective chỉ dành cho những khách hàng có trong danh sách cho phép.

v3

• Các trường sau đây đã được thêm:

  Tài nguyên	(Các) trường
  InsertionOrder	optimizationObjective

• Các phương thức sau hiện hỗ trợ các loại tiêu chí nhắm mục tiêu sau:

  Loại nhắm mục tiêu	(Các) phương thức
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

phiên bản 2

• Các phương thức sau hiện hỗ trợ các loại tiêu chí nhắm mục tiêu sau:

  Loại nhắm mục tiêu	(Các) phương thức
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

Ngày 30 tháng 5 năm 2024

Tính năng mới

Thêm tính năng hỗ trợ cho Tệp dữ liệu có cấu trúc (SDF) phiên bản 7.1.

v3

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  SdfVersion	SDF_VERSION_7_1

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  SdfVersion	SDF_VERSION_7_1

Ngày 23 tháng 4 năm 2024

Tính năng mới

Thêm tính năng hỗ trợ cho các loại KPI, nền tảng trao đổi và nền tảng ứng dụng mới.

v3

• Các trường sau đây đã được thêm:

  Tài nguyên	(Các) trường
  KPI	kpiAlgorithmId

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Sàn giao dịch	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

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Sàn giao dịch	EXCHANGE_DRAX
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

Ngày 28 tháng 2 năm 2024

Tính năng mới

Thêm chức năng xoá rõ ràng thành viên khỏi đối tượng so khớp khách hàng.

Thêm tính năng hỗ trợ nhắm mục tiêu đơn vị trao đổi mới.

v3

• Các trường sau đây đã được thêm:

  Tài nguyên	(Các) trường
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  Sàn giao dịch	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

phiên bản 2

• Các trường sau đây đã được thêm:

  Tài nguyên	(Các) trường
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  Sàn giao dịch	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

Ngày 29 tháng 1 năm 2024

Tính năng mới

Thêm khả năng truy xuất các hoạt động Floodlight thông qua dịch vụ floodlightGroups.floodlightActivities mới.

Thêm một trường mới cho biết liệu mục hàng YouTube và Đối tác có bao gồm khoảng không quảng cáo trên Google TV trong tiêu chí nhắm mục tiêu hay không.

Thêm một trường mới để chuyển tiếp thời gian đăng nhập gần đây nhất của một người dùng Display & Video 360.

v3

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  floodlightGroups.floodlightActivities	get list

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Người dùng	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

phiên bản 2

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  floodlightGroups.floodlightActivities	get list

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Người dùng	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

Ngày 14 tháng 11 năm 2023

Tính năng mới

Thêm tính năng hỗ trợ để truyền sự đồng ý của người dùng cuối khi tải thành viên đối tượng khớp theo khách hàng lên trong tất cả các phiên bản đang hoạt động.

v3

• Các trường sau đây đã được thêm:

  Tài nguyên	(Các) trường
  ContactInfoList	sự đồng ý
  MobileDeviceIdList	sự đồng ý

phiên bản 2

• Các trường sau đây đã được thêm:

  Tài nguyên	(Các) trường
  ContactInfoList	sự đồng ý
  MobileDeviceIdList	sự đồng ý

Ngày 31 tháng 10 năm 2023

Tính năng mới

Chuyển phiên bản 3 từ giai đoạn thử nghiệm beta công khai sang giai đoạn phát hành công khai.

Đổi tên giá trị enum AdGroupFormat trong phiên bản 3 để phản ánh chính xác hơn định dạng có liên quan.

Thêm tính năng hỗ trợ cho Tệp dữ liệu có cấu trúc phiên bản 7 bằng cách thêm giá trị enum SDF_VERSION_7 trong phiên bản 2 và 3.

v3

• Các giá trị enum sau đã bị xoá:

  Enum	(Các) giá trị
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  SdfVersion	SDF_VERSION_7

Ngày 2 tháng 10 năm 2023

Tính năng mới

Phát hành phiên bản 3 ở giai đoạn thử nghiệm công khai, bao gồm các thay đổi sau:

• Khả năng quản lý đầy đủ danh sách vị trí ở gần, cho phép sử dụng dịch vụ advertisers.locationLists.assignedLocations để tạo và xoá các vị trí được chỉ định cho tài nguyên TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
• Trường enableOptimizedTargeting boolean mới, thay thế trường targetingExpansionLevel trong đối tượng TargetingExpansionConfig.
• Yêu cầu về trường billingConfig trong tài nguyên Advertiser, bạn phải thêm trường này khi tạo yêu cầu advertisers.create và một trường billingConfig mới trong tài nguyên Partner.
• Tài nguyên AdGroup và AdGroupAd mới thay thế tài nguyên YoutubeAdGroup và YoutubeAdGroupAd trong phiên bản 2.

Hãy làm theo các bước trong hướng dẫn di chuyển của chúng tôi để di chuyển từ phiên bản 2 sang phiên bản 3.

Thêm tính năng hỗ trợ cho 3 giá trị LineItemType mới, một YoutubeAndPartnersBiddingStrategyType mới và một PartnerCostType mới trong phiên bản 2 và 3.

v3

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  advertisers.adGroupAds	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	create get list

• Các phương thức sau đã bị xoá:

  Dịch vụ	(Các) phương thức
  advertisers.manualTriggers	kích hoạt create hủy kích hoạt get danh sách bản vá
  advertisers.youtubeAdGroupAds	get danh sách
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get danh sách
  advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get danh sách

• Hành vi của phương thức sau đây đã thay đổi:

  Phương thức	(Các) thay đổi
  advertisers.locationLists.create	Hiện hỗ trợ tạo tài nguyên TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.patch	Hiện hỗ trợ việc cập nhật tài nguyên TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.assignedLocations.bulkEdit	Hiện hỗ trợ chỉnh sửa hàng loạt tài nguyên AssignedLocation trong tài nguyên TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.assignedLocations.create	Hiện hỗ trợ tạo tài nguyên AssignedLocation trong tài nguyên TARGETING_LOCATION_TYPE_PROXIMITY LocationList.

• Các tham số truy vấn sau đây đã được thêm:

  Phương thức	(Các) tham số
  inventorySources.get	advertiserId

• Các trường sau đây đã được đặt là bắt buộc:

  Tài nguyên	(Các) trường
  Nhà quảng cáo	billingConfig

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	kpi
  Đối tác	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• Các trường sau đây đã bị xoá:

  Tài nguyên	(Các) trường
  InsertionOrder	performanceGoal billableOutcome
  TargetingExpansionConfig	excludeFirstPartyAudience targetingExpansionLevel
  YoutubeAndPartnersSettings	biddingStrategy thirdPartyMeasurementSettings
  YoutubeAndPartnersInventorySourceConfig	includeYoutubeSearch includeYoutubeVideos

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  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

• Các giá trị enum sau đã bị xoá:

  Enum	(Các) giá trị
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  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

Ngày 25 tháng 8 năm 2023

Tính năng mới

Hỗ trợ thêm hai sàn giao dịch và hai loại chiến lược giá thầu mới của YouTube và Đối tác.

Thêm trường effectiveContentCategory mới vào mục riêng của YouTube và đối tác để hiển thị YoutubeAndPartnersContentCategory mà mục riêng sử dụng khi xem xét các giá trị được chỉ định ở cả cấp nhà quảng cáo và cấp mục riêng.

phiên bản 2

• Các trường sau đây đã được thêm:

  Tài nguyên	(Các) trường
  YoutubeAndPartnersSettings	effectiveContentCategory

• Các trường sau đây đã bị xoá:

  Tài nguyên	(Các) trường
  InventorySource	subSitePropertyId

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  Sàn giao dịch	EXCHANGE_HIVESTACK EXCHANGE_RESET_DIGITAL
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Ngày 5 tháng 6 năm 2023

Tính năng mới

Thêm giá trị SdfVersion mới cho Tệp dữ liệu có cấu trúc (SDF) phiên bản 6 trong phiên bản 1 và 2.

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  SdfVersion	SDF_VERSION_6

v1

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  SdfVersion	SDF_VERSION_6

Ngày 9 tháng 3 năm 2023

Tính năng mới

Thêm một giá trị LineItemWarningMessage mới sẽ được chỉ định cho trường warningMessages của mục hàng nếu trường này có trường excludeFirstPartyAudience không dùng nữa được đặt thành true. Trường excludeFirstPartyAudience sẽ ngừng hoạt động và được đặt thành false sau ngày 25 tháng 3 năm 2023.

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

Ngày 8 tháng 2 năm 2023

Tính năng mới

Thêm khả năng truy xuất tài nguyên YouTubeAdGroup và YouTubeAdGroupAd, cũng như tiêu chí nhắm mục tiêu tài nguyên của Nhóm quảng cáo trên YouTube. Ngoài ra, chúng tôi cũng đã thêm các loại tiêu chí nhắm mục tiêu mới có thể truy xuất được dùng ở cấp Nhóm quảng cáo trên YouTube. Hãy đọc trang hướng dẫn mới về cách truy xuất tài nguyên của YouTube và Đối tác để biết thêm thông tin.

Thêm tính năng hỗ trợ cho 4 sàn giao dịch khác trong phiên bản 1 và 2.

phiên bản 2

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• Các trường sau đã được thêm:

  Dịch vụ	(Các) phương thức
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  Sàn giao dịch	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

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  Sàn giao dịch	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

Ngày 6 tháng 12 năm 2022

Tính năng mới

Chuyển phiên bản 2 từ giai đoạn thử nghiệm beta công khai sang giai đoạn phát hành công khai.

Thêm trường assignedTargetingOptionIdAlias mới vào tài nguyên AssignedTargetingOption. Bạn có thể sử dụng trường này thay cho assignedTargetingOptionId khi truy xuất và xoá tiêu chí nhắm mục tiêu. Trường này chỉ được đặt cho các tuỳ chọn nhắm mục tiêu được chỉ định của các loại nhắm mục tiêu được chỉ định thông qua enum. Giá trị bí danh là giá trị enum có liên quan dưới dạng chuỗi.

Thêm trường billingConfig mới vào tài nguyên Advertiser.

Thêm tính năng hỗ trợ truy xuất các mục riêng của YouTube và đối tác trên truyền hình kỹ thuật số, được xác định bằng 3 giá trị LineItemType mới.

Tăng kích thước trang tối đa lên 200 cho nhiều phương thức list trong phiên bản 1 và 2. Kích thước trang mặc định không thay đổi.

phiên bản 2

• Các trường sau đây đã được thêm:

  Tài nguyên	(Các) trường
  Nhà quảng cáo	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  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

• Kích thước trang tối đa đã được tăng lên cho các phương thức danh sách sau:

  Phương thức	Kích thước trang tối đa mới
  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

• Kích thước trang tối đa đã được tăng lên cho các phương thức danh sách sau:

  Phương thức	Kích thước trang tối đa mới
  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

Vấn đề đã biết

Bản cập nhật này khắc phục các vấn đề đã biết sau đây trong phiên bản 2:

• Không thể xoá hoặc truy xuất các tuỳ chọn nhắm mục tiêu được chỉ định của các loại nhắm mục tiêu được chỉ định bằng giá trị enum trong phiên bản 2 bằng assignedTargetingOptionId của chúng. Thay vào đó, người dùng dự kiến sẽ sử dụng giá trị enum. Với bản cập nhật này, bạn có thể xoá hoặc truy xuất các tuỳ chọn nhắm mục tiêu được chỉ định này bằng cách sử dụng assignedTargetingOptionId hoặc giá trị enum, được xác định bằng trường assignedTargetingOptionIdAlias mới trong tài nguyên AssignedTargetingOption.
• Yêu cầu bulkUpdate của mục hàng không sử dụng đúng tham số yêu cầu advertisersId, trả về lỗi. Với bản cập nhật này, phương thức đã được khắc phục và tham số yêu cầu đã được đổi tên từ advertisersId thành advertiserId.

Ngày 27 tháng 10 năm 2022

Thêm chức năng sao chép mục hàng hiện có trong InsertionOrder mẹ.

Giới thiệu tính năng hỗ trợ ghi tiêu chí nhắm mục tiêu theo thứ tự chèn một phần cho một tập hợp con các loại tiêu chí nhắm mục tiêu bằng cách thêm các phương thức create và delete vào dịch vụ advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

Tính năng mới

phiên bản 2

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	create xóa
  advertisers.lineItems	mục trùng lặp

v1

Không có tính năng mới nào được thêm vào phiên bản 1.

Ngày 20 tháng 9 năm 2022

Phát hành phiên bản 2 ở giai đoạn thử nghiệm công khai, bao gồm các thay đổi sau:

• Khả năng truy xuất các mục riêng của YouTube và đối tác cũng như chế độ cài đặt tiêu chí nhắm mục tiêu của các mục đó bằng cách sử dụng phương thức get và list trong các dịch vụ advertisers.lineItems và advertisers.lineItems.targetingTypes.assignedTargetingOptions .
• Hai phương thức nhắm mục tiêu hàng loạt mới trong dịch vụ advertisers.lineItems cho phép chỉnh sửa và truy xuất tiêu chí nhắm mục tiêu được chỉ định trên nhiều mục hàng bằng một yêu cầu duy nhất.
• Phương thức bulkUpdate mới cho phép người dùng cập nhật entityStatus của nhiều mục hàng trong một yêu cầu.
• Logic nhắm mục tiêu mới yêu cầu các tài nguyên AssignedTargetingOption của một nhóm con các loại nhắm mục tiêu được gán và truy xuất bằng các giá trị enum thay vì mã tuỳ chọn nhắm mục tiêu được truy xuất bằng dịch vụ targetingTypes.targetingOptions.

Hãy làm theo các bước trong hướng dẫn di chuyển của chúng tôi để di chuyển từ phiên bản 1 sang phiên bản 2.

Thêm tính năng hỗ trợ cho 3 sàn giao dịch mới trong phiên bản 1.

Tính năng mới

phiên bản 2

Sau đây là danh sách các thay đổi giữa phiên bản 1 và phiên bản 2:

• Các phương thức sau đã được thêm vào phiên bản 2:

  Dịch vụ	(Các) phương thức
  advertisers.lineItems	bulkEditAssignedTargetingOptions bulkListAssignedTargetingOptions bulkUpdate

• Các phương thức sau đã bị xoá trong phiên bản 2:

  Dịch vụ	(Các) phương thức
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• Các phương thức sau đây đã được đổi tên trong phiên bản 2:

  Dịch vụ	Tên phương thức cũ	Tên phương thức mới
  nhà quảng cáo	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  partners	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• Tài nguyên AssignedTargetingOption của các loại tiêu chí nhắm mục tiêu sau đây sử dụng enum để chỉ định tiêu chí nhắm mục tiêu trong phiên bản 2. Trường assignedTargetingOptionId cho tài nguyên AssignedTargetingOption của các loại tiêu chí nhắm mục tiêu này cũng đã được cập nhật trong phiên bản 2 để sử dụng phiên bản chuỗi của các giá trị enum:

  Loại nhắm mục tiêu	Loại 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	Môi trường
  TARGETING_TYPE_EXCHANGE	Sàn giao dịch
  TARGETING_TYPE_GENDER	Giới tính
  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	Khả năng xem

• Các trường sau đã được thêm vào phiên bản 2:

  Tài nguyên	(Các) trường
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	trao đổi
  FrequencyCap	maxViews
  LineItem	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• Các trường sau đã bị xoá trong phiên bản 2:

  Tài nguyên	(Các) trường
  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

• Các trường sau đây đã được đặt là bắt buộc trong phiên bản 2:

  Tài nguyên	(Các) trường
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	môi trường
  ExchangeAssignedTargetingOptionDetails	trao đổi
  GenderAssignedTargetingOptionDetails	gender
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	khả năng xem

• Các giá trị enum sau đây đã được thêm vào phiên bản 2:

  Enum	(Các) giá trị
  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
  Sàn giao dịch	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

• Các giá trị enum sau đây đã bị xoá trong phiên bản 2:

  Enum	(Các) giá trị
  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

• Các giá trị enum sau đây đã được thêm vào phiên bản 1:

  Enum	(Các) giá trị
  Sàn giao dịch	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

Ngày 26 tháng 5 năm 2022

Thêm khả năng tạo tài nguyên InventorySource và quản lý tài nguyên GuaranteedOrder thông qua các phương thức ghi dịch vụ inventorySources mới và dịch vụ guaranteedOrders mới.

Giới thiệu trường modelReadiness trong tài nguyên CustomBiddingAlgorithm. Trường này liệt kê mức độ sẵn sàng của mô hình thuật toán cho từng nhà quảng cáo có thể truy cập vào mô hình đó.

Bật chức năng tham số truy vấn filter mới cho phương thức advertisers.creatives.list, cho phép người dùng chỉ truy xuất mẫu quảng cáo có updateTime trước hoặc sau một dấu thời gian nhất định.

Thêm tính năng hỗ trợ cho phiên bản SDF mới nhất, v5.5, thông qua việc thêm giá trị enum SdfVersion.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  guaranteedOrders	create editGuaranteedOrderReadAccessors get list bản vá
  inventorySources	create editInventorySourceReadWriteAccessors bản vá

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  SdfVersion	SDF_VERSION_5_5

• Các phương thức danh sách sau đây hiện có thể lọc theo các thuộc tính sau:

  Phương thức	(Các) trường
  advertisers.creatives.list	updateTime

Ngày 31 tháng 3 năm 2022

Thêm tính năng hỗ trợ truy xuất và đặt tiêu chí nhắm mục tiêu theo thời lượng nội dung, loại sự kiện phát trực tiếp và thể loại.

Thêm trường billableOutcome vào đối tượng InsertionOrder.

Giới thiệu trường raiseBidForDeals cho đối tượng MaximizeSpendBidStrategy, cho phép người dùng đặt xem chiến lược đặt giá thầu có áp dụng giá sàn của nhà quảng cáo cho các giao dịch được nhắm mục tiêu hay không.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  AssignedTargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

Ngày 2 tháng 2 năm 2022

Bổ sung tính năng hỗ trợ để tạo, cập nhật và chỉnh sửa thành viên của một số tài nguyên FirstAndThirdPartyAudience So khớp khách hàng. Trang Tải đối tượng So khớp khách hàng lên trong hướng dẫn mới về Cách sử dụng đối tượng của chúng tôi trình bày chi tiết cách sử dụng các tính năng mới này.

Giới thiệu trường reservationType mới trong các tài nguyên InsertionOrder và LineItem để xác định xem một tài nguyên có được Đảm bảo theo thẻ, Đảm bảo theo lập trình hay không được đảm bảo.

Thêm chức năng truy xuất và thiết lập xem một mục hàng có tự động nhắm đến các hệ thống trao đổi mới thông qua trường excludeNewExchanges mới hay không.

Ngoài các tính năng mới, giới hạn hạn mức mặc định đã tăng gấp đôi.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  firstAndThirdPartyAudiences	create editCustomerMatchMembers bản vá

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

Ngày 8 tháng 12 năm 2021

Thêm tính năng hỗ trợ nhắm mục tiêu theo loại nội dung âm thanh trong loại tiêu chí nhắm mục tiêu TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

Ngày 8 tháng 11 năm 2021

Thêm tính năng hỗ trợ đầy đủ để quản lý thuật toán đặt giá thầu tuỳ chỉnh và tập lệnh của thuật toán đó. Nội dung như vậy bao gồm:

• Các hàm để create customBiddingAlgorithms mới và cập nhật customBiddingAlgorithms hiện có.
• Khả năng tải tập lệnh lên thông qua quy trình truy xuất vị trí tài nguyên có sẵn, sau đó tải tệp lên vị trí đó.
• Dịch vụ customBiddingAlgorithms.scripts mới để truy xuất và create customBiddingScripts.

Chúng tôi đã thêm trang Triển khai tính năng Đặt giá thầu tuỳ chỉnh mới vào hướng dẫn Quản lý mục hàng. Trang này mô tả quy trình tạo thuật toán đặt giá thầu tuỳ chỉnh, tải tập lệnh lên và chỉ định thuật toán đặt giá thầu tuỳ chỉnh làm chiến lược đặt giá thầu của mục hàng.

Thêm tính năng hỗ trợ cho phiên bản SDF mới nhất, v5.4, thông qua việc thêm giá trị enum SdfVersion.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  customBiddingAlgorithms	create bản vá uploadScript
  customBiddingAlgorithms.scripts	create get list
  media	tải lên

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  SdfVersion	SDF_VERSION_5_4

Ngày 14 tháng 9 năm 2021

Thêm tính năng hỗ trợ cho tiêu chí nhắm mục tiêu theo khoảng cách trong các loại nhắm mục tiêu TARGETING_TYPE_BUSINESS_CHAIN và TARGETING_TYPE_POI.

Thêm khả năng tìm kiếm các tuỳ chọn nhắm mục tiêu TARGETING_TYPE_BUSINESS_CHAIN và TARGETING_TYPE_POI hiện có bằng cách sử dụng targetingTypes.targetingOptions.search, vì không thể truy xuất các tuỳ chọn này thông qua phương thức targetingTypes.targetingOptions.get hoặc targetingTypes.targetingOptions.list.

Giới thiệu các trường sharedAdvertiserIds và customBiddingAlgorithmState mới vào tài nguyên Thuật toán đặt giá thầu tuỳ chỉnh, đồng thời hỗ trợ thêm loại thuật toán đặt giá thầu tuỳ chỉnh GOAL_BUILDER_BASED.

Thêm hai giá trị mới vào enum Exchange.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  Nội dung yêu cầu TargetingOptions.search	businessChainSearchTerms poiSearchTerms

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Sàn giao dịch	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• Các phương thức danh sách sau đây hiện có thể lọc theo các thuộc tính sau:

  Phương thức	(Các) trường
  customBiddingAlgorithms.list	customBiddingAlgorithmState

Ngày 4 tháng 8 năm 2021

Thêm tính năng hỗ trợ cho tiêu chí nhắm mục tiêu khoảng không quảng cáo đã bật tính năng Đo lường mở trong loại tiêu chí nhắm mục tiêu TARGETING_TYPE_OMID.

Tăng số lượng tối đa các lựa chọn nhắm mục tiêu được chỉ định có thể được trả về trong một trang của nhiều phương thức danh sách lựa chọn nhắm mục tiêu được chỉ định cho nhà quảng cáo, chiến dịch, đơn đặt hàng quảng cáo và mục hàng bằng cách sử dụng tham số phương thức pageSize.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  TargetingType	TARGETING_TYPE_OMID

• Kích thước trang tối đa đã được tăng lên cho các phương thức danh sách sau:

  Phương thức	Kích thước trang tối đa mới
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.targetingTypes.assignedTargetingOptions.list	5000

Ngày 26 tháng 5 năm 2021

Khởi chạy dịch vụ advertisers.invoices, cho phép người dùng:

• truy xuất hoá đơn được phát hành cho một nhà quảng cáo trong một tháng nhất định.
• tra cứu mã đơn vị tiền tệ mà nhà quảng cáo sử dụng trong một tháng nhất định.

Thêm trường campaignBudgets vào tài nguyên chiến dịch. Bạn có thể liên kết các phân đoạn ngân sách của đơn đặt hàng quảng cáo với ngân sách chiến dịch, giới hạn tổng ngân sách của các phân đoạn được liên kết ở mức tổng ngân sách của chiến dịch.

Thêm tính năng hỗ trợ cho tiêu chí nhắm mục tiêu theo vị trí nội dung gốc trong loại tiêu chí nhắm mục tiêu mới TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Giới thiệu trường prismaEnabled mới cho tài nguyên nhà quảng cáo, cho phép người dùng bật tính năng tích hợp với công cụ Prisma của Mediaocean.

Bật tính năng hỗ trợ cho giá trị enum ENTITY_STATUS_PAUSED cho trường entityStatus của Nhà quảng cáo.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  advertisers.invoices	list lookupInvoiceCurrency

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Nhà quảng cáo	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  Chiến dịch	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Sàn giao dịch	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• Các giá trị enum sau đây hiện hợp lệ cho các trường sau:

  Tài nguyên	Trường	(Các) giá trị
  Nhà quảng cáo	entityStatus	ENTITY_STATUS_PAUSED

Ngày 29 tháng 4 năm 2021

Thêm các trường mới vào tài nguyên Kênh và Danh sách từ khoá phủ định. Các trường này trả về số lượng mục dòng bằng cách sử dụng tài nguyên để nhắm mục tiêu. Bật các thuộc tính filter mới cho phương thức danh sách mục hàng, cho phép người dùng chỉ truy xuất các mục hàng đang sử dụng các kênh hoặc danh sách từ khoá phủ định cụ thể trong tiêu chí nhắm mục tiêu.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Kênh	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• Các phương thức danh sách sau đây hiện có thể lọc theo các thuộc tính sau:

  Phương thức	(Các) trường
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

Ngày 30 tháng 3 năm 2021

Thêm một phương thức mới vào dịch vụ mục hàng để tạo một mục hàng có cấu hình mặc định. Các giá trị mặc định này dựa trên loại mục hàng nhất định, cũng như chế độ cài đặt và tiêu chí nhắm mục tiêu được chỉ định của đơn đặt hàng quảng cáo chèn mẹ.

Cho phép truy xuất tiêu chí nhắm mục tiêu của chiến dịch thông qua một dịch vụ nhắm mục tiêu chiến dịch mới và phương thức danh sách lớn bổ sung.

Mở rộng tiêu chí nhắm mục tiêu theo ứng dụng để cho phép nhắm mục tiêu theo ứng dụng trên nhiều nền tảng hơn.

Thực hiện nhiều thay đổi đối với các dịch vụ advertisers.channels.sites, partners.channels.sites và advertisers.negativeKeywordLists.negativeKeywords để giúp bạn quản lý nội dung kênh và danh sách từ khoá phủ định dễ dàng hơn. Những thay đổi này bao gồm:

• Thêm các phương thức replace để cho phép người dùng ghi đè hoàn toàn nội dung hiện có của một kênh hoặc danh sách từ khoá phủ định.
• Xoá yêu cầu không được đưa mục hiện có vào trường createdSites hoặc createdNegativeKeywords của yêu cầu chỉnh sửa hàng loạt.
• Tăng số lượng mục tối đa có thể được trả về trên một trang của phản hồi danh sách trang web hoặc danh sách từ khoá phủ định.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	get list
  advertisers.channels.sites	thay thế
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	thay thế
  partners.channels.sites	thay thế

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• Kích thước trang tối đa đã được tăng lên cho các phương thức danh sách sau:

  Phương thức	Kích thước trang tối đa cũ	Kích thước trang tối đa mới
  advertisers.channels.sites.list	100	10000
  advertisers.negativeKeywordLists.negativeKeywords.list	100	1000
  partners.channels.sites.list	100	10000

Ngừng sử dụng

• Bạn không thể gán các giá trị enum sau đây cho tài nguyên mới hoặc hiện có:

  Enum	(Các) giá trị
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

Ngày 24 tháng 2 năm 2021

Ra mắt dịch vụ nhắm mục tiêu mới cho đơn đặt hàng quảng cáo xen kẽ và phương thức danh sách lớn bổ sung cho phép truy xuất tiêu chí nhắm mục tiêu được chỉ định cho đơn đặt hàng quảng cáo xen kẽ. Mở rộng tài nguyên mẫu quảng cáo, thêm các trường mẫu quảng cáo chỉ có đầu ra để mẫu quảng cáo âm thanh của bên thứ ba sử dụng. Thêm các loại mục tiêu hiệu suất mới để lệnh chèn và tài nguyên chiến dịch sử dụng.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	get danh sách

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Mẫu quảng cáo	mp3Audio oggAudio

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  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

Ngày 27 tháng 1 năm 2021

Cho phép truy xuất và quản lý đơn đặt hàng quảng cáo trên truyền hình và mục hàng trên nền tảng truyền hình trực tuyến thông qua việc giới thiệu trường InsertionOrderType mới và giá trị enum LineItemType mới. Thêm tính năng hỗ trợ cho mục hàng ứng dụng di động thông qua trường mục hàng mobileApp. Mở rộng tính năng hỗ trợ exchange, google audience và SDF thông qua các giá trị enum bổ sung. Ra mắt tính năng lọc và sắp xếp các giá trị advertisers.list theo thời gian cập nhật gần đây nhất.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  Sàn giao dịch	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

• Hiện tại, bạn có thể sắp xếp và lọc các phương thức danh sách sau theo các trường sau:

  Phương thức	(Các) trường
  nhà quảng cáo	updateTime

Ngày 4 tháng 12 năm 2020

Thêm khả năng tìm kiếm các tuỳ chọn nhắm mục tiêu Khu vực địa lý và lọc nhiều kết quả phương thức danh sách tài nguyên theo thời gian cập nhật gần đây nhất. Ra mắt LineItemWarningMessage mới để thông báo cho người dùng về thời điểm một mục hàng đang sử dụng tiêu chí nhắm mục tiêu theo vị trí địa lý không còn được dùng nữa.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  targetingTypes.targetingOptions	tìm kiếm

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  Sàn giao dịch	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• Hiện tại, bạn có thể sắp xếp và lọc các phương thức danh sách sau theo các trường sau:

  Phương thức	(Các) trường
  advertisers.campaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

Ngày 5 tháng 11 năm 2020

Thêm chức năng tạo, chỉ định và kích hoạt trình kích hoạt thủ công để bắt đầu mức chi tiêu của các mục hàng được liên kết. Ra mắt các tuỳ chọn mở rộng tiêu chí nhắm mục tiêu. Khi được đặt, các tuỳ chọn này có thể mở rộng tiêu chí nhắm mục tiêu của một mục hàng để bao gồm cả những người dùng tương tự như những người dùng trong đối tượng được nhắm mục tiêu. Đã thêm các trường mã phân khúc tuỳ chỉnh vào đối tượng DoubleVerify và Integral Ad Science được dùng trong tiêu chí nhắm mục tiêu xác minh của bên thứ ba.

Tính năng mới

• Các dịch vụ sau đây đã được thêm:

  Dịch vụ	(Các) phương thức
  advertisers.manualTriggers	kích hoạt tạo huỷ kích hoạt get danh sách bản vá

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• Hiện tại, bạn có thể lọc các phương thức danh sách sau theo các trường sau:

  Phương thức	(Các) trường
  advertisers.lineItems.list	filter.triggerId

Ngày 12 tháng 10 năm 2020

Giới thiệu thông báo nhắc nhở có thể truy xuất cho tài nguyên mục hàng và loại mục tiêu hiệu suất tỷ lệ nhấp (CTR). Thêm warningMessages làm trường có thể lọc khi liệt kê mục hàng.

Ngoài các tính năng mới, các giới hạn hạn mức mới hiện đã có hiệu lực và chúng tôi cũng đã cung cấp tài liệu mới về cách sử dụng yêu cầu hàng loạt.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  LineItem	warningMessages

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• Hiện tại, bạn có thể lọc các phương thức danh sách sau theo các trường sau:

  Phương thức	(Các) trường
  advertisers.lineItems.list	warningMessages

Ngày 28 tháng 8 năm 2020

Thêm các trường mới vào nội dung phản hồi của phương thức kiểm tra nhà quảng cáo và các trường mới có thể lọc vào nhiều phương thức danh sách.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Advertisers.Audit Response Body	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• Hiện tại, bạn có thể lọc các phương thức danh sách sau theo các trường sau:

  Phương thức	(Các) trường
  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

Ngày 4 tháng 8 năm 2020

Ra mắt các tính năng quản lý người dùng, đối tác và dịch vụ nhắm mục tiêu theo đối tác mới. Ra mắt các công cụ giúp người dùng chủ động tránh đạt đến giới hạn thực thể tài khoản. Thêm tính năng hỗ trợ cho mục hàng âm thanh và sử dụng thuật toán đặt giá thầu tuỳ chỉnh trong chiến lược giá thầu của mục hàng và đơn đặt hàng quảng cáo.

Tính năng mới

• Các dịch vụ sau đây đã được thêm:

  Dịch vụ	(Các) phương thức
  customBiddingAlgorithms	get danh sách
  đối tác	bulkEditPartnerAssignedTargetingOptions get danh sách
  partners.targetingTypes.assignedTargetingOptions	tạo xoá get danh sách
  người dùng	bulkEditAssignedUserRoles tạo xoá get danh sách bản vá

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  nhà quảng cáo	kiểm tra

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• Hiện tại, bạn có thể sắp xếp và lọc các phương thức danh sách sau theo các trường sau:

  Phương thức	(Các) trường
  advertisers.lineItems.list	flight.dateRange.endDate

• Chúng tôi đã thêm các phạm vi sau đây để sử dụng cho các dịch vụ sau:

  Phạm vi	(Các) dịch vụ
  https://www.googleapis.com/auth/display-video-user-management	người dùng

Ngày 24 tháng 6 năm 2020

Ra mắt một bản cập nhật nhỏ để thêm phương thức tạo cho các kênh đối tác và nhà quảng cáo, các trường FirstAndThirdPartyAudience mới và các giá trị enum exchange bổ sung.

Tính năng mới

• Các dịch vụ sau đây đã được thêm:

  Dịch vụ	(Các) phương thức
  advertisers.channels	tạo
  partners.channels	tạo

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType nội dung mô tả displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• Các giá trị enum sau đây đã được thêm:

  Enum	(Các) giá trị
  Sàn giao dịch	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• Hiện tại, bạn có thể lọc các phương thức danh sách sau theo các trường sau:

  Phương thức	(Các) trường
  advertisers.creatives.list	creativeId

Ngày 2 tháng 6 năm 2020

Ra mắt tính năng tạo, vá và điền sẵn một tập hợp con các thực thể có thể nhắm mục tiêu, đồng thời thêm tính năng sửa đổi tiêu chí nhắm mục tiêu ở cấp nhà quảng cáo cho 3 loại tiêu chí nhắm mục tiêu: kênh, loại trừ nhãn nội dung kỹ thuật số và loại trừ danh mục nhạy cảm.

Tính năng mới

• Các dịch vụ sau đây đã được thêm:

  Dịch vụ	(Các) phương thức
  advertisers.channels.sites	bulkEdit tạo xoá danh sách
  advertisers.locationLists.assignedLocations	bulkEdit tạo xoá danh sách
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit tạo xoá danh sách
  advertisers.targetingTypes.assignedTargetingOptions	tạo xoá get danh sách
  inventorySourceGroups.assignedInventorySources	bulkEdit tạo xoá danh sách
  partners.channels.sites	bulkEdit tạo xoá danh sách

• Các phương thức sau đã được thêm:

  Dịch vụ	(Các) phương thức
  nhà quảng cáo	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	bản vá
  advertisers.locationLists	tạo bản vá
  advertisers.negativeKeywordLists	tạo xoá bản vá
  inventorySourceGroups	tạo xoá bản vá
  partners.channels	bản vá

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  nhà quảng cáo	servingConfig
  mẫu quảng cáo	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

Ngày 27 tháng 4 năm 2020

Ra mắt một bộ tính năng lớn, mở rộng phạm vi của API ngoài SDF. Thêm tính năng quản lý tài nguyên cốt lõi cho phép bạn tạo, truy xuất, cập nhật và xoá các thực thể như nhà quảng cáo, chiến dịch, đơn đặt hàng quảng cáo, mục hàng và mẫu quảng cáo. Các tính năng mới cũng cho phép chỉnh sửa tiêu chí nhắm mục tiêu ở cấp mục hàng.

Tính năng mới

Các dịch vụ sau đây đã được thêm:

Dịch vụ	(Các) phương thức
nhà quảng cáo	tạo xoá get danh sách bản vá
advertisers.assets	tải lên
advertisers.campaigns	tạo xoá get danh sách bản vá
advertisers.channels	get danh sách
advertisers.creatives	tạo xoá get danh sách bản vá
advertisers.insertionOrders	tạo xoá get danh sách bản vá
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions tạo xoá get danh sách bản vá
advertisers.lineItems.targetingTypes.assignedTargetingOptions	tạo xoá get danh sách
advertisers.locationLists	get danh sách
advertisers.negativeKeywordLists	get danh sách
combinedAudiences	get danh sách
customLists	get danh sách
firstAndThirdPartyAudiences	get danh sách
floodlightGroups	get bản vá
googleAudiences	get danh sách
inventorySourceGroups	get danh sách
inventorySources	get danh sách
partners.channels	get danh sách
partners.channels	get danh sách

Ngày 9 tháng 3 năm 2020

Ra mắt API Display & Video 360 phiên bản 1. Đây là phiên bản ban đầu của API.

Vấn đề đã biết

Không có.