Lọc

Tham số chuỗi truy vấn filters hạn chế dữ liệu được trả về trong báo cáo API Quản lý AdSense. Khi sử dụng tham số filters, bạn sẽ cung cấp phương diện bạn muốn lọc, theo sau là biểu thức lọc.

Truy vấn được lọc sẽ giới hạn các hàng có trong kết quả. Mỗi hàng trong kết quả sẽ được kiểm tra so với bộ lọc: nếu bộ lọc khớp, hàng sẽ được giữ lại và nếu không khớp, hàng sẽ bị loại bỏ.

  • Mã hoá URL: Thư viện ứng dụng tự động mã hoá các toán tử bộ lọc. Tuy nhiên, nếu gửi yêu cầu trực tiếp đến giao thức, bạn phải mã hoá rõ ràng các toán tử bộ lọc như đã nêu trong bảng dưới đây.
  • Mức độ ưu tiên lọc: Quá trình lọc diễn ra trước khi bất kỳ phương diện nào được tổng hợp để các chỉ số được trả về chỉ đại diện cho tổng số của những phương diện có liên quan.

Cú pháp bộ lọc

Một bộ lọc sử dụng biểu mẫu:

name operator expression

Trong cú pháp này:

  • name — tên của phương diện cần lọc. Ví dụ: AD_CLIENT_ID sẽ lọc theo mã ứng dụng quảng cáo.
  • toán tử — xác định kiểu khớp bộ lọc sẽ sử dụng.
  • biểu thức — cho biết các giá trị có trong kết quả.

Bạn có thể dùng tất cả phương diện áp dụng cho các chỉ số đang được báo cáo làm bộ lọc, ngoại trừ các phương diện liên quan đến ngày (DATE, WEEK và MONTH). Để lọc theo ngày, hãy chỉ định phạm vi ngày cho báo cáo.

Toán tử bộ lọc

Có hai toán tử lọc. Các toán tử phải được mã hoá URL để có thể đưa vào chuỗi truy vấn URL.

Đơn vị tổ chức Nội dung mô tả Biểu mẫu được mã hóa URL Ví dụ:
== Khớp chính xác %3D%3D Các chỉ số tổng hợp có tên quốc gia là Canada:
filters=COUNTRY_NAME%3D%3DCanada
=@ Chứa chuỗi con %3D@ Các chỉ số tổng hợp trong đó tên quốc gia chứa United (Vương quốc Anh), tên này sẽ khớp với Hoa Kỳ và Vương quốc Anh, ví dụ:
filters=COUNTRY_NAME%3D@United

Biểu thức lọc

Có một số quy tắc quan trọng đối với biểu thức lọc:

  • Ký tự dành riêng cho URL — Các ký tự như & phải được mã hoá url theo cách thông thường. Thư viện ứng dụng sẽ xử lý việc này cho bạn, vì vậy, bạn chỉ phải lo lắng về việc mã hoá này nếu đang thực hiện lệnh gọi trực tiếp đến giao thức.
  • Ký tự đặt trước – Dấu phẩy và dấu gạch chéo ngược phải là dấu gạch chéo ngược (dấu gạch chéo ngược) khi chúng xuất hiện trong một biểu thức.
    • dấu gạch chéo ngược \\
    • dấu phẩy \,

Lưu ý: Hãy nhớ thoát dấu gạch chéo ngược trước dấu phẩy để tránh thoát 2 lần.

Kết hợp các bộ lọc

Bạn có thể kết hợp các bộ lọc bằng cách sử dụng logic boolean OR và AND.

Logic OR

Logic OR được xác định bằng dấu phẩy (,) bên trong biểu thức bộ lọc.

Ví dụ: (mỗi URL đều phải được mã hoá URL)

Mã quốc gia là (Hoa Kỳ HOẶC Vương quốc Anh):
COUNTRY_CODE==US,COUNTRY_CODE==UK

Logic AND

Logic AND đạt được bằng cách cung cấp nhiều tham số bộ lọc, đồng nghĩa với việc cung cấp một mảng bộ lọc trong thư viện ứng dụng.

Ví dụ:

Mã quốc gia là Hoa Kỳ VÀ mã sản phẩm là AFC:
filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC

Kết hợp logic AND và OR

Bạn có thể kết hợp logic AND và OR thành một biểu thức duy nhất.

Lưu ý: Mỗi bộ lọc được đánh giá riêng lẻ trước khi tất cả các bộ lọc được kết hợp thành biểu thức logic AND.

Ví dụ:

Mã quốc gia là (Hoa Kỳ HOẶC Vương quốc Anh) VÀ mã sản phẩm là AFC:
filters=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filters=PRODUCT_CODE%3D%3DAFC

Các bước tiếp theo