Các tính năng đã lưu trữ bị ngừng sử dụng

Bảng này liệt kê những tính năng đã thông báo ngừng hoạt động và ảnh hưởng đến các phiên bản Display & Video 360 API hoặc Tệp dữ liệu có cấu trúc đã ngừng hoạt động. Thông báo này cung cấp ngày có hiệu lực ban đầu và nội dung mô tả về việc ngừng sử dụng, kèm theo các hành động được đề xuất và đường liên kết đến tài liệu có liên quan:

Tính năng Ngày có hiệu lực ban đầu Mô tả
Các hạn chế đối với mục hàng trên YouTube Reach trong SDF Ngày 24 tháng 3 năm 2025

Kể từ ngày 24 tháng 3 năm 2025, Tệp dữ liệu có cấu trúc sẽ yêu cầu bạn sử dụng các định dạng quảng cáo mở rộng hơn khi tạo hoặc cập nhật mục hàng. Điều này có nghĩa là:

  • SDF v6v7 không còn hỗ trợ việc tạo các mục nhập tệp Mục hàng mới có giá trị Subtype là "Phạm vi tiếp cận".
  • Các mục mới trong tệp Mục hàng SDF có giá trị Subtype "Phạm vi tiếp cận" phải sử dụng giá trị "Thích ứng" trong cột TrueView Video Ad Formats. Những mục nhập hiện có có giá trị Subtype là "Phạm vi tiếp cận" không thể cập nhật giá trị cột TrueView Video Ad Formats.
  • Các mục mới trong tệp Mục hàng SDF có giá trị Subtype "Phạm vi tiếp cận" yêu cầu phải điền sẵn cột TrueView Video Ad Inventory Control.
Lỗi không khớp giữa đối tác/nhà quảng cáo sdfdownloadtasks.create mới Ngày 6 tháng 3 năm 2025

Kể từ ngày 6 tháng 3 năm 2025, các yêu cầu sdfdownloadtasks.create sử dụng bộ lọc thực thể mẹ để lọc theo những nhà quảng cáo không phải là phần tử con của tập hợp partnerId sẽ bắt đầu trả về lỗi 400.

Cập nhật kích thước trang mặc định firstAndThirdPartyAudiences.list Ngày 6 tháng 3 năm 2025

Vào ngày 6 tháng 3 năm 2025, kích thước trang mặc định cho các yêu cầu firstAndThirdPartyAudiences.list sẽ được cập nhật từ 100 lên 5.000.

Để tránh bị gián đoạn dịch vụ, hãy cập nhật quy trình tích hợp để đặt tham số truy vấn pageSize của các yêu cầu firstAndThirdPartyAudiences.list thành kích thước trang mà bạn muốn.

Tối ưu hoá tiêu chí nhắm mục tiêu cho các mục hàng sử dụng chiến lược đặt giá thầu cố định Ngày 6 tháng 3 năm 2025

Ngày 6 tháng 3 năm 2025:

  • Các yêu cầu tạo hoặc cập nhật tài nguyên LineItem để đặt trường BiddingStrategy fixedBid và trường TargetingExpansionConfig enableOptimizedTargeting thành true sẽ trả về lỗi 400.
  • Các mục trong tệp dữ liệu có cấu trúc Mục hàng có giá trị cột "Loại chiến lược giá thầu" là "Cố định" và giá trị cột "Nhắm mục tiêu tối ưu hoá" là "True" sẽ không tạo hoặc cập nhật được khi tải tệp lên.
  • Các mục hàng hiện có sử dụng chiến lược đặt giá thầu cố định sẽ được cập nhật để tắt tính năng tối ưu hoá tiêu chí nhắm mục tiêu.

Để tránh bị gián đoạn dịch vụ, hãy làm như sau:

  • Cập nhật các tài nguyên mục hàng hiện có sử dụng cả chiến lược đặt giá thầu cố định và tính năng tối ưu hoá tiêu chí nhắm mục tiêu.
  • Xác minh rằng chế độ tích hợp của bạn không đặt chiến lược đặt giá thầu cố định và tiêu chí nhắm mục tiêu được tối ưu hoá khi tạo hoặc cập nhật tài nguyên mục hàng bằng Display & Video 360 API hoặc Tệp dữ liệu có cấu trúc.
