Bộ chọn giúp lập trình viên tạo truy vấn tìm nạp các thực thể Google Ads mong muốn. Với bộ chọn, người dùng có thể thu hẹp danh sách các thực thể được truy xuất và sắp xếp danh sách đó. Hầu hết bộ chọn đều có những thông số sau phương thức:
withCondition()- Thêm điều kiện vào bộ chọn. Nếu bạn sử dụng nhiều điều kiện, Được kết hợp với nhau, nói cách khác, bộ chọn sẽ chỉ trả về các thực thể đáp ứng tất cả điều kiện được chỉ định.
withIds()- Thêm bộ sưu tập mã nhận dạng dưới dạng . Điều kiện dựa trên mã nhận dạng sẽ được kết hợp với tất cả các điều kiện khác bằng toán tử AND.
forDateRange()- Cần thiết khi một điều kiện hoặc mệnh đề sắp xếp tham chiếu đến trường Số liệu thống kê, chẳng hạn như Ctr hoặc Lượt hiển thị. Nếu bạn yêu cầu tất cả chiến dịch có hơn 100 lượt hiển thị, thì tập lệnh Google Ads sẽ cần biết phạm vi ngày để xem xét.
orderBy()- Chỉ định thứ tự của các thực thể được trả về.
withLimit()- Giới hạn số lượng thực thể được trả về ở giá trị được chỉ định. Đó là
đặc biệt hữu ích kết hợp với
orderBy()để tìm nạp mọi thứ chẳng hạn như "10 từ khoá có nhiều lượt hiển thị nhất vào hôm qua". Theo mặc định, tất cả bộ chọn sẽ đặt giới hạn là 50.000. Bạn có thể tăng giới hạn bằng cách chỉ định giới hạn theo cách thủ công.
Các phương thức này có thể được gọi theo thứ tự bất kỳ. Một trường hợp ngoại lệ là orderBy(), trong đó thứ tự của các lệnh gọi thực sự quan trọng: nhiều lệnh gọi đến phương thức này sẽ chỉ định nhiều mệnh đề thứ tự và các mệnh đề này sẽ áp dụng theo thứ tự. Hãy xem xét đoạn mã sau:
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
Kết quả sẽ được sắp xếp theo Số lượt nhấp theo thứ tự giảm dần. Các kết quả có giá trị Số lượt nhấp bằng nhau sẽ được sắp xếp theo Tỷ lệ nhấp theo thứ tự tăng dần.
Các lệnh gọi đến các phương thức của bộ chọn có thể được xâu chuỗi lại với nhau. Mã sau
var campaignSelector = AdsApp.campaigns();
campaignSelector.withCondition("metrics.clicks > 10");
campaignSelector.withCondition("metrics.impressions > 1000");
campaignSelector.orderBy("metrics.impressions DESC");
campaignSelector.forDateRange("YESTERDAY");
có thể được viết lại theo cách gọn nhẹ hơn:
var campaignSelector = AdsApp.campaigns()
.withCondition("metrics.clicks > 10")
.withCondition("metrics.impressions > 1000")
.orderBy("metrics.impressions DESC")
.forDateRange("YESTERDAY");
Sau khi tạo xong bộ chọn, bạn có thể có được
Biến lặp từ nó bằng cách gọi
selector.get().
Đọc Các phương pháp hay nhất để biết các mẹo và thủ thuật về cách sử dụng bộ chọn hiệu quả.