โดยค่าเริ่มต้น รายงานจะมีข้อมูลทั้งหมดภายใน reportScope ตามที่ระบุไว้ในคำขอของคุณ หากต้องการให้รายงานมีเฉพาะข้อมูลที่ตรงกับเกณฑ์ชุดหนึ่ง ให้เพิ่มตัวกรองอย่างน้อย 1 รายการลงในรายงาน ระบบจะแสดงเฉพาะแถวที่ตรงตามเกณฑ์ตัวกรองทั้งหมดเท่านั้น
เช่น คุณขอรายงานคีย์เวิร์ดทั้งหมดในเอเจนซีได้ จากนั้น คุณจะระบุตัวกรองเพื่อให้เฉพาะคีย์เวิร์ดที่มี 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 ค่าในรายการของตัวกรอง
หากคุณระบุตัวกรองนี้สำหรับคอลัมน์
ใช้กับประเภทข้อมูลแบบรายการ (เช่น |
1 |
lessThanOrEqual |
คอลัมน์ต้องมีค่าที่น้อยกว่าหรือเท่ากับค่าใดค่าหนึ่งในรายการของตัวกรอง
หากคุณระบุตัวกรองนี้สำหรับคอลัมน์
ใช้กับประเภทข้อมูลแบบรายการ (เช่น |
1 |
greaterThanOrEqual |
คอลัมน์ต้องมีค่าที่มากกว่าหรือเท่ากับค่าใดค่าหนึ่งในรายการของตัวกรอง
หากคุณระบุตัวกรองนี้สำหรับคอลัมน์
ใช้กับประเภทข้อมูลแบบรายการ (เช่น |
1 |
isNull |
คอลัมน์ต้องว่างเปล่า ตัวอย่างเช่น หากคุณระบุ isNull สำหรับคอลัมน์ keywordMaxCpc ในรายงานคีย์เวิร์ด รายงานจะมีเฉพาะคีย์เวิร์ดที่ไม่ได้ระบุ CPC สูงสุด
|
0 |
isNotNull |
คอลัมน์ดังกล่าวต้องมีค่า | 0 |
startsWith |
คอลัมน์ต้องขึ้นต้นด้วยสตริงใดสตริงหนึ่งในรายการของตัวกรอง
ใช้ได้กับ |
ตัวแปร |
containsSubstring |
คอลัมน์ต้องมีสตริงทั้งหมดหรือบางส่วนที่ระบุในรายการของตัวกรอง
ตัวอย่างเช่น ตัวกรอง
แต่จะไม่แสดงแถวที่มีค่าเหล่านี้
ใช้ได้กับ |
ตัวแปร |
doesNotContainSubstring |
คอลัมน์ต้องไม่มีสตริงใดๆ ในรายการของตัวกรอง
ตัวอย่างเช่น ตัวกรอง แต่จะไม่แสดงแถวที่มีค่าเหล่านี้
ใช้ได้กับ |
ตัวแปร |
containsElement |
คอลัมน์ต้องมีค่าอย่างน้อย 1 ค่าในรายการของตัวกรอง
ใช้ได้เฉพาะกับคอลัมน์ที่มีประเภทข้อมูลแบบรายการ (เช่น
เช่น ในรายงาน |
ตัวแปร |