Pemfilteran

Parameter string kueri filters membatasi data yang ditampilkan di laporan AdSense Management API. Saat menggunakan parameter filters, Anda masukkan dimensi yang ingin Anda filter, diikuti dengan ekspresi filter.

Kueri yang difilter membatasi baris yang disertakan dalam hasil. Setiap baris dalam hasilnya akan diuji terhadap filter: jika filter cocok, baris akan dipertahankan dan jika tidak cocok, baris akan dihapus.

  • Encoding URL: Library klien mengenkode secara otomatis operator filter. Namun, jika Anda membuat permintaan langsung ke protokol, Anda harus mengenkode operator filter secara eksplisit seperti yang ditunjukkan dalam tabel di bawah ini.
  • Prioritas pemfilteran: Pemfilteran terjadi sebelum dimensi digabungkan, sehingga metrik yang ditampilkan mewakili total hanya untuk dimensi yang relevan.

Filter Sintaksis

Satu filter menggunakan bentuk:

name operator expression

Dalam sintaksis ini:

  • name — nama dimensi yang akan difilter. Misalnya: AD_CLIENT_ID akan memfilter ID klien iklan.
  • operator — menentukan jenis pencocokan filter yang akan digunakan.
  • expression — menyatakan nilai yang disertakan dalam hasil.

Semua dimensi yang diterapkan pada metrik yang dilaporkan dapat digunakan sebagai filter, pengecualian dimensi terkait tanggal (DATE, WEEK, dan MONTH). Untuk memfilter menurut tanggal, tentukan rentang tanggal untuk laporan.

Operator Filter

Ada dua operator filter. Operator harus berenkode URL agar disertakan dalam string kueri URL.

Operator Deskripsi Formulir URL yang Dienkode Contoh
== Pencocokan persis %3D%3D Metrik agregat dengan nama negara Kanada:
filters=COUNTRY_NAME%3D%3DCanada
=@ Berisi {i>substring<i} %3D@ Metrik agregat dengan nama negara berisi United, ini cocok dengan Amerika Serikat dan Inggris Raya. Misalnya:
filters=COUNTRY_NAME%3D@United

Ekspresi Filter

Ada beberapa aturan penting untuk ekspresi filter:

  • Karakter yang dicadangkan untuk URL — Karakter seperti & harus dienkode ke URL dengan cara biasa. Library klien menanganinya, jadi Anda hanya perlu mengkhawatirkan pengkodean jika Anda melakukan panggilan langsung ke protokol.
  • Karakter yang dicadangkan — Tanda koma dan garis miring terbalik harus garis miring terbalik akan di-escape saat muncul dalam ekspresi.
    • garis miring terbalik \\
    • koma \,

Catatan: Pastikan Anda meng-escape garis miring terbalik sebelum koma, untuk menghindari {i>double escaping<i}.

Menggabungkan Filter

Filter dapat digabungkan menggunakan boolean OR dan AND logika.

Logika OR

Logika OR ditentukan menggunakan koma (,) di dalam ekspresi filter.

Contoh: (masing-masing harus dienkode ke URL)

Kode negara adalah (AS ATAU Inggris Raya):
COUNTRY_CODE==US,COUNTRY_CODE==UK

Logika AND

Logika AND dicapai dengan menyediakan beberapa parameter filter, yang berarti menyediakan berbagai filter di library klien.

Contoh:

Kode negara adalah US DAN kode produk adalah AFC:
filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC

Menggabungkan logika DAN dan ATAU

Anda dapat menggabungkan logika DAN dan ATAU menjadi satu ekspresi.

Catatan: Setiap filter dievaluasi satu per satu sebelum semua filter digabungkan ke dalam ekspresi logika AND.

Contoh:

Kode negara adalah (US OR UK) DAN kode produk adalah AFC:
filters=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filters=PRODUCT_CODE%3D%3DAFC

Langkah berikutnya