Sử dụng bộ lọc nhóm trang thông tin trong các công việc hàng loạt

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

Tách lô hàng

Điểm chính: Bạn nên thêm các thao tác AssetGroupListingGroupFilterOperation (create, update và remove) nhắm đến cùng một AssetGroup và các thao tác AdGroupCriterionOperation (create, update và remove) cho tiêu chí LISTING_GROUP (AdGroupCriterion.listing_group) nhắm đến cùng một AdGroup vào một công việc theo lô liên tiếp, để tập hợp các thao tác được coi là nguyên tử trong quá trình phân tách lô.

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 của nhóm tài sản, thì các thao tác trong công việc hàng loạt sẽ được chia thành nhiều nhóm con khi được máy chủ Google Ads API nhận. Không giống như các thao tác chuẩn trong một công việc theo lô, mỗi lô phụ chứa các thao tác lọc nhóm trang thông tin đều được coi là một đơn vị nguyên tử.

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

1. Loại bộ lọc nhóm trang thông tin
2. AdGroup hoặc AssetGroup mà bộ lọc nhóm trang thông tin đang nhắm đến
3. Độ ưu tiên của toán tử

Hãy cân nhắc cách nhóm các thao tác:

• Tất cả các thao tác AssetGroupListingGroupFilterOperation liên tiếp (create, update và remove) nhắm đến cùng một AssetGroup sẽ đượ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 (create, update và remove) cho tiêu chí LISTING_GROUP (AdGroupCriterion.listing_group) nhắm đến cùng một AdGroup sẽ đượ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ô phụ không nguyên tử (hành vi không thành công một phần).

Lưu ý: Nếu bạn cũng đang tạo AssetGroup trong cùng một công việc theo lô, hãy đặt mọi thao tác AssetOperation (create) tiên quyết cho tài nguyên Asset mới trước AssetGroupOperation (create), ngay sau đó là các thao tác AssetGroupAssetOperation (create) (thực thi cùng nhau trong một lô phụ nguyên tử trước đó), rồi đến các thao tác AssetGroupListingGroupFilterOperation liên tiếp (thực thi trong lô phụ nguyên tử tiếp theo). Vì các thao tác này tạo thành 2 lô con riêng biệt, nên lỗi trong lô con AssetGroupListingGroupFilterOperation sẽ khôi phục các bộ lọc nhóm trang thông tin mà không khôi phục các tài nguyên AssetGroup và AssetGroupAsset mới tạo.

Thuật ngữ chính: Liên tiếp đề cập đến thứ tự của các thao tác trong công việc hàng loạt. Nếu các thao tác nhắm đến cùng một AdGroup hoặc AssetGroup được xen kẽ với các thao tác nhắm đến một nhóm khác, thì các thao tác đó sẽ được chia thành các lô phụ riêng biệt và không còn được xử lý dưới dạng một giao dịch nguyên tử duy nhất.

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 theo lô được gửi bằng Google Ads API. Trong các hộp màu xám, các thao tác riêng lẻ được nhóm theo màu để thể hiện các lô phụ mà máy chủ API Google Ads tạo ra. 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ự mà các thao tác sẽ được thêm vào lệnh 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ủa công việc theo lô, các giới hạn sau sẽ được áp dụng:

• Một lô phụ nguyên tử duy nhất gồm các thao tác AdGroupCriterionOperation liên tiếp (create, update và remove) cho các tiêu chí LISTING_GROUP (AdGroupCriterion.listing_group) 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. Vì mỗi AddBatchJobOperationsRequest bị giới hạn ở 10.000 thao tác, nên một lô phụ AdGroup gồm 10.001 đến 20.000 thao tác phải được tải lên trong ít nhất hai yêu cầu AddBatchJobOperations liên tiếp.
• Một lô phụ nguyên tử duy nhất gồm các thao tác AssetGroupListingGroupFilterOperation liên tiếp (create, update và remove) nhắm đến cùng một AssetGroup không được vượt quá 10.000 thao tác.
• Vi phạm một trong hai giới hạn về số lượng thao tác này (hoặc vượt quá giới hạn kích thước byte được chuyển đổi tuần tự nội bộ của máy chủ cho một lô con) sẽ huỷ bỏ công việc hàng loạt tại lô con đó: mọi lô con trước đó đã hoàn tất vẫn được cam kết, trong khi tất cả các thao tác trong lô con vi phạm và mọi lô con tiếp theo đều không thành công với InternalError.INTERNAL_ERROR.

Khắc phục sự cố

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

Ví dụ: khi xử lý phản hồi từ ListBatchJobResults:

• Đối với các nhóm trang thông tin AdGroupCriterionOperation, bạn có thể thấy rằng các thao tác liên tiếp nhắm đến cùng một AdGroup không thành công và có lỗi CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION (Product group operations are atomic within the same ad group. This operation failed because another operation targeting the same ad group ID was invalid.).
• Đối với các thao tác AssetGroupListingGroupFilterOperation, bạn có thể thấy rằng các thao tác liên tiếp nhắm đến cùng một AssetGroup không thành công với BatchJobError.ASSET_GROUP_LISTING_GROUP_FILTER_TRANSACTION_FAILURE.

Những lỗi này cho biết thao tác tại chỉ mục đó đã được khôi phục vì một thao tác khác trong cùng một lô con nguyên tử không thành công. Để xác định nguyên nhân gốc của vấn đề, hãy lặp lại thông qua các thông báo status trong mỗi BatchJobResult (trước và sau operation_index của lỗi giao dịch) cho các thao tác có cùng mã nhận dạng AdGroup hoặc AssetGroup.