Khoảng thời gian giới hạn tần suất trên 30 ngày Ngày 28 tháng 2 năm 2025

Vào ngày 28 tháng 2 năm 2025:

  • Các yêu cầu tạo hoặc cập nhật tài nguyên LineItem, InsertionOrderCampaign để sử dụng đối tượng FrequencyCap có trường timeUnit được đặt thành TIME_UNIT_LIFETIME hoặc trường timeUnit được đặt thành TIME_UNIT_MONTH và trường timeUnitCount được đặt thành 2 sẽ trả về lỗi 400.
  • Các mục trong tệp dữ liệu có cấu trúc Mục hàng, Đơn đặt hàng quảng cáoChiến dịch có giá trị cột "Khoảng thời gian xuất hiện" là "Trọn đời" hoặc giá trị cột "Khoảng thời gian xuất hiện" là "Tháng" và giá trị cột "Số lần xuất hiện" là "2" sẽ không tạo hoặc cập nhật được khi tải tệp lên.
  • Các chiến dịch, đơn đặt hàng quảng cáo và mục hàng hiện có sẽ được cập nhật để sử dụng khoảng thời gian giới hạn tần suất là 30 ngày trở xuống.

Để tránh bị gián đoạn dịch vụ, hãy làm như sau:

  • Cập nhật các tài nguyên chiến dịch, đơn đặt hàng quảng cáo và mục hàng hiện có sử dụng khoảng thời gian giới hạn tần suất trên 30 ngày thành 30 ngày hoặc ít hơn.
  • Xác minh rằng chế độ tích hợp của bạn không đặt khoảng thời gian giới hạn tần suất trên 30 ngày khi tạo hoặc cập nhật tài nguyên chiến dịch, đơn đặt hàng quảng cáo hoặc mục hàng bằng Display & Video 360 API hoặc Tệp dữ liệu có cấu trúc.
Ngày bay sớm nhất có thể Pacing cho đơn đặt hàng quảng cáo Ngày 5 tháng 11 năm 2024

Kể từ ngày 5 tháng 11 năm 2024, PACING_TYPE_ASAP sẽ không còn tương thích với PACING_PERIOD_FLIGHT khi bạn đặt trường đơn đặt hàng quảng cáo pacing. pacingType cho tất cả các đơn đặt hàng hiện có có cấu hình này sẽ được cập nhật thành PACING_TYPE_AHEAD.

Để tránh bị gián đoạn dịch vụ, hãy cập nhật pacing của mọi đơn đặt hàng hiện có bằng cách sử dụng PACING_TYPE_ASAPPACING_PERIOD_FLIGHT.

Tính năng tối ưu hoá tiêu chí nhắm mục tiêu theo mục hàng cho một nhóm nhỏ chiến lược giá thầu Ngày 30 tháng 9 năm 2024

Kể từ ngày 30 tháng 9 năm 2024, các tài nguyên LineItem sử dụng một nhóm nhỏ chiến lược giá thầu sẽ không còn tương thích với tính năng nhắm mục tiêu được tối ưu hoá nữa. Với thay đổi này, các tài nguyên LineItemtargetingExpansion.enableOptimizedTargeting được đặt thành TruebidStrategy.maximizeSpendAutoBid.performanceGoalType được đặt thành BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN hoặc BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED hoặc bidStrategy.performanceGoalAutoBid.performanceGoalType được đặt thành BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM sẽ được cập nhật để đặt targetingExpansion.enableOptimizedTargeting thành False.

Để tránh bị gián đoạn dịch vụ, hãy cập nhật và xác minh rằng các mục hàng sử dụng những chiến lược giá thầu này không bật tính năng tối ưu hoá tiêu chí nhắm mục tiêu.

