โดยค่าเริ่มต้น รายงานของคุณจะมีข้อมูลทั้งหมดภายใน reportScope ที่ คำขอของคุณระบุไว้ หากคุณต้องการให้รายงานมีเฉพาะข้อมูลที่ตรงกับชุดของ เกณฑ์ คุณจะสามารถเพิ่มตัวกรองในรายงานได้ เฉพาะแถวที่ตรงกับตัวกรองทั้งหมด
เช่น ขอรายงานคีย์เวิร์ดทั้งหมดในเอเจนซี จากนั้น คุณสามารถระบุตัวกรองเพื่อให้เฉพาะคีย์เวิร์ดที่มี URL ของหน้า Landing Page ขึ้นต้นด้วย www.example.com และ www.another-example.com จะปรากฏในรายงาน
"filters": [ { "column" : { "columnName": "keywordLandingPage" }, "operator" : "startsWith", "values" : [ "http://www.example.com", "http://www.another-example.com" ] } ]
ตัวกรองแต่ละรายการจะระบุคอลัมน์ที่จะกรอง โอเปอเรเตอร์ และรายการค่าที่ ควรอยู่ในคอลัมน์ที่ระบุ:
"filters": [ { "column" : column to filter on, "operator" : operator specifying the type of filter, "values" : list of values }, { ... another filter can go here ... } ]
Filterable
โอเปอเรเตอร์ตัวกรอง
ตัวกรองทั้งหมดคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ กล่าวคือ ตัวกรองที่มี "www.Sprockets.com" จะไม่ตรง คอลัมน์ที่มี "www.sprockets.com"
โอเปอเรเตอร์ | คำอธิบาย | จำนวนค่าที่รองรับ |
---|---|---|
equals |
คอลัมน์ต้องตรงกับค่าที่ระบุทุกประการ | 1 |
notEquals |
คอลัมน์ต้องไม่ตรงกับค่าที่ระบุ | 1 |
in |
คอลัมน์ต้องตรงกับค่าใดค่าหนึ่งในรายการของตัวกรองทุกประการ
ใช้ไม่ได้กับประเภทข้อมูลรายการ (เช่น |
เปลี่ยนแปลงได้ |
lessThan |
คอลัมน์ต้องมีค่าที่น้อยกว่าค่าที่ระบุ
หากคุณระบุตัวกรองนี้สำหรับคอลัมน์ ใช้ไม่ได้กับประเภทข้อมูลรายการ (เช่น |
1 |
greaterThan |
คอลัมน์ต้องมีค่าที่มากกว่าหนึ่งในค่าใน รายการของตัวกรอง
หากคุณระบุตัวกรองนี้สำหรับคอลัมน์
ใช้ไม่ได้กับประเภทข้อมูลรายการ (เช่น |
1 |
lessThanOrEqual |
คอลัมน์ต้องมีค่าที่น้อยกว่าหรือเท่ากับค่าใดค่าหนึ่งของ ในรายการของตัวกรอง
หากคุณระบุตัวกรองนี้สำหรับคอลัมน์
ใช้ไม่ได้กับประเภทข้อมูลรายการ (เช่น |
1 |
greaterThanOrEqual |
คอลัมน์ต้องมีค่าที่มากกว่าหรือเท่ากับค่าใดค่าหนึ่งของ ในรายการของตัวกรอง
หากคุณระบุตัวกรองนี้สำหรับคอลัมน์
ใช้ไม่ได้กับประเภทข้อมูลรายการ (เช่น |
1 |
isNull |
คอลัมน์ต้องว่างเปล่า เช่น หากคุณระบุ isNull
สำหรับคอลัมน์ keywordMaxCpc ในรายงานคีย์เวิร์ดรายงาน
จะมีเฉพาะคีย์เวิร์ดที่ไม่ได้ระบุ CPC สูงสุด
|
0 |
isNotNull |
คอลัมน์ต้องมีค่า | 0 |
startsWith |
คอลัมน์ต้องขึ้นต้นด้วยสตริงใดสตริงหนึ่งในรายการของตัวกรอง
ใช้ได้กับ |
เปลี่ยนแปลงได้ |
containsSubstring |
คอลัมน์ต้องมีสตริงใดสตริงหนึ่งหรือบางส่วนที่ระบุไว้ในแท็ก ของตัวกรอง
เช่น ตัวกรอง
แต่จะไม่แสดงผลแถวที่มีค่าเหล่านี้
ใช้ได้กับ |
เปลี่ยนแปลงได้ |
doesNotContainSubstring |
คอลัมน์ต้องไม่มีสตริงใดๆ ในรายการของตัวกรอง
เช่น ตัวกรอง แต่จะไม่แสดงผลแถวที่มีค่าเหล่านี้
ใช้ได้กับ |
เปลี่ยนแปลงได้ |
containsElement |
คอลัมน์ต้องมีค่าอย่างน้อย 1 ค่าในรายการของตัวกรอง
ใช้ได้กับคอลัมน์ที่มีประเภทข้อมูลรายการ (เช่น
ตัวอย่างเช่น ในรายงาน |
เปลี่ยนแปลงได้ |