Cơ sở hạ tầng tập lệnh Google Ads mới dựa trên API Google Ads. Do kiến trúc khác nhau của API đó, bạn có thể cần phải cập nhật các tập lệnh hiện có. Chúng tôi đã cố gắng hết sức để đảm bảo khả năng tương thích ngược nhiều nhất có thể, vì vậy, những thay đổi này sẽ không đáng kể.
Báo cáo
Nhiều báo cáo AWQL sẽ tiếp tục hoạt động. Trên thực tế, khi sử dụng cơ sở hạ tầng mới, tập lệnh sẽ chuyển đổi truy vấn AWQL của bạn thành GAQL (ngôn ngữ truy vấn mới cho API Google Ads), chạy trên phần phụ trợ mới, sau đó chuyển đổi kết quả về định dạng ban đầu mà báo cáo AWQL sử dụng. Các truy vấn với GAQL sẽ được chuyển theo nguyên trạng.
Do chi phí này, bạn nên xem qua tập lệnh và cập nhật truy vấn AWQL lên GAQL bất cứ khi nào có thể. Bạn có thể dùng công cụ di chuyển truy vấn. Công cụ này sử dụng cùng một logic với tập lệnh để xác định truy vấn GAQL cho một truy vấn AWQL nhất định hoặc bạn có thể sử dụng trình tạo truy vấn tương tác để giúp tạo truy vấn.
Dưới đây là một số hạn chế đối với bản dịch tự động từ AWQL sang GAQL:
- Không phải tất cả truy vấn AWQL đều chuyển đổi rõ ràng sang truy vấn GAQL. Trong những trường hợp này, một thông báo lỗi kèm theo một số thông tin chi tiết về sự cố sẽ được ghi lại để giúp bạn khắc phục sự cố theo cách thủ công.
- Không phải tất cả các loại báo cáo từ AWQL đều được hỗ trợ trong GAQL.
- GAQL không hỗ trợ "hàng 0 lượt hiển thị". Việc chỉ định rằng một báo cáo phải có lượt hiển thị bằng 0 sẽ dẫn đến lỗi.
- Không thể sử dụng một số trường không rõ ràng trong bộ lọc. Ví dụ: "Dòng tiêu đề" có thể tham chiếu đến số lượng trường quảng cáo khác nhau bất kỳ.
- Một số trường có thể trả về kết quả ở định dạng khác, chẳng hạn như chia một kết quả thành nhiều cột.
Sắp xếp bộ chọn
Khi tìm nạp tài nguyên bằng tập lệnh, bạn nên sử dụng lệnh gọi withCondition và orderBy để hạn chế hoặc sắp xếp các kết quả trong trình lặp. Các trường trong các lệnh gọi này hiện sử dụng tên mới của API Google Ads. Ví dụ:
để lọc theo tên chiến dịch, trước đây bạn có thể sử dụng:
.withCondition('CampaignName = "SOME_CAMPAIGN_NAME"')
Bây giờ, bạn nên sử dụng tên trường mới cho các điều kiện sau bất cứ khi nào có thể:
.withCondition('campaign.name = "SOME_CAMPAIGN_NAME"')
Tuy nhiên, chúng tôi đã nỗ lực liên kết các tên cũ với tên mới, vì vậy, nếu tập lệnh của bạn vẫn sử dụng CampaignName, tập lệnh sẽ tự động được thay thế bằng campaign.name trong thời gian chạy để đảm bảo tập lệnh vẫn hoạt động. Nếu bạn gặp bất kỳ vấn đề nào với tên kiểu cũ, hãy cập nhật tập lệnh để sử dụng tên kiểu mới làm bước khắc phục sự cố đầu tiên.
Giới hạn
Nhiều giới hạn vẫn giống như trên cơ sở hạ tầng cũ và những thay đổi được thực hiện ở đây nhìn chung sẽ giúp tăng hiệu suất.
- Giới hạn thời gian là như nhau. Tập lệnh có thể thực thi trong 30 phút.
- Theo mặc định,một biến lặp đơn trả về 50.000 thực thể, nhưng trường hợp này có thể bị ghi đè. Trước đây, bạn không thể tuỳ chỉnh giới hạn 50.000 này.
- Một bộ chọn có thể xử lý tối đa 10.000 mã nhận dạng (không thay đổi).
- Cơ sở hạ tầng mới không có giới hạn về số lượng thực thể có thể được xử lý trong một tập lệnh. Trước đây,giới hạn là 250.000.
- Cơ sở hạ tầng mới không có giới hạn về số lượng từ khoá hoặc quảng cáo có thể được tạo trong mỗi lần thực thi. Trước đây,giới hạn là 250.000.
- Đầu ra nhật ký bị cắt ngắn ở mức 100 kb (không thay đổi).
- Hạn mức cho các dịch vụ Apps Script (Bảng tính, Ứng dụng Mail, v.v.) không thay đổi.
- Hạn mức cho Google Ads sẽ được thực thi giống như khi bạn sử dụng API. Điều này nghĩa là tập lệnh của bạn sẽ phải tuân theo giới hạn số lượng yêu cầu API, nhưng điều này cho phép bạn linh hoạt hơn trong việc truy cập vào nhiều báo cáo hơn hoặc thực hiện nhiều thay đổi hơn cho mỗi lần thực thi.
Nội dung thay đổi khác
ExecutionInfo không còn hiển thị getRemainingCreateQuota() hoặc getRemainingGetQuota(), vì các hạn mức đó không còn áp dụng trong trải nghiệm mới.