Laporan yang Difilter

Search Ads 360 Reporting API versi baru kini tersedia. API baru ini memberikan fleksibilitas yang lebih baik dalam membuat laporan kustom dan mengintegrasikan data ke dalam proses dan aplikasi pelaporan Anda. Pelajari lebih lanjut cara bermigrasi ke dan menggunakan Search Ads 360 Reporting API baru.

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

Misalnya, Anda dapat meminta laporan dari semua kata kunci di agensi. Kemudian, Anda dapat menentukan filter sehingga hanya kata kunci dengan URL halaman landing yang dimulai dengan www.example.com dan www.another-example.com yang muncul dalam 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 yang ditentukan:

"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 akan menunjukkan apakah kolom tersebut adalah Filterable.

Operator filter

Semua filter peka huruf besar/kecil. Artinya, filter dengan "www.Sprockets.com" tidak akan cocok dengan 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 cocok 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 kurang 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 menetapkan 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 dalam daftar filter. Jika Anda menentukan filter ini untuk kolom Boolean, API akan mengonversi false menjadi nilai numerik 0 dan true menjadi 1. Jika Anda menetapkan 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 dalam daftar filter. Jika Anda menentukan filter ini untuk kolom Boolean, API akan mengonversi false menjadi nilai numerik 0 dan true menjadi 1. Jika Anda menetapkan 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 dalam daftar filter. Jika Anda menentukan filter ini untuk kolom Boolean, API akan mengonversi false menjadi nilai numerik 0 dan true menjadi 1. Jika Anda menetapkan 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 valid untuk String kolom.	variabel
containsSubstring	Kolom harus berisi semua atau sebagian dari salah satu string yang ditentukan 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 berikut: lobster roll lettuce high amplitude (high amplitude mencakup substring "h am", tetapi semua karakter—termasuk spasi—dievaluasi oleh filter) Hanya valid 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 berikut: hamburger cheeseburger Hanya valid untuk String kolom.	variabel
containsElement	Kolom harus berisi setidaknya salah satu nilai dalam daftar filter. Hanya valid untuk kolom dengan jenis data daftar (seperti String list). Misalnya dalam laporan campaign, filter containsElement dengan nilai: ["foo", "bar"] pemfilteran pada kolom effectiveLabels hanya akan menampilkan kampanye yang diberi label foo, bar, atau keduanya.	variabel