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: phiên bản 3

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 đã được thêm:

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

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

  Liệt kê	(Các) giá trị
  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

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

  Liệt kê	(Các) giá trị
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	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.

Hỗ trợ thêm tính năng nhắm mục tiêu các giao dịch mới.

v3

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

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

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

  Liệt kê	(Các) giá trị
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

v2

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

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

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

  Liệt kê	(Các) giá trị
  Exchange	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 của Google TV trong tiêu chí nhắm mục tiêu hay không.

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

v3

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

  Dịch vụ	Phương thức
  floodlightGroups.floodlightActivities	nhận list

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

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

v2

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

  Dịch vụ	Phương thức
  floodlightGroups.floodlightActivities	nhận list

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

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

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

Tính năng mới

Hỗ trợ thêm việc chuyển sự đồng ý của người dùng cuối khi tải các thành viên thuộc đối tượng So khớp 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 đã được thêm:

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

v2

• Các trường sau đã đượ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

Đưa phiên bản 3 ra khỏi giai đoạn thử nghiệm công khai và chuyển sang giai đoạn phát hành rộng rãi.

Đổ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.

Hỗ trợ thêm Tệp dữ liệu có cấu trúc phiên bản 7 bằng việc bổ sung giá trị enum SDF_VERSION_7 trong phiên bản 2 và phiên bản 3.

v3

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

  Liệt kê	(Các) giá trị
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

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

  Liệt kê	(Các) giá trị
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

v2

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

  Liệt kê	(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 ở phiên bản beta công khai, bao gồm các thay đổi sau:

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

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à v3.

v3

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

  Dịch vụ	Phương thức
  advertisers.adGroupAds	nhận list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions nhận list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	nhận list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	tạo nhận list

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

  Dịch vụ	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	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ợ cập nhật các 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 các 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) thông số
  inventorySources.get	advertiserId