Đối tượng bên thứ nhất và bên thứ ba của Oracle Ngày 30 tháng 9 năm 2024

Từ ngày 30 tháng 9 năm 2024, FirstAndThirdPartyAudience các nguồn tài nguyên từ Oracle sẽ ngừng hoạt động. Sau khi ngừng hoạt động, những đối tượng này sẽ bị xoá khỏi mọi tiêu chí nhắm mục tiêu theo tài nguyên và đối tượng kết hợp hiện có. Nếu một mục hàng chỉ nhắm đến đối tượng không còn được hỗ trợ hoặc nhắm đến tiêu cực bất kỳ đối tượng nào không còn được hỗ trợ, thì bản cập nhật này sẽ tự động tạm dừng mục hàng đó.

Để tránh gián đoạn dịch vụ, hãy xác định và xoá mọi đối tượng Oracle khỏi tiêu chí nhắm mục tiêu theo đối tượng của mục hàng hiện có và đối tượng kết hợp trước ngày ngừng hoạt động.

Nhắm mục tiêu theo nội dung cho các mục hàng của YouTube và đối tác Ngày 30 tháng 9 năm 2024

Vào ngày 30 tháng 9 năm 2024, các giá trị sau đây cho các loại tiêu chí nhắm mục tiêu được xác định sẽ ngừng hoạt động đối với các mục hàng YouTube và đối tác:

Các tiêu chí nhắm mục tiêu không còn được hỗ trợ sẽ tự động bị xoá khỏi tiêu chí nhắm mục tiêu của mục hàng hiện có. Bạn vẫn có thể sử dụng các giá trị này trong tính năng nhắm mục tiêu ở cấp nhà quảng cáo.

Để tránh gián đoạn dịch vụ, hãy xoá tiêu chí nhắm mục tiêu này khỏi mọi mục hàng hiện có trên YouTube và Mạng đối tác trước ngày ngừng hoạt động.

Trường publisherReviewStatuses trong tài nguyên mẫu quảng cáo Ngày 26 tháng 6 năm 2024

Kể từ ngày 26 tháng 6 năm 2024, trường publisherReviewStatuses sẽ ngừng hoạt động và sẽ trống khi truy xuất tài nguyên Creative.

Mua dựa trên kết quả Ngày 1 tháng 8 năm 2023

Vào ngày 1 tháng 8 năm 2023, những đơn đặt hàng sử dụng mô hình mua dựa trên kết quả (được xác định bằng giá trị trường billableOutcomeBILLABLE_OUTCOME_PAY_PER_CLICK hoặc BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION) và các mục hàng con của những đơn đặt hàng đó sẽ được lưu trữ.

Thay đổi này sẽ ảnh hưởng đến các yêu cầu sau:

Có thể lọc yêu cầu advertisers.lineItems.list theo 4 trường bổ sung Ngày 21 tháng 6 năm 2023

Kể từ ngày 21 tháng 6 năm 2023, advertisers.lineItems.list sẽ không còn hỗ trợ lọc theo các trường sau:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

Xoá tất cả logic lọc bằng 4 trường này trước ngày 21 tháng 6 năm 2023 để tránh bị gián đoạn dịch vụ.

Có thể lọc hoặc sắp xếp các yêu cầu trong danh sách theo các trường budget.budget_segments.date_range.end_dateflight.dateRange.endDate

Ngày có hiệu lực ban đầu đã được cập nhật

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

Kể từ ngày 21 tháng 6 năm 2023, budget.budget_segments.date_range.end_dateflight.dateRange.endDate sẽ không còn là các trường được chấp nhận trong tham số truy vấn advertisers.insertionOrders.listadvertisers.lineItems.list filterorderBy tương ứng. Sau ngày này, các yêu cầu sử dụng những trường này trong tham số truy vấn filterorderBy sẽ trả về lỗi.

Xoá tất cả logic lọc và sắp xếp bằng cách sử dụng 2 trường này trước ngày 21 tháng 6 năm 2023 để tránh bị gián đoạn dịch vụ.

