Laporan yang Difilter

Search Ads 360 Reporting API versi baru kini tersedia. API baru menyediakan meningkatkan fleksibilitas dalam membuat laporan kustom dan mengintegrasikan data ke dalam aplikasi pelaporan dan proses. Pelajari lebih lanjut cara bermigrasi ke dan menggunakan Pelaporan Search Ads 360 versi baru Google Cloud Platform.

Secara default, laporan Anda akan berisi semua data dalam reportScope yang ditentukan oleh permintaan Anda. Jika Anda ingin laporan hanya berisi data yang sesuai dengan kumpulan kriteria, Anda dapat menambahkan satu atau beberapa filter ke laporan. Hanya baris yang memenuhi semua filter akan dikembalikan.

Misalnya, Anda dapat meminta laporan semua kata kunci dalam suatu agensi. Selanjutnya Anda dapat menentukan filter sehingga hanya kata kunci dengan URL halaman landing yang diawali dengan www.example.com dan www.another-example.com muncul di laporan.

"filters": [
  {
    "column" : { "columnName": "keywordLandingPage" },
    "operator" : "startsWith",
    "values" : [
      "http://www.example.com",
      "http://www.another-example.com"
    ]
  }
]

Setiap filter menentukan kolom yang akan difilter, operator, dan daftar nilai yang diharapkan berada di kolom tertentu:

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]

Catatan: Beberapa kolom tidak dapat difilter. Dalam referensi Jenis Laporan, setiap kolom menunjukkan jika Filterable.

Operator filter

Semua filter peka huruf besar/kecil. Yaitu, filter dengan "www.Sprockets.com" tidak akan cocok kolom yang berisi "www.sprockets.com".

Operator	Deskripsi	Jumlah nilai yang didukung
equals	Kolom harus sama persis dengan nilai yang ditentukan.	1
notEquals	Kolom tidak boleh sesuai dengan nilai yang ditentukan.	1
in	Kolom harus sama persis dengan salah satu nilai dalam daftar filter. Tidak valid untuk jenis data daftar (seperti String list).	variabel
lessThan	Kolom harus berisi nilai yang lebih kecil dari nilai yang ditentukan. Jika Anda menentukan filter ini untuk kolom Boolean, Search Ads 360 API akan mengonversi false menjadi nilai numerik 0 dan true menjadi 1. Jika Anda menentukan filter ini untuk kolom String, API akan membandingkan urutan leksikografis. Tidak valid untuk jenis data daftar (seperti String list).	1
greaterThan	Kolom harus berisi nilai yang lebih besar dari salah satu nilai di daftar filter. Jika Anda menentukan filter ini untuk kolom Boolean, API akan mengonversi false menjadi nilai numerik 0 dan true menjadi 1. Jika Anda menentukan filter ini untuk kolom String, API akan membandingkan urutan leksikografis. Tidak valid untuk jenis data daftar (seperti String list).	1
lessThanOrEqual	Kolom harus berisi nilai yang kurang dari atau sama dengan salah satu nilai nilai pada daftar filter. Jika Anda menentukan filter ini untuk kolom Boolean, API akan mengonversi false menjadi nilai numerik 0 dan true menjadi 1. Jika Anda menentukan filter ini untuk kolom String, API akan membandingkan urutan leksikografis. Tidak valid untuk jenis data daftar (seperti String list).	1
greaterThanOrEqual	Kolom harus berisi nilai yang lebih besar dari atau sama dengan salah satu nilai nilai pada daftar filter. Jika Anda menentukan filter ini untuk kolom Boolean, API akan mengonversi false menjadi nilai numerik 0 dan true menjadi 1. Jika Anda menentukan filter ini untuk kolom String, API akan membandingkan urutan leksikografis. Tidak valid untuk jenis data daftar (seperti String list).	1
isNull	Kolom harus kosong. Misalnya, jika Anda menentukan isNull untuk kolom keywordMaxCpc dalam laporan kata kunci, laporan hanya akan berisi kata kunci yang belum menentukan CPC Maks.	0
isNotNull	Kolom harus berisi nilai.	0
startsWith	Kolom harus diawali dengan salah satu string dalam daftar filter. Hanya berlaku untuk String kolom.	variabel
containsSubstring	Kolom harus berisi semua atau sebagian dari salah satu {i>string<i} yang ditetapkan dalam daftar filter. Misalnya, filter containsSubstring dengan nilai: ["ham", "cheese"] akan menampilkan baris dengan nilai ini: hamburger cheeseburger tetapi tidak akan menampilkan baris dengan nilai ini: lobster roll lettuce high amplitude (high amplitude termasuk {i>substring<i} "h am", tetapi semua karakter—termasuk spasi—dievaluasi oleh filter) Hanya berlaku untuk String kolom.	variabel
doesNotContainSubstring	Kolom tidak boleh berisi string apa pun dalam daftar filter. Misalnya, filter doesNotContainSubstring dengan nilai: ["ham", "cheese"] akan menampilkan baris dengan nilai ini: lobster roll lettuce tetapi tidak akan menampilkan baris dengan nilai ini: hamburger burger keju Hanya berlaku untuk String kolom.	variabel
containsElement	Kolom harus berisi setidaknya salah satu nilai dalam daftar filter. Hanya berlaku untuk kolom dengan jenis data daftar (seperti String list). Misalnya dalam laporan campaign, filter containsElement dengan nilai: ["foo", "bar"] memfilter kolom effectiveLabels hanya akan menampilkan kampanye yang diberi label foo, bar, atau keduanya.	variabel