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 dùng tham số filters, bạn cung cấp thứ nguyên bạn muốn lọc, theo sau là biểu thức bộ lọc.

Truy vấn được lọc sẽ hạn chế những hàng được đưa vào kết quả. Mỗi hàng trong kết quả đượ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ị 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 bạn 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ư được nêu trong bảng dưới đây.
  • Mức độ ưu tiên của bộ lọc: Quá trình lọc diễn ra trước bất kỳ các phương diện được tổng hợp, để các chỉ số được trả về thể hiện tổng số chỉ cho các 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 khách 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ả.

Tất cả phương diện mà áp dụng cho các chỉ số đang được báo cáo có thể được dùng làm bộ lọc, với ngoại lệ các phương diện có 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ử lọc

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

Đơn vị tổ chức Mô tả Biểu mẫu 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 có chứa Hoa Kỳ, khớp với Hoa Kỳ và Vương quốc Anh. Ví dụ:
filters=COUNTRY_NAME%3D@United

Biểu thức bộ lọc

Có một số quy tắc quan trọng cho biểu thức bộ 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 bạn phải xử lý vấn đề này, nên bạn chỉ phải lo lắng về việc mã hoá này nếu bạn đang thực hiện lệnh gọi trực tiếp đến giao thức.
  • Ký tự dành riêng — Dấu phẩy và dấu gạch chéo ngược phải được thoát 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 ý: Đảm bảo bạn thoát khỏi dấu gạch chéo ngược trước dấu phẩy để tránh thoát kép.

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

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

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 email 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 có được bằng cách cung cấp nhiều tham số bộ lọc, điều này đồng nghĩa với việc cung cấp một mảng các bộ lọc trong thư viện ứng dụng.

Ví dụ:

Mã quốc gia là US 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

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 sẽ được đánh giá riêng trước khi tất cả các bộ lọc được kết hợp thành một 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