Các phương pháp hay nhất và hạn chế

Hãy xem xét các nguyên tắc sau khi sử dụng BatchJobService.

Cải thiện thông lượng

• Bạn nên có ít công việc lớn hơn thay vì nhiều công việc nhỏ hơn.

• Sắp xếp các thao tác đã tải lên theo loại thao tác. Ví dụ: nếu công việc của bạn chứa các thao tác để thêm chiến dịch, nhóm quảng cáo và tiêu chí nhóm quảng cáo, hãy sắp xếp các thao tác trong tệp tải lên sao cho tất cả thao tác chiến dịch đều ở vị trí đầu tiên, tiếp theo là tất cả thao tác nhóm quảng cáo và cuối cùng là tất cả thao tác tiêu chí nhóm quảng cáo.

• Trong các thao tác cùng loại, bạn có thể cải thiện hiệu suất bằng cách nhóm các thao tác theo tài nguyên mẹ. Ví dụ: nếu bạn có một loạt các đối tượng AdGroupCriterionOperation, thì việc nhóm các thao tác theo nhóm quảng cáo có thể hiệu quả hơn thay vì trộn lẫn các thao tác ảnh hưởng đến tiêu chí nhóm quảng cáo trong các nhóm quảng cáo khác nhau.

Tính nguyên tử trong việc chia 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 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.

Tránh các vấn đề về tính đồng thời

• Khi gửi nhiều công việc đồng thời cho cùng một tài khoản, hãy cố gắng giảm khả năng các công việc hoạt động trên cùng một đối tượng cùng một lúc, đồng thời duy trì kích thước công việc lớn. Nhiều công việc chưa hoàn thành, có trạng thái RUNNING, cố gắng thay đổi cùng một nhóm đối tượng, điều này có thể dẫn đến các điều kiện tương tự như bế tắc, dẫn đến tình trạng chậm trễ nghiêm trọng và thậm chí là lỗi công việc.

• Đừng gửi nhiều thao tác làm thay đổi cùng một đối tượng trong cùng một công việc, vì kết quả có thể không dự đoán được.

Truy xuất kết quả một cách tối ưu

• Đừng thăm dò trạng thái công việc quá thường xuyên, nếu không bạn có thể gặp phải lỗi giới hạn tốc độ.

• Đừng truy xuất quá 1.000 kết quả trên mỗi trang. Máy chủ có thể trả về ít hơn số đó do tải hoặc các yếu tố khác.

• Thứ tự kết quả sẽ giống với thứ tự tải lên.

Hướng dẫn bổ sung về cách sử dụng

• Bạn có thể đặt giới hạn trên cho thời gian mà một công việc hàng loạt được phép chạy trước khi bị huỷ. Khi tạo một lô công việc mới, hãy đặt trường metadata.execution_limit_seconds thành giới hạn thời gian mà bạn muốn (tính bằng giây). Không có giới hạn thời gian mặc định nếu bạn không đặt metadata.execution_limit_seconds.

• Bạn nên thêm không quá 1.000 thao tác cho mỗi AddBatchJobOperationsRequest và dùng sequence_token để tải các thao tác còn lại lên cùng một công việc. Tuỳ thuộc vào nội dung của các thao tác, quá nhiều thao tác trong một AddBatchJobOperationsRequest có thể gây ra lỗi REQUEST_TOO_LARGE. Bạn có thể xử lý lỗi này bằng cách giảm số lượng thao tác và thử lại AddBatchJobOperationsRequest.

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

• Mỗi BatchJob hỗ trợ tối đa một triệu thao tác.

• Mỗi tài khoản có thể có tối đa 100 công việc đang hoạt động hoặc đang chờ xử lý cùng một lúc.

• Các lệnh đang chờ xử lý đã quá 7 ngày sẽ tự động bị xoá.

• Kể từ phiên bản 22, mỗi yêu cầu AddBatchJobOperations có giới hạn là 10.000 thao tác biến đổi cho mỗi yêu cầu.

• Kể từ phiên bản 22, đối với trường page_size trong ListBatchJobResultsRequest:

  • Nếu bạn không đặt page_size hoặc đặt giá trị này là 0, thì hệ thống sẽ mặc định đặt giá trị tối đa là 1.000.
  • Nếu page_size vượt quá 1.000 hoặc nhỏ hơn 0, thì API sẽ trả về lỗi INVALID_PAGE_SIZE.

• Mỗi AddBatchJobOperationsRequest có kích thước tối đa là 10.484.504 byte. Nếu vượt quá hạn mức này, bạn sẽ nhận được INTERNAL_ERROR. Bạn có thể xác định kích thước của yêu cầu trước khi gửi và thực hiện hành động thích hợp nếu yêu cầu đó quá lớn.

  Java

  
  static final int MAX_REQUEST_BYTES = 10_484_504;
  
  ... (code to get the request object)
  
  int sizeInBytes = request.getSerializedSize();
  

  Python

  
  from google.ads.googleads.client import GoogleAdsClient
  
  MAX_REQUEST_BYTES = 10484504
  
  ... (code to get the request object)
  
  size_in_bytes = request._pb.ByteSize()
  

  Ruby

  
  require 'google/ads/google_ads'
  
  MAX_REQUEST_BYTES = 10484504
  
  ... (code to get the request object)
  
  size_in_bytes = request.to_proto.bytesize
  

  PHP

  
  use Google\Ads\GoogleAds\V16\Resources\Campaign;
  
  const MAX_REQUEST_BYTES = 10484504;
  
  ... (code to get the request object)
  
  $size_in_bytes = $campaign->byteSize() . PHP_EOL;
  

  .NET

  
  using Google.Protobuf;
  const int MAX_REQUEST_BYTES = 10484504;
  
  ... (code to get the request object)
  
  int sizeInBytes = request.ToByteArray().Length;
  

  Perl

  
  use Devel::Size qw(total_size);
  use constant MAX_REQUEST_BYTES => 10484504;
  
  ... (code to get the request object)
  
  my $size_in_bytes = total_size($request);