Cách sử dụng toán tử OR giữa các quy tắc hạn chế của nhiều trường trong bộ lọc LIST

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

Kể từ ngày 21 tháng 6 năm 2023, các thông số yêu cầu LIST filter sẽ không còn cho phép sử dụng toán tử logic OR giữa các quy định hạn chế của các trường khác nhau.

Ví dụ: thay vào đó, bạn phải truy xuất các tài nguyên được xác định bằng chuỗi bộ lọc lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" bằng cách sử dụng 2 yêu cầu LIST với các chuỗi bộ lọc sau:

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

Hãy tham khảo hướng dẫn cách lọc các yêu cầu LIST của chúng tôi để biết thêm thông tin về các quy định hạn chế đối với toán tử logic.

Xem xét các tham số truy vấn filter của tất cả các lệnh gọi LIST hiện có và xác minh rằng các tham số đó đang sử dụng đúng toán tử logic OR trước ngày 21 tháng 6 năm 2023 để tránh bị gián đoạn dịch vụ.

Hạn mức API hiện tại Ngày 30 tháng 5 năm 2023

Vào ngày 30 tháng 5 năm 2023, các hạn mức sử dụng hiện tại sẽ được thay thế bằng một cấu trúc hạn mức kết hợp, có những đặc điểm sau:

  1. Loại bỏ hạn mức số yêu cầu mỗi ngày trên mỗi dự án.
  2. Thiết lập hạn mức số yêu cầu mỗi phút trên mỗi nhà quảng cáo trên mỗi dự án cho các phương thức đủ điều kiện.

Những giới hạn mới này sẽ giúp bạn linh hoạt hơn khi sử dụng API và cho phép tải song song các yêu cầu trên nhiều nhà quảng cáo. Thông tin chi tiết về thay đổi này có trong tài liệu về hạn mức hiện tại.

Các loại FirstAndThirdPartyAudience dựa trên hoạt động và giới hạn tần suất Ngày 20 tháng 5 năm 2023

Dòng thời gian:

  • Ngày 20 tháng 5 năm 2023: Bạn sẽ không thể chỉ định tài nguyên FirstAndThirdPartyAudienceAudienceTypeACTIVITY_BASED hoặc FREQUENCY_CAP cho tiêu chí nhắm đến đối tượng của mục hàng hoặc đơn đặt hàng quảng cáo. Các yêu cầu chỉ định những đối tượng này cho tiêu chí nhắm mục tiêu theo đối tượng của một mục hàng sẽ trả về lỗi. Điều này bao gồm các yêu cầu advertisers.lineItems.duplicateadvertisers.lineItems.generateDefault, nếu mục hàng được tạo sẽ bao gồm các đối tượng không dùng nữa trong tiêu chí nhắm mục tiêu theo đối tượng.
  • Ngày 8 tháng 6 năm 2023: Các đối tượng chịu ảnh hưởng sẽ bị xoá khỏi tất cả tiêu chí nhắm mục tiêu của mục hàng và đơn đặt hàng quảng cáo, cũng như khỏi tất cả đối tượng kết hợp. Nếu một mục hàng không thể phân phát quảng cáo khi bạn xoá các đối tượng này, thì mục hàng đó sẽ bị tạm dừng. Kể từ ngày này, bạn cũng sẽ không thể truy xuất các đối tượng này bằng dịch vụ firstAndThirdPartyAudiences nữa.

Việc cần làm được đề xuất:

  • Bạn nên ngừng sử dụng ngay những đối tượng bị ảnh hưởng khi thực hiện các bản cập nhật sau này cho tiêu chí nhắm mục tiêu của mục hàng.
  • Xoá tất cả đối tượng chịu ảnh hưởng khỏi tiêu chí nhắm mục tiêu của mục hàng và đơn đặt hàng quảng cáo hiện có. Hãy đọc về cách cập nhật tiêu chí nhắm mục tiêu theo đối tượng trong hướng dẫn về Đối tượng mục tiêu.
