Bộ lọc nhóm trang thông tin trong công việc hàng loạt

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Khi làm việc với bộ lọc nhóm trang thông tin trong ngữ cảnh của AdGroupCriterion.listing_group hoặc AssetGroupListingGroupFilter, bạn nên cân nhắc một số yếu tố khi thiết kế tính năng tích hợp.

Phân tách hàng loạt

Nếu có bất kỳ thao tác nào trong một công việc hàng loạt chứa tiêu chí nhóm quảng cáo hoặc bộ lọc nhóm trang thông tin nhóm thành phần, thì các thao tác trong công việc hàng loạt sẽ được chia thành nhiều công việc hàng loạt phụ khi máy chủ Google Ads API nhận được. Xin lưu ý rằng không giống như các thao tác chuẩn trong một công việc hàng loạt, mỗi lô con chứa các thao tác lọc nhóm trang thông tin được xử lý một cách nguyên tử.

Cách các công việc hàng loạt chứa bộ lọc nhóm trang thông tin được chia thành các lô phụ được xác định theo các yếu tố sau:

1. Loại bộ lọc nhóm trang thông tin
2. AdGroupCriterion hoặc AssetGroup mà bộ lọc nhóm trang thông tin đang nhắm đến
3. Thứ tự thực hiện phép tính

Hãy lưu ý những điểm sau đây về cách nhóm các toán tử:

• Tất cả các thao tác AssetGroupListingGroupFilterOperation liên tiếp nhắm đến cùng một AssetGroup được nhóm lại với nhau trong một lô con nguyên tử (không có hành vi thất bại một phần).
• Tất cả các thao tác AdGroupCriterionOperation liên tiếp chứa một listing_group nhắm đến cùng một AdGroup được nhóm lại với nhau trong một lô con nguyên tử (không có hành vi thất bại một phần).
• Tất cả các thao tác liên tiếp khác được nhóm lại với nhau trong các lô con không nguyên tử (hành vi thất bại một phần).

Sơ đồ sau đây minh hoạ khái niệm này. Mỗi hộp màu xám đại diện cho một công việc hàng loạt được gửi bằng API Google Ads. Trong các hộp màu xám, các thao tác riêng lẻ được nhóm theo màu để biểu thị các lô phụ mà máy chủ API Google Ads tạo. Thứ tự của các thao tác trong mỗi hộp màu xám tương ứng với thứ tự các thao tác được thêm vào công việc hàng loạt.

Các điểm hạn chế

Khi làm việc với bộ lọc nhóm trang thông tin trong bối cảnh công việc hàng loạt, các giới hạn sau đây sẽ áp dụng:

• Một lô gồm các thao tác AssetGroupListingGroupFilterOperation chứa một listing_group và nhắm đến cùng một AdGroup không được vượt quá 20.000 thao tác. Tuy nhiên, bạn không nên vượt quá 10.000 thao tác.
• Một lô thao tác AssetGroupListingGroupFilterOperation nhắm đến cùng một AssetGroup không được vượt quá 10.000 thao tác.
• Việc vi phạm một trong các điều kiện này sẽ khiến toàn bộ công việc theo lô không thành công.

Khắc phục sự cố

Các thao tác lọc nhóm được liệt kê trong một công việc hàng loạt được xử lý dưới dạng một giao dịch, điều này có thể dẫn đến các trường hợp nhiều thao tác không thành công do một số ít thao tác không chính xác. Hơn nữa, do cách xử lý các thao tác BatchJob, nguyên nhân gốc rễ của các lỗi có thể xuất hiện ở một chỉ mục trước hoặc sau các lỗi ở hạ nguồn.

Ví dụ: khi xử lý phản hồi từ ListBatchJobResults, bạn có thể thấy một số thao tác không thành công kèm theo thông báo trạng thái Ad group is invalid due to the listing groups it contains. Thông báo này thường cho biết rằng thao tác tại chỉ mục này đã bị huỷ do một thao tác không thành công tại một chỉ mục khác. Để xác định nguyên nhân gốc rễ của vấn đề, bạn nên lặp lại tất cả thông báo trạng thái trong BatchJobResult – trước và sau chỉ mục của thông báo lỗi Ad group is invalid – để tìm thêm thông tin lỗi.