Theo mặc định, báo cáo của bạn sẽ chứa tất cả dữ liệu trong reportScope mà mà yêu cầu của bạn chỉ định. Nếu bạn muốn một báo cáo chỉ chứa dữ liệu khớp với một tập hợp tiêu chí, bạn có thể thêm một hoặc nhiều bộ lọc vào báo cáo. Chỉ những hàng đáp ứng tất cả bộ lọc bị trả về.
Ví dụ: bạn có thể yêu cầu báo cáo tất cả các từ khoá trong một công ty quảng cáo. Sau đó bạn có thể chỉ định 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 sẽ 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 lọc, một toán tử và một danh sách giá trị đều nằm 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
.
Toán tử lọc
Tất cả các bộ lọc đều phân biệt chữ hoa chữ thường. Tức là bộ lọc có "www.Sprockets.com" sẽ không khớp một cột có chứa "www.sprockets.com".
Đơn vị tổ chức | 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 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ệ cho các loại dữ liệu danh sách (chẳng hạn như |
biến thiê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ệ cho các loại 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ị 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ệ cho các loại dữ liệu danh sách (chẳng hạn như |
1 |
lessThanOrEqual |
Cột phải chứa giá trị nhỏ hơn hoặc bằng một trong 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ệ cho các loại 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ệ cho các loại 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 báo cáo từ khoá, báo cáo này
sẽ chỉ chứa những 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 trong danh sách của bộ lọc.
Chỉ hợp lệ cho |
biến thiên |
containsSubstring |
Cột phải chứa toàn bộ hoặc một phần của một trong các chuỗi được chỉ định trong của bộ lọc.
Ví dụ: bộ lọc
nhưng sẽ không trả về các hàng có những giá trị này:
Chỉ hợp lệ cho |
biến thiê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ó những giá trị này:
Chỉ hợp lệ cho |
biến thiê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ệ cho 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 thiên |