Các loại Ứng dụng đã cài đặt và Thiết bị di động mới GoogleAudience Ngày 20 tháng 5 năm 2023

Dòng thời gian:

  • Ngày 20 tháng 5 năm 2023: Bạn sẽ không thể chỉ định tài nguyên GoogleAudienceGoogleAudienceTypeGOOGLE_AUDIENCE_TYPE_INSTALLED_APPS hoặc GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES cho tiêu chí nhắm đến đối tượng của mục hàng hoặc đơn đặt hàng quảng cáo. Các yêu cầu chỉ định những đối tượng này cho tiêu chí nhắm mục tiêu theo đối tượng của một mục hàng sẽ trả về lỗi. Điều này bao gồm các yêu cầu advertisers.lineItems.duplicateadvertisers.lineItems.generateDefault, nếu mục hàng được tạo sẽ bao gồm các đối tượng không dùng nữa trong tiêu chí nhắm mục tiêu theo đối tượng.
  • Ngày 8 tháng 6 năm 2023: Các đối tượng chịu ảnh hưởng sẽ bị xoá khỏi tất cả tiêu chí nhắm mục tiêu của mục hàng và đơn đặt hàng quảng cáo, cũng như khỏi tất cả đối tượng kết hợp. Nếu một mục hàng không thể phân phát quảng cáo khi bạn xoá các đối tượng này, thì mục hàng đó sẽ bị tạm dừng. Kể từ ngày này, bạn cũng sẽ không thể truy xuất các đối tượng này bằng dịch vụ googleAudiences nữa.

Việc cần làm được đề xuất:

  • Bạn nên ngừng sử dụng ngay những đối tượng bị ảnh hưởng khi thực hiện các bản cập nhật sau này cho tiêu chí nhắm mục tiêu của mục hàng.
  • Xoá tất cả đối tượng chịu ảnh hưởng khỏi tiêu chí nhắm mục tiêu của mục hàng và đơn đặt hàng quảng cáo hiện có. Hãy đọc về cách cập nhật tiêu chí nhắm mục tiêu theo đối tượng trong hướng dẫn về Đối tượng mục tiêu.
Trình kích hoạt thủ công Ngày 17 tháng 5 năm 2023

Dòng thời gian:

  • Ngày 17 tháng 5 năm 2023: Các mục hàng sử dụng điều kiện kích hoạt thủ công sẽ ngừng phân phát trong Display & Video 360. Nếu bạn kích hoạt một điều kiện kích hoạt thủ công được liên kết với một mục hàng đang hoạt động sau ngày này, thì mục hàng đó sẽ không phân phát quảng cáo.
  • Ngày 1 tháng 8 năm 2023: Dịch vụ advertisers.manualTriggers trong DV360 API phiên bản 1 và 2, giá trị enum LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER trong DV360 API phiên bản 1 và trường LineItemFlight.triggerId trong DV360 API phiên bản 1 sẽ ngừng hoạt động. Sau ngày này, các yêu cầu gửi đến những dịch vụ hoặc trường này sẽ trả về lỗi.

Hành động được đề xuất:

  • Ngừng sử dụng ngay các điều kiện kích hoạt thủ công để bắt đầu và dừng phân phát mục hàng.
  • Dừng gửi yêu cầu đến dịch vụ advertisers.manualTriggers.
  • Cập nhật các trường flight.flightDateTypeflight.triggerId cho tất cả các mục hàng bằng cách sử dụng trình kích hoạt thủ công.
Mở rộng phạm vi nhắm mục tiêu Ngày 25 tháng 3 năm 2023 Thay thế tính năng mở rộng tiêu chí nhắm mục tiêu bằng tính năng tối ưu hoá tiêu chí nhắm mục tiêu, được triển khai dần từ ngày 25 tháng 3 năm 2023 đến đầu tháng 5 năm 2023. Những thay đổi có liên quan đối với API Display & Video 360 và hành vi của Tệp dữ liệu có cấu trúc, cũng như các hành động được đề xuất đã được thông báo trong một bài đăng trên blog.