Thông báo về việc không dùng nữa

Dòng thời gian:

• Ngày 17 tháng 5 năm 2023: Những mục hàng sử dụng trình kích hoạt thủ công sẽ ngừng phân phát trong Mạng Hiển thị và 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 API DV360 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, yêu cầu được gửi đến những dịch vụ này hoặc đến các trường này sẽ trả về lỗi.

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

• Ngay lập tức ngừng sử dụng trình kích hoạt thủ công để bắt đầu và ngừng phân phát mục hàng.
• Ngừng gửi yêu cầu đối với dịch vụ advertisers.manualTriggers.
• Cập nhật các trường flight.flightDateType và flight.triggerId cho tất cả các mục hàng bằng cách sử dụng điều kiện kích hoạt thủ công.

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 GoogleAudience có GoogleAudienceType là GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS hoặc GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES cho tiêu chí nhắm mục tiêu theo đối tượng của mục hàng hoặc đơn đặt hàng quảng cáo nữa. Yêu cầu chỉ định các đối tượng này vào tiêu chí nhắm mục tiêu theo đối tượng của mục hàng sẽ trả về lỗi. Điều này bao gồm các yêu cầu advertisers.lineItems.duplicate và advertisers.lineItems.generateDefault nếu mục hàng đã tạo có bao gồm các đối tượng không được 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 bị ả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 các đối tượng này bị xoá, 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 ngay lập tức sử dụng đối tượng bị ảnh hưởng khi cập nhật tiêu chí nhắm mục tiêu mục hàng của mình trong tương lai.
• Xoá tất cả đối tượng bị ảnh hưởng khỏi tiêu chí nhắm mục tiêu hiện tại của mục hàng và đơn đặt hàng quảng cáo. Đọc về cách cập nhật tính năng nhắm mục tiêu theo đối tượng trong hướng dẫn về Đối tượng mục tiêu của chúng tôi.

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 FirstAndThirdPartyAudience có AudienceType là ACTIVITY_BASED hoặc FREQUENCY_CAP cho tiêu chí nhắm mục tiêu theo đối tượng của mục hàng hoặc đơn đặt hàng quảng cáo nữa. Yêu cầu chỉ định các đối tượng này vào tiêu chí nhắm mục tiêu theo đối tượng của mục hàng sẽ trả về lỗi. Điều này bao gồm các yêu cầu advertisers.lineItems.duplicate và advertisers.lineItems.generateDefault nếu mục hàng đã tạo có bao gồm các đối tượng không được 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 bị ả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 các đối tượng này bị xoá, 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 ngay lập tức sử dụng đối tượng bị ảnh hưởng khi cập nhật tiêu chí nhắm mục tiêu mục hàng của mình trong tương lai.
• Xoá tất cả đối tượng bị ảnh hưởng khỏi tiêu chí nhắm mục tiêu hiện tại của mục hàng và đơn đặt hàng quảng cáo. Đọc về cách cập nhật tính năng nhắm mục tiêu theo đối tượng trong hướng dẫn về Đối tượng mục tiêu của chúng tôi.

Kể từ ngày 30 tháng 5 năm 2023, 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 với các lợi ích sau:

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

Các giới hạn mới này sẽ giúp bạn sử dụng API một cách linh hoạt hơn và thực hiện song song các yêu cầu của nhiều nhà quảng cáo. Thông tin chi tiết về thay đổi này được trình bày trong tài liệu về hạn mức hiện tại.

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

Ví dụ: Những tài nguyên được xác định bằng chuỗi bộ lọc lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" phải được truy xuất bằng 2 yêu cầu LIST với 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 yêu cầu LIST của chúng tôi để biết thêm chi tiết về các hạn chế của toán tử logic.

Xem lại tham số truy vấn filter của tất 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ụ.

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

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

Xoá tất cả bộ lọc và logic thứ tự theo 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ụ.

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

Hãy xoá tất cả logic của bộ 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ụ.

Kể từ ngày 1 tháng 8 năm 2023, các đơn đặt hàng quảng cáo sử dụng phương thức mua dựa trên kết quả, được xác định bằng giá trị trường billableOutcome là BILLABLE_OUTCOME_PAY_PER_CLICK hoặc BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, và các mục hàng con của các đơn đặt hàng này sẽ được lưu trữ.

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

• Nếu bạn cố gắng dùng advertisers.insertionOrders.create để tạo đơn đặt hàng quảng cáo bằng phương thức mua dựa trên kết quả, thì hệ thống sẽ trả về lỗi 400
• Việc cố gắng sử dụng advertisers.lineItems.create, advertisers.lineItems.duplicate hoặc advertisers.lineItems.generateDefault để tạo mục hàng theo đơn đặt hàng quảng cáo bằng cách sử dụng phương thức mua dựa trên kết quả sẽ trả về lỗi 400
• Vì tài nguyên đã lưu trữ không được đưa vào yêu cầu LIST theo mặc định, nên theo mặc định, tài nguyên bị ảnh hưởng sẽ không còn được trả về bằng phương thức advertisers.insertionOrders.list và advertisers.lineItems.list.

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 các tài nguyên Creative.

Kể từ ngày 30 tháng 9 năm 2024, các giá trị sau đây cho thuộc tính đã xác định ngừng cung cấp các loại nhắm mục tiêu trên YouTube và Mục hàng của Đối tác:

• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION:
• CONTENT_RATING_TIER_UNRATED
• CONTENT_RATING_TIER_GENERAL
• CONTENT_RATING_TIER_PARENTAL_GUIDANCE
• CONTENT_RATING_TIER_TEENS
• CONTENT_RATING_TIER_MATURE
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION:
• SENSITIVE_CATEGORY_EMBEDDED_VIDEO
• SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

Hệ thống sẽ tự động xoá các tiêu chí nhắm mục tiêu ngừng hoạt động khỏi tiêu chí nhắm mục tiêu mục hàng hiện tại.

Để tránh bị 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 tài khoản YouTube và Mục hàng của Đối tác trước ngày ngừng cung cấp.

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

Để tránh bị 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 mục hàng hiện tại và đối tượng kết hợp trước ngày ngừng cung cấp.

Kể từ ngày 30 tháng 9 năm 2024, những tài nguyên LineItem sử dụng một số chiến lược giá thầu sẽ không còn tương thích với tính năng tối ưu hoá tiêu chí nhắm mục tiêu nữa. Với thay đổi này, LineItem tài nguyên có targetingExpansion.enableOptimizedTargeting được đặt thành True và bidStrategy.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 hay bidStrategy.performanceGoalAutoBid.performanceGoalType được đặt thành BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM sẽ được cập nhật thành 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 những mục hàng đang sử dụng các chiến lược giá thầu này chưa bật tính năng tối ưu hoá tiêu chí nhắm mục tiêu.

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 đặt trường đơn đặt hàng quảng cáo pacing nữa. pacingType cho tất cả đơn đặt hàng quảng cáo 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 quảng cáo hiện có bằng PACING_TYPE_ASAP và PACING_PERIOD_FLIGHT.