Bộ lọc nhóm trang thông tin trong 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 theo lô

Nếu có bất kỳ thao tác nào trong một công việc hàng loạt có 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. Xin lưu ý rằng không giống như các thao tác tiêu chuẩn trong một lô công việc, mỗi lô con chứa các thao tác lọc nhóm trang thông tin đều được xử lý một cách riêng lẻ.

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. AdGroupCriterion hoặc AssetGroup 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 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 có chứa một 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ô con không phải là lô con riêng lẻ (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 lô công việc đượ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ủ Google Ads API 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ự mà các thao tác sẽ được thêm vào lệnh hàng loạt.

hình ảnh

Tính nguyên tố trong tính năng Phân chia theo lô

Google Ads API có thể chia các thao tác trong một lô công việc đã gửi thành các lô con nhỏ hơn để xử lý. Nếu bạn không nhóm các thao tác có liên quan, chẳng hạn như sửa đổi nhóm trang thông tin trong một AssetGroup và một AdGroup, liên tiếp trong một lô công việc, thì Google Ads API có thể chia các thao tác này thành nhiều lô con. Việc tách biệt này có thể dẫn đến việc toàn bộ nội dung sửa đổi không thành công hoặc khiến tài khoản ở trạng thái không nhất quán.

Nhóm logic

AssetGroupListingGroupFilterOperation quản lý nhóm trang thông tin trong AssetGroup. Đây là trường hợp thường gặp trong chiến dịch Tối đa hoá hiệu suất. AdGroupCriterionOperation quản lý các nhóm trang thông tin trong một AdGroup. Đây là trường hợp thường gặp trong chiến dịch Mua sắm chuẩn. Cả hai đều được dùng để xác định tiêu chí nhắm mục tiêu theo sản phẩm. Nếu bạn thực hiện các thay đổi ảnh hưởng đến hệ phân cấp nhắm mục tiêu sản phẩm ở cả hai bối cảnh, hãy nhóm các thao tác này liên tiếp trong công việc hàng loạt để đảm bảo chúng được áp dụng cùng nhau.

Tính nhất quán của dữ liệu

Để duy trì tính nhất quán của dữ liệu và ngăn chặn các bản cập nhật một phần, hãy thêm các thao tác nhóm trang thông tin có liên quan liên tiếp vào lệnh hàng loạt. Thứ tự này giúp nhóm các thao tác thành các lô con riêng lẻ theo logic phân chia lô của API, nhờ đó ngăn tài khoản của bạn rơi vào trạng thái không nhất quán.

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ác lô công việc, bạn phải tuân thủ những giới hạn sau:

  • Một lô gồm các thao tác AdGroupCriterionOperation chứa 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ô gồm các thao tác AssetGroupListingGroupFilterOperation nhắm đến cùng một AssetGroup không được vượt quá 10.000 thao tác.
  • Nếu vi phạm một trong hai điều kiện này, toàn bộ công việc hàng loạt sẽ thất bại.

Khắc phục sự cố

Các thao tác lọc nhóm trang thông tin trong một lô công việc đượ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 mà 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 các lỗi có thể xuất hiện ở chỉ mục trước hoặc sau các lỗi hạ lưu.

Ví dụ: khi xử lý một phản hồi từ ListBatchJobResults, bạn có thể thấy rằng 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 về lỗi.