Ghi chú phát hành

Trang này cung cấp các ghi chú phát hành cho chiến dịch Hiển thị và API Video 360.

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

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 xuống tệp dữ liệu có cấu trúc của Mục hàng và Nhóm quảng cáo trong Đị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 đã được thêm:

  Liệt kê	(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ùy chọn hỗ trợ quản lý việc nhắm mục tiêu theo từ khóa được chỉ định ở cấp nhà quảng cáo.

Đã thêm trường optimizationObjective mới vào đơn đặt hàng quảng cáo nguồn. optimizationObjective chỉ dành cho khách hàng 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 pháp sau hiện hỗ trợ các loại 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 pháp sau hiện hỗ trợ các loại 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 đã được thêm:

  Liệt kê	(Các) Giá trị
  SdfVersion	SDF_VERSION_7_1

phiên bản 2

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

  Liệt kê	(Các) Giá trị
  SdfVersion	SDF_VERSION_7_1

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

Tính năng mới

Hỗ trợ thêm các loại KPI, sàn giao dịch 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 đã được thêm:

  Liệt kê	(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 đã được thêm:

  Liệt kê	(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 khả năng xóa rõ ràng các 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 sàn giao dịch 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 đã được thêm:

  Liệt kê	(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 đã được thêm:

  Liệt kê	(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 hoạt động Floodlight thông qua tính năng Dịch vụ floodlightGroups.floodlightActivities.

Đã thêm một trường mới cho biết YouTube & Mục hàng của Đối tác bao gồm khoảng không quảng cáo Google TV trong tiêu chí nhắm mục tiêu.

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

v3

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

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

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

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

phiên bản 2

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

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

• Các trường sau đây đã đượ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 tính năng chuyển sự đồng ý của người dùng cuối khi tải danh sách So khớp khách hàng lên các thành viên là khán giả trong tất cả các phiên bản phát trực tiếp.

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 ra khỏi giai đoạn beta công khai và phát hành rộng rãi.

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

Tính năng hỗ trợ bổ sung cho Tệp dữ liệu có cấu trúc phiên bản 7 Giá trị enum SDF_VERSION_7 trong phiên bản 2 và v3.

v3

• Các giá trị enum sau đã 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

phiên bản 2

• 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 ở 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í lân cận, cho phép sử dụng Dịch vụ advertisers.locationLists.assignedLocations cần tạo và xoá các vị trí được chỉ định cho TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
• Một trường boolean enableOptimizedTargeting mới thay thế trường targetingExpansionLevel trong TargetingExpansionConfig.
• Yêu cầu đối với trường billingConfig trong Advertiser, phải được đưa vào khi tạo advertisers.create yêu cầu và một yêu cầu mới Trường billingConfig trong Partner nguồn.
• Các tài nguyên AdGroup và AdGroupAd mới thay thế các 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, 1 giá trị mới YoutubeAndPartnersBiddingStrategyType và 1 yêu cầu mới PartnerCostType trong phiên bản 2 và phiên bản 3.

v3

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

  Dịch vụ	(Các) 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ụ	(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	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	Giờ đây, bạn có thể chỉnh sửa hàng loạt tài nguyên AssignedLocation trong các 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 đã được thêm:

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

• Sau đây là các 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 đây đã đượ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 đã đượ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 đã bị xoá:

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

phiên bản 2

• 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

Hỗ trợ thêm hai giao dịch và hai giao dịch YouTube và Đối tác chiến lược đặt giá thầu.

Đã thêm trường effectiveContentCategory mới vào YouTube và Mục hàng Đối tác 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 nhà quảng cáo và cấp mục hà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 đã được thêm:

  Liệt kê	(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 một 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à phiên bản 2.

phiên bản 2

• 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. Giá trị này sẽ là gán cho trường warningMessages của mục hàng nếu trườ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.

phiên bản 2

• 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 YouTubeAdGroup và YouTubeAdGroupAd, cũng như Nhóm quảng cáo trên YouTube nhắm mục tiêu tài nguyên. Ngoài ra, chúng tôi cũng đã thêm các loại nhắm mục tiêu có thể truy xuất được sử dụng trên Nhóm quảng cáo YouTube cấp độ. Đọc trang hướng dẫn mới của chúng tôi về cách truy xuất YouTube và Đối tác để biết thêm thông tin.

Hỗ trợ thêm 4 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 vào:

  Dịch vụ	(Các) 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 đây đã đượ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 đã được thêm:

  Liệt kê	(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 đã được thêm:

  Liệt kê	(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 ra khỏi phiên bản thử nghiệm công khai và phát hành rộng rãi.

Thêm trường assignedTargetingOptionIdAlias mới vào AssignedTargetingOption, có thể được sử dụng 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 tùy chọn nhắm mục tiêu được chỉ định của loại nhắm mục tiêu được gán qua enum. Giá trị bí danh là giá trị enum phù hợp dưới dạng một chuỗi.

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

Đã thêm hỗ trợ để truy xuất YouTube và mục hàng trực tiếp qua đối tác, đượ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 v1 và v2. Chiến lược phát hành đĩa đơn 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 đã đượ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

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

  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 đây:

  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:

• Lựa chọn nhắm mục tiêu đã chỉ định của loại nhắm mục tiêu được chỉ định bằng cách sử dụng enum các giá trị trong phiên bản 2 không thể được xoá hoặc truy xuất bằng cách sử dụng assignedTargetingOptionId và thay vì mong đợi người dùng để sử dụng giá trị enum. Với lần cập nhật này, các tiêu chí nhắm mục tiêu được chỉ định này có thể được xóa hoặc truy xuất bằng cách sử dụng assignedTargetingOptionId hoặc giá trị enum, được xác định bởi 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. 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 khả năng sao chép mục hàng hiện có trong mục hàng mẹ InsertionOrder.

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 nhắm mục tiêu khác có thêm create và delete phương thức vào 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 vào:

  Dịch vụ	(Các) 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 ở giai đoạn thử nghiệm công khai, bao gồm các thay đổi sau:

• Khả năng truy xuất dữ liệu YouTube và Mục hàng của Đối tác và tiêu chí nhắm mục tiêu của các mục hàng đó bằng cách sử dụng phương thức get và list trong 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 được chỉ định trên nhiều mục hàng có 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 duy nhất.
• Logic nhắm mục tiêu mới yêu cầu AssignedTargetingOption của một tập hợp con các loại nhắm mục tiêu được tạo được chỉ định và truy xuất bằng cách sử dụng các giá trị enum thay vì ID tùy chọn nhắm mục tiêu truy xuất được bằng 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 mới trong phiên bản 1.

Tính năng mới

phiên bản 2

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ụ	(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 đã đượ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
  đối tác	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 các tài nguyên AssignedTargetingOption của 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	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 đây đã đượ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 đây đã 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

• Sau đây là các 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
  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 đã 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ị
  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 inventorySources phương thức ghi dịch vụ và một mới guaranteedOrders dịch vụ.

Ra mắt trường modelReadiness trong phần CustomBiddingAlgorithm. Trường này liệt kê trạng thái sẵn sàng của mô hình của thuật toán cho từng nhà quảng cáo có thể truy cập 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 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 thêm một 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ụ	(Các) 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 đây đã đượ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

• 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 tuỳ chọn hỗ trợ cho việc truy xuất và đặt tiêu chí nhắm mục tiêu trên thời lượng nội dung, loại luồng, và thể loại.

Đã thêm trường billableOutcome vào InsertionOrder .

Ra mắt trường raiseBidForDeals trong phần tử MaximizeSpendBidStrategy, cho phép người dùng đặt giá thầu á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.

Tính năng mới

• Các trường sau đây đã đượ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 chức năng tạo, cập nhật và chỉnh sửa thành viên của một số công cụ So khớp khách hàng nhất định FirstAndThirdPartyAudience. Chiến lược phát hành đĩa đơn Trang Tải đối tượng So khớp khách hàng lên trong Thông tin chi tiết về cách sử dụng các tính năng mới này trong bài viết Sử dụng Đối tượng.

Ra mắt một trường reservationType mới trong InsertionOrder và LineItem những tài nguyên giúp xác định xem một tài nguyên có phải là Đảm bảo bằng thẻ, Có lập trình hay không Được đảm bảo hoặc không được đảm bảo.

Đã thêm khả năng truy xuất và đặt xem mục hàng có tự động nhắm mục tiêu hay không trao đổi mới thông qua excludeNewExchanges mới .

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ụ	(Các) phương thức
  firstAndThirdPartyAudiences	tạo editCustomerMatchMembers bản vá

• Các trường sau đây đã đượ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 tuỳ chọn hỗ trợ cho việc nhắm mục tiêu theo loại nội dung âm thanh trong phần 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 đây đã đượ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 dịch vụ hỗ trợ đầy đủ cho việc 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 đó. Nội dung như vậy bao gồm:

• Các hàm để tạo mới và cập nhật hiện có customBiddingAlgorithms.
• Khả năng tải lên các tập lệnh thông qua quá trình truy xuất vị trí tài nguyên có sẵn rồi sau đó đang tải tệp lên vị trí đó.
• Dịch vụ customBiddingAlgorithms.scripts mới cho truy xuất và tạo 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 mô tả 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 tùy chỉnh làm chiến lược đặt giá thầu của mục hàng.

Bổ sung tính năng hỗ trợ cho phiên bản SDF mới nhất, v5.4, thông qua thêm một 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ụ	(Các) 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

Đã thêm tùy chọn hỗ trợ cho 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 khả năng tìm kiếm các nội dung sẵn có TARGETING_TYPE_BUSINESS_CHAIN và TARGETING_TYPE_POI tùy chọn nhắm mục tiêu sử dụng targetingTypes.targetingOptions.search vì không thể được truy xuất qua targetingTypes.targetingOptions.get hoặc targetingTypes.targetingOptions.list.

Ra mắt sharedAdvertiserIds mới và Các trường customBiddingAlgorithmState đến tính năng Đặt giá thầu tuỳ chỉnh Tài nguyên thuật toán và khả năng hỗ trợ bổ sung 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 đây đã được thêm:

  Tài nguyên	(Các) trường
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  Nhắm mục tiêuOptions.search nội dung yêu cầu	businessChainSearchTerms poiSearchTerms

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

  Liệt kê	(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 tuỳ chọn hỗ trợ cho Đã bật tính năng Đo lường mở nhắm mục tiêu khoảng không quảng cáo theo loại nhắm mục tiêu TARGETING_TYPE_OMID.

Đã tăng số lượng tuỳ chọn nhắm mục tiêu tối đa được chỉ định có thể được trả về trong một trang của nhiều 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 tiêu chí nhắm mục tiêu danh sách lựa chọn 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 đây đã đượ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

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

  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

Triển khai dịch vụ advertisers.invoices, dịch vụ này cho phép người dùng:

• truy xuất hoá đơn được 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 chiến dịch nguồn. Bạn có thể liên kết phân đoạn ngân sách đơ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 phân khúc đã liên kết với tổng số tiền ngân sách chiến dịch.

Đã thêm tùy chọn hỗ trợ cho nhắm mục tiêu theo vị trí nội dung gốc trong loại nhắm mục tiêu TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Giới thiệu trường prismaEnabled mới cho nhà quảng cáo tài nguyên, 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 giá trị 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ụ	(Các) phương thức
  advertisers.invoices	list lookupInvoiceCurrency

• Các trường sau đây đã đượ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 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 Kênh và Các tài nguyên Danh sách từ khoá phủ định trả về số lượng dòng bằng cách sử dụng tài nguyên để nhắm mục tiêu. Đã bật filter mới các thuộc tính cho phương thức danh sách mục hàng để cho phép người dùng chỉ truy xuất mục hàng đang sử dụng kênh hoặc từ khóa 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 đây đã đượ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 ra 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à chỉ định tiêu chí nhắm mục tiêu của đơn đặt hàng quảng cáo gốc.

Cho phép truy xuất nhắm mục tiêu 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 thức danh sách hàng loạt bổ sung.

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

Đã thực hiện nhiều thay đổi đối với advertisers.channels.sites, partners.channels.sites và advertisers.negativeKeywordLists.negativeKeywords dịch vụ đến cho phép quản lý nội dung danh sách từ khoá phủ định và kênh dễ dàng hơn. Các các thay đổi 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ó trên kênh hoặc danh sách từ khoá phủ định.
• Việc loại bỏ yêu cầu không có các mục có trong createdSites hoặc createdNegativeKeywords trường chỉnh sửa hàng loạt yêu cầu.
• Là mức tăng số lượng mục tối đa có thể được trả về trên một giá trị duy nhất của một danh sách trang web hoặc 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ụ	(Các) 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 đây đã đượ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 đây:

  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

• Không thể gán các giá trị enum sau cho các tài nguyên mới hoặc 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

Ra mắt dịch vụ nhắm mục tiêu đơn đặt hàng quảng cáo mới và phương pháp danh sách hàng loạt bổ sung cho phép truy xuất tiêu chí nhắm mục tiêu được 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ỉ đầu ra để sử dụng mẫu quảng cáo dạng âm thanh của bên thứ ba. Thêm các loại mục tiêu hiệu suất mới để sử dụng theo đơn đặt hàng quảng cáo và chiến dịch của chúng tôi.

Tính năng mới

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

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

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

Bật tính năng truy xuất và quản lý đơn đặt hàng quảng cáo trên truyền hình và giao dịch trực tiếp qua Internet thông qua việc giới thiệu trường InsertOrderType mới và giá trị enum LineItemType mới. Đã thêm tính năng hỗ trợ cho ứng dụng di động mục hàng thông qua trường mục hàng mobileApp. Mở rộng hoạt động trao đổi, đối tượng của Google và Hỗ trợ SDF thông qua các giá trị enum bổ sung. Ra mắt khả năng lọc và sắp xếp 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 đây đã đượ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

• Các phương thức danh sách sau đây hiện có thể được sắp xếp và lọc 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 Tuỳ chọn nhắm mục tiêu theo Khu vực địa lý và lọc nhiều tài nguyên liệt kê các kết quả theo thời gian cập nhật gần đây nhất. Giới thiệu một LineItemWarningMessage mới để thông báo cho người dùng về thời điểm mục hàng đang sử dụng tiêu chí nhắm mục tiêu theo địa lý không được 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ụ	(Các) 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

• Các phương thức danh sách sau đây hiện có thể được sắp xếp và lọc 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 tính 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 hàng được liên kết chi tiêu. Giới thiệu các tuỳ chọn mở rộng tiêu chí nhắm mục tiêu giúp khi đã đặt, 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 những người dùng tương tự như những người thuộc đố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 DoubleVerify và Integral Ad Science đối tượng được sử dụng trong nhắm mục tiêu xác minh qua bên thứ ba.

Tính năng mới

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

  Dịch vụ	(Các) 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 đây đã đượ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

• Các phương thức danh sách sau đây hiện có thể lọc 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 cảnh báo có thể truy xuất cho 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à 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 đây đã đượ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

• Các phương thức danh sách sau đây hiện có thể lọc 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 pháp kiểm tra nhà quảng cáo và các trường có thể lọc mới theo nhiều phương pháp danh sách.

Tính năng mới

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

  Tài nguyên	(Các) trường
  Nội dung phản hồi Nhà quảng cáo.Kiểm tra	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• Các phương thức danh sách sau đây hiện có thể lọc 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ụ quản lý người dùng, đối tác và đố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 về pháp nhân tài khoản. Hỗ trợ thêm cho mục hàng âm thanh và sử dụng thuật toán đặt giá thầu tuỳ chỉnh trong mục hàng và chiến lược giá thầu đơn đặt hàng quảng cáo.

Tính năng mới

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

  Dịch vụ	(Các) 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ụ	(Các) phương thức
  nhà quảng cáo	kiểm tra

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

• Các phương thức danh sách sau đây hiện có thể được sắp xếp và lọc 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 để 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 6 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 kênh đối tác và kênh nhà quảng cáo, các trường FirstAndThirdPartyAudience mới và các giá trị enum Exchange khác.

Tính năng mới

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

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

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

• Các phương thức danh sách sau đây hiện có thể lọc 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à đưa vào một nhóm nhỏ các thực thể có thể nhắm mục tiêu, đồng thời bổ sung 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

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

  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á 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ụ	(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 đây đã được thêm:

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

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

Phát hành một bộ tính năng lớn, mở rộng phạm vi của API ra ngoài SDF. Đã thêm quản lý tài nguyên cốt lõi để giú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 khả 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 đã được thêm vào:

Dịch vụ	(Các) 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

Đã giới thiệu chiến dịch Hiển thị và Video 360 API phiên bản 1. Đây là phiên bản ban đầu của API này.

Vấn đề đã biết

Không có.