Theo mặc định, báo cáo của bạn sẽ chứa tất cả dữ liệu trong reportScope mà yêu cầu của bạn chỉ định. Nếu muốn báo cáo chỉ chứa dữ liệu khớp với một nhóm tiêu chí, bạn có thể thêm một hoặc nhiều bộ lọc vào báo cáo. Hệ thống chỉ trả về những hàng đáp ứng mọi bộ lọc.
Ví dụ: bạn có thể yêu cầu một báo cáo gồm tất cả các từ khoá trong một công ty quảng cáo. Sau đó, bạn có thể chỉ định một bộ lọc để chỉ những từ khoá có URL trang đích bắt đầu bằng www.example.com và www.another-example.com mới xuất hiện trong báo cáo.
"filters": [ { "column" : { "columnName": "keywordLandingPage" }, "operator" : "startsWith", "values" : [ "http://www.example.com", "http://www.another-example.com" ] } ]
Mỗi bộ lọc chỉ định một cột cần được lọc, một toán tử và danh sách các giá trị dự kiến sẽ có trong cột được chỉ định:
"filters": [ { "column" : column to filter on, "operator" : operator specifying the type of filter, "values" : list of values }, { ... another filter can go here ... } ]
Filterable
hay không.
Toán tử lọc
Tất cả các bộ lọc đều phân biệt chữ hoa chữ thường. Nghĩa là, bộ lọc có "www.Sprockets.com" sẽ không khớp với cột chứa "www.sprockets.com".
Đơn vị tổ chức | Nội dung mô tả | Số lượng giá trị được hỗ trợ |
---|---|---|
equals |
Cột phải khớp chính xác với giá trị được chỉ định. | 1 |
notEquals |
Cột không được khớp với giá trị được chỉ định. | 1 |
in |
Cột này phải khớp chính xác với một trong các giá trị trong danh sách của bộ lọc.
Không hợp lệ với các kiểu dữ liệu danh sách (chẳng hạn như |
biến |
lessThan |
Cột phải chứa giá trị nhỏ hơn giá trị được chỉ định.
Nếu bạn chỉ định bộ lọc này cho cột Không hợp lệ với các kiểu dữ liệu danh sách (chẳng hạn như |
1 |
greaterThan |
Cột phải chứa một giá trị lớn hơn một trong các giá trị thuộc danh sách của bộ lọc.
Nếu bạn chỉ định bộ lọc này cho cột
Không hợp lệ với các kiểu dữ liệu danh sách (chẳng hạn như |
1 |
lessThanOrEqual |
Cột phải chứa một giá trị nhỏ hơn hoặc bằng một trong các giá trị trong danh sách của bộ lọc.
Nếu bạn chỉ định bộ lọc này cho cột
Không hợp lệ với các kiểu dữ liệu danh sách (chẳng hạn như |
1 |
greaterThanOrEqual |
Cột phải chứa một giá trị lớn hơn hoặc bằng một trong các giá trị trong danh sách của bộ lọc.
Nếu bạn chỉ định bộ lọc này cho cột
Không hợp lệ với các kiểu dữ liệu danh sách (chẳng hạn như |
1 |
isNull |
Cột này phải để trống. Ví dụ: nếu bạn chỉ định isNull
cho cột keywordMaxCpc trong một báo cáo từ khoá, thì báo cáo
sẽ chỉ chứa các từ khoá chưa chỉ định CPC tối đa.
|
0 |
isNotNull |
Cột phải chứa một giá trị. | 0 |
startsWith |
Cột phải bắt đầu bằng một trong các chuỗi thuộc danh sách của bộ lọc.
Chỉ hợp lệ cho |
biến |
containsSubstring |
Cột phải chứa tất cả hoặc một phần của một trong các chuỗi được chỉ định trong danh sách của bộ lọc.
Ví dụ: bộ lọc
nhưng sẽ không trả về các hàng có các giá trị này:
Chỉ hợp lệ cho |
biến |
doesNotContainSubstring |
Cột không được chứa bất kỳ chuỗi nào trong danh sách của bộ lọc.
Ví dụ: bộ lọc nhưng sẽ không trả về các hàng có các giá trị sau:
Chỉ hợp lệ cho |
biến |
containsElement |
Cột phải chứa ít nhất một trong các giá trị trong danh sách của bộ lọc.
Chỉ hợp lệ đối với các cột có kiểu dữ liệu danh sách (chẳng hạn như
Ví dụ: trong báo cáo |
biến |