Báo cáo đã lọc

API Báo cáo Search Ads 360 mới hiện đã ra mắt. API mới cung cấp linh hoạt hơn nữa trong việc xây dựng các báo cáo tuỳ chỉnh và tích hợp dữ liệu vào các ứng dụng báo cáo và quy trình. Tìm hiểu thêm về cách di chuyển sang và sử dụng Báo cáo Search Ads 360 mới .

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 ... }
]
Lưu ý: Có một số cột không lọc được. Trong tài liệu tham khảo Loại báo cáo, mỗi cột cho biết nếu giá trị là 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ư String list).

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 Boolean, thì API Search Ads 360 sẽ chuyển đổi false thành một giá trị số từ 0 và true thành 1. Nếu bạn chỉ định bộ lọc này cho cột String, API sẽ so sánh thứ tự từ điển.

Không hợp lệ cho các loại dữ liệu danh sách (chẳng hạn như String list).

 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 Boolean, API sẽ chuyển đổi false thành một giá trị số từ 0 và true thành 1. Nếu bạn chỉ định bộ lọc này cho cột String, API sẽ so sánh thứ tự từ điển.

Không hợp lệ cho các loại dữ liệu danh sách (chẳng hạn như String list).

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 Boolean, API sẽ chuyển đổi false thành một giá trị số từ 0 và true thành 1. Nếu bạn chỉ định bộ lọc này cho cột String, API sẽ so sánh thứ tự từ điển.

Không hợp lệ cho các loại dữ liệu danh sách (chẳng hạn như String list).

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 Boolean, API sẽ chuyển đổi false thành một giá trị số từ 0 và true thành 1. Nếu bạn chỉ định bộ lọc này cho cột String, API sẽ so sánh thứ tự từ điển.

Không hợp lệ cho các loại dữ liệu danh sách (chẳng hạn như String list).

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 String cột.

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 containsSubstring có các giá trị:

["ham", "cheese"] sẽ trả về các hàng có giá trị này:

hamburger cheeseburger

nhưng sẽ không trả về các hàng có những giá trị này:
lobster roll
lettuce
high amplitude (high amplitude bao gồm chuỗi con "h am", nhưng tất cả ký tự (bao gồm cả dấu cách) đều được bộ lọc đánh giá)

Chỉ hợp lệ cho String cột.

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 doesNotContainSubstring có các giá trị:

["ham", "cheese"] sẽ trả về các hàng có giá trị này:

lobster roll lettuce

nhưng sẽ không trả về các hàng có những giá trị này:
bánh mì kẹp thịt
bánh mì kẹp thịt phô mai

Chỉ hợp lệ cho String cột.

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ư String list).

Ví dụ: trong báo cáo campaign, một bộ lọc containsElement có các giá trị:

["foo", "bar"] lọc trên cột effectiveLabels sẽ chỉ trả về các chiến dịch được gắn nhãn foo, bar hoặc cả hai.

biến thiên