• Các trường sau đây là trường 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 đã 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 đã được thêm:

  Liệt kê	(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 đây đã bị xoá:

  Liệt kê	(Các) giá trị
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v2

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

  Liệt kê	(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

Thêm khả năng hỗ trợ cho hai giao dịch và hai loại chiến lược đặt giá thầu mới trên YouTube và Đối tác.

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

v2

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

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

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

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

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

  Liệt kê	(Các) giá trị
  Exchange	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) v6 trong phiên bản 1 và 2.

v2

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

  Liệt kê	(Các) giá trị
  SdfVersion	SDF_VERSION_6

v1

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

  Liệt kê	(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 mục hàng đó 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.

v2

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

  Liệt kê	(Các) giá trị
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

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

  Liệt kê	(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 các tài nguyên YouTubeAdGroup và YouTubeAdGroupAd, cũng như nhắm mục tiêu theo 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 các tài nguyên của YouTube và Partners để biết thêm thông tin.

Hỗ trợ thêm 4 giao dịch trao đổi trong phiên bản 1 và phiên bản 2.

v2

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

  Dịch vụ	Phương thức
  advertisers.youtubeAdGroupAds	nhận list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions nhận list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	nhận list

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

  Dịch vụ	Phương thức
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

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

  Liệt kê	(Các) giá trị
  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

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

  Liệt kê	(Các) giá trị
  Exchange	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 ra khỏi giai đoạn thử nghiệm công khai và chuyển sang giai đoạn phát hành rộng rãi.

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 kiểu nhắm mục tiêu được chỉ định thông qua enum. Giá trị bí danh là giá trị enum liên quan dưới dạng một chuỗi.

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

Hỗ trợ thêm tính năng truy xuất các mục hàng trực tiếp qua YouTube và Đối tác, được xác định bằng ba 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 v1 và v2. Kích thước trang mặc định không thay đổi.

v2

• Các trường sau đã đượ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 đã được thêm:

  Liệt kê	(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

• Đã tăng kích thước trang tối đa cho các phương thức danh sách sau:

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

• Đã tăng kích thước trang tối đa cho các phương thức danh sách sau:

  Phương thức	Kích thước tối đa mới của trang
  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 đã chỉ định của các kiểu nhắm mục tiêu được chỉ định bằng cách sử dụng giá trị enum trong phiên bản 2 bằng cách sử dụng assignedTargetingOptionId mà thay vào đó, người dùng 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 đã 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 mục hàng bulkUpdate sử dụng không đúng cách tham số yêu cầu advertisersId, trả về một lỗi. Trong lầ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 khả năng sao chép một mục hàng hiện có trong InsertionOrder mẹ.

Ra mắt tính năng hỗ trợ ghi một phần tiêu chí nhắm mục tiêu theo đơn đặt hàng quảng cáo cho một tập hợp con các loại tiêu chí nhắm mục tiêu, đồng thời bổ sung phương thức create và delete vào dịch vụ advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

Tính năng mới

v2

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

  Dịch vụ	Phương thức
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	tạo xóa
  advertisers.lineItems	trùng lặp

v1

Chưa thêm tính năng mới nào 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 ở phiên bản beta công khai, bao gồm những thay đổi sau:

• Khả năng truy xuất mục hàng YouTube & Đối tác và chế độ cài đặt nhắm mục tiêu của các mục hàng đó bằng cách sử dụng các phương thức get và list trong dịch vụ advertisers.lineItems và advertisers.lineItems.targetingTypes.assignedTargetingOptions .
• Hai phương pháp 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 đã chỉ định trên nhiều mục hàng bằng một yêu cầu duy nhất.
• Mộ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 duy nhất.
• Logic nhắm mục tiêu mới đòi hỏi phải chỉ định và truy xuất tài nguyên AssignedTargetingOption của tập hợp con các loại nhắm mục tiêu bằng cách sử dụng các giá trị enum thay vì mã tuỳ chọn nhắm mục tiêu được truy xuất qua dịch vụ targetingTypes.targetingOptions.

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 giao dịch trao đổi mới trong phiên bản 1.

Tính năng mới

v2

Dưới đâ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ụ	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ụ	Phương thức
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• Các phương thức sau đã đượ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 thuộc các loại 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 thuộc các loại 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	Exchange
  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 là trường 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 [giới_tính]
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	khả năng xem

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

  Liệt kê	(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
  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

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

  Liệt kê	(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 đã được thêm vào phiên bản 1:

  Liệt kê	(Các) giá trị
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

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

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

Ra mắt 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 mỗi 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 bổ sung giá trị enum SdfVersion.

Tính năng mới

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

  Dịch vụ	Phương thức
  guaranteedOrders	tạo editGuaranteedOrderReadAccessors nhận list bản vá
  inventorySources	tạo 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 đã được thêm:

  Liệt kê	(Các) giá trị
  SdfVersion	SDF_VERSION_5_5

• Hiện tại, bạn có thể lọc các phương thức danh sách sau 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

Hỗ trợ thêm tính năng truy xuất và thiết lập tiêu chí nhắm mục tiêu về thời lượng nội dung, loại luồng và thể loại.

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

Ra mắt trường raiseBidForDeals cho đối tượng MaximizeSpendBidStrategy, cho phép người dùng thiết lập 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 đã được thêm:

  Liệt kê	(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

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

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

Thêm khả năng truy xuất và thiết lập xem mục hàng có tự động nhắm mục tiêu đến các nền tả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, hạn mức mặc định đã được tăng gấp đôi.

Tính năng mới

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

  Dịch vụ	Phương thức
  firstAndThirdPartyAudiences	tạo 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

Hỗ trợ thêm tính năng nhắm mục tiêu loại nội dung âm thanh trong loại 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 đã được thêm:

  Liệt kê	(Các) giá trị
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

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

Thêm tuỳ chọn hỗ trợ đầy đủ để quản lý các thuật toán đặt giá thầu tuỳ chỉnh và tập lệnh của các thuật toán đó. Trong đó có:

• Các hàm tạo giá trị 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 quá trình truy xuất một vị trí tài nguyên có sẵn và sau đó tải tệp lên lên vị trí đó.
• Một dịch vụ customBiddingAlgorithms.scripts mới để truy xuất và tạo customBiddingScripts.

Trang Triển khai tính năng đặt giá thầu tuỳ chỉnh mới đã được thêm vào hướng dẫn Quản lý mục hàng của chúng tôi, 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 bổ sung giá trị enum SdfVersion.

Tính năng mới

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

  Dịch vụ	Phương thức
  customBiddingAlgorithms	tạo bản vá uploadScript
  customBiddingAlgorithms.scripts	tạo nhận list
  media	tải lên

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

  Liệt kê	(Các) giá trị
  SdfVersion	SDF_VERSION_5_4

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

Hỗ trợ thêm tính năng nhắm mục tiêu vùng lân cận trong các loại nhắm mục tiêu TARGETING_TYPE_BUSINESS_CHAIN và TARGETING_TYPE_POI.

Thêm tính 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 có sẵn 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 các phương thức targetingTypes.targetingOptions.get hoặc targetingTypes.targetingOptions.list.

Ra mắt các trường sharedAdvertiserIds và customBiddingAlgorithmState mới cho tài nguyên Thuật toán đặt giá thầu tuỳ chỉnh, đồng thời hỗ trợ thêm cho 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 TargetOptions.search	businessChainSearchTerms poiSearchTerms

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

  Liệt kê	(Các) giá trị
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Exchange	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• Hiện tại, bạn có thể lọc các phương thức danh sách sau 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

Hỗ trợ thêm tính năng 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 nhắm mục tiêu TARGETING_TYPE_OMID.

Tăng số lượng tối đa các tuỳ 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 pháp danh sách tuỳ 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 được chỉ định 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 đã được thêm:

  Liệt kê	(Các) giá trị
  TargetingType	TARGETING_TYPE_OMID

• Đã tăng kích thước trang tối đa cho các phương thức danh sách sau:

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

Đã ra mắt dịch vụ advertisers.invoices, cho phép người dùng:

• truy xuất hoá đơn đã phát hành cho 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 phân khúc ngân sách của đơn đặt hàng quảng cáo với một ngân sách chiến dịch, điều này giới hạn tổng ngân sách của các phân khúc được liên kết với tổng số tiền ngân sách của chiến dịch.

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

Ra mắt 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ợ 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 vào:

  Dịch vụ	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 đã được thêm:

  Liệt kê	(Các) giá trị
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Trao đổi	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	Kỹ thuật	(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 trả về số lượng mục hà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 của họ.

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

• Hiện tại, bạn có thể lọc các phương thức danh sách sau 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 phương thức mới vào dịch vụ mục hàng để tạo 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ư các 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 gốc.

Cho phép truy xuất tiêu chí nhắm mục tiêu theo chiến dịch thông qua dịch vụ nhắm mục tiêu chiến dịch mới và phương pháp xác định danh sách hàng loạt bổ sung.

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

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

• Việc 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 kênh hoặc danh sách từ khoá phủ định.
• Loại bỏ yêu cầu không đưa mục hiện tại nào vào các trường createdSites hoặc createdNegativeKeywords của yêu cầu chỉnh sửa hàng loạt.
• Sự gia tăng số lượng mục tối đa có thể được trả về trên một trang của danh sách trang web hoặc phản hồi liệt kê từ khoá phủ định.

Tính năng mới

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

  Dịch vụ	Phương thức
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	nhận 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

• Đã tăng kích thước trang tối đa cho các phương thức danh sách sau:

  Phương thức	Kích thước tối đa cũ của trang	Kích thước tối đa mới của trang
  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ể chỉ định các giá trị enum sau cho các tài nguyên mới hoặc tài nguyên hiện có nữa:

  Liệt kê	(Các) giá trị
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

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

Giới thiệu dịch vụ nhắm mục tiêu theo đơn đặt hàng quảng cáo mới và phương thức thêm danh sách hàng loạt cho phép truy xuất tiêu chí nhắm mục tiêu đã chỉ định cho các đơn đặt hàng quảng cáo. 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 dạng â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 để sử dụng theo thứ tự chèn và tài nguyên chiến dịch.

Tính năng mới

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

  Dịch vụ	Phương thức
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	tải 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 đã được thêm:

  Liệt kê	(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 TV và mục hàng trực tiếp thông qua việc giới thiệu trường InsertOrderType mới và giá trị enum LineItemType mới. Hỗ trợ thêm các mục hàng trong ứng dụng dành cho thiết bị di động thông qua trường mục hàng mobileApp. Mở rộng tính năng hỗ trợ Exchange, đối tượng của google 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 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 đã được thêm:

  Liệt kê	(Các) giá trị
  Trao đổi	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 có thể sắp xếp và lọc các phương thức danh sách sau đây 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 tính năng tìm kiếm các lựa chọn nhắm mục tiêu theo 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 địa lý không dùng nữa.

Tính năng mới

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

  Dịch vụ	Phương thức
  targetingTypes.targetingOptions	tìm kiếm

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

  Liệt kê	(Các) giá trị
  Trao đổi	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• Hiện có thể sắp xếp và lọc các phương thức danh sách sau đây 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 điều kiện kích hoạt thủ công để kích hoạt mức chi tiêu của mục hàng được liên kết. Giới thiệu các tuỳ chọn mở rộng tiêu chí nhắm mục tiêu mà khi được đặt, bạn có thể mở rộng phạm vi nhắm mục tiêu của mục hàng để bao gồm những người dùng tương tự như 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 các đối tượng DoubleVerify và Integral Ad Science 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

• Chúng tôi đã thêm các dịch vụ sau:

  Dịch vụ	Phương thức
  advertisers.manualTriggers	kích hoạt tạo huỷ kích hoạt tải 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 đã được thêm:

  Liệt kê	(Các) giá trị
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• Hiện có thể lọc các phương thức danh sách sau đây 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

Đưa ra các thông báo cảnh báo có thể truy xuất được cho tài nguyên mục hàng và loại mục tiêu hiệu suất về tỷ lệ nhấp (CTR). Thêm warningMessages làm trường có thể lọc khi liệt kê các mục hàng.

Ngoài các tính năng mới, hạn mức mới cũng đã có hiệu lực và hiện đã có 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 đã được thêm:

  Liệt kê	(Các) giá trị
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• Hiện có thể lọc các phương thức danh sách sau đây 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
  Nhà quảng cáo.Cơ quan phản hồi kiểm tra	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• Hiện có thể lọc các phương thức danh sách sau đây 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 dịch vụ mới để quản lý người dùng, đối tác và dịch vụ nhắm mục tiêu theo đối tác. Giới thiệu các công cụ giúp người dùng chủ động tránh đạt đến giới hạn về pháp nhân tài khoản. Hỗ trợ thêm 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 mục hàng và đơn đặt hàng quảng cáo.

Tính năng mới

• Chúng tôi đã thêm các dịch vụ sau:

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

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

  Dịch vụ	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 đã được thêm:

  Liệt kê	(Các) giá trị
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• Hiện có thể sắp xếp và lọc các phương thức danh sách sau đây theo các trường sau:

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

• Các phạm vi sau đã được thêm vào để sử dụng cho các dịch vụ sau:

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

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

Phát hành 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 trao đổi bổ sung.

Tính năng mới

• Chúng tôi đã thêm các dịch vụ sau:

  Dịch vụ	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 mô tả displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

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

  Liệt kê	(Các) giá trị
  Trao đổi	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• Hiện có thể lọc các phương thức danh sách sau đây 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

Giới thiệu khả năng tạo, vá và điền sẵn một nhóm nhỏ thực thể có thể nhắm mục tiêu, cũng như thêm khả 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

• Chúng tôi đã thêm các dịch vụ sau:

  Dịch vụ	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á tải 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 vào:

  Dịch vụ	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 ra 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

Chúng tôi đã thêm các dịch vụ sau:

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

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

Phát hành API Display & Video 360 phiên bản 1. Đây là phiên bản đầu tiên của API.

Vấn đề đã biết

Không nội dung nào.