รายงานที่กรอง

Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว โดย API ใหม่นี้จะช่วยเพิ่มความยืดหยุ่นในการสร้างรายงานที่กำหนดเองและผสานรวมข้อมูลเข้ากับแอปพลิเคชันและกระบวนการรายงาน ดูข้อมูลเพิ่มเติมเกี่ยวกับการย้ายข้อมูลรวมถึงการใช้ Search Ads 360 Reporting API เวอร์ชันใหม่

โดยค่าเริ่มต้น รายงานจะมีข้อมูลทั้งหมดภายใน 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	คอลัมน์ดังกล่าวต้องตรงกับค่าใดค่าหนึ่งในรายการของตัวกรองทุกประการ ใช้กับประเภทข้อมูลแบบรายการ (เช่น String list) ไม่ได้	ตัวแปร
lessThan	คอลัมน์ต้องมีค่าที่น้อยกว่าค่าที่ระบุ หากคุณระบุตัวกรองนี้สำหรับคอลัมน์ Boolean ระบบของ Search Ads 360 API จะแปลง false เป็นค่าตัวเลขที่ 0 และ true เป็น 1 หากคุณระบุตัวกรองนี้สำหรับคอลัมน์ String API จะเปรียบเทียบลำดับแบบพจนานุกรม ใช้กับประเภทข้อมูลแบบรายการ (เช่น String list) ไม่ได้	1
greaterThan	คอลัมน์ต้องมีค่าที่มากกว่า 1 ค่าในรายการของตัวกรอง หากคุณระบุตัวกรองนี้สำหรับคอลัมน์ Boolean แล้ว API จะแปลง false เป็นค่าตัวเลขของ 0 และ true เป็น 1 หากคุณระบุตัวกรองนี้สำหรับคอลัมน์ String API จะเปรียบเทียบลำดับแบบพจนานุกรม ใช้กับประเภทข้อมูลแบบรายการ (เช่น String list) ไม่ได้	1
lessThanOrEqual	คอลัมน์ต้องมีค่าที่น้อยกว่าหรือเท่ากับค่าใดค่าหนึ่งในรายการของตัวกรอง หากคุณระบุตัวกรองนี้สำหรับคอลัมน์ Boolean แล้ว API จะแปลง false เป็นค่าตัวเลขของ 0 และ true เป็น 1 หากคุณระบุตัวกรองนี้สำหรับคอลัมน์ String API จะเปรียบเทียบลำดับแบบพจนานุกรม ใช้กับประเภทข้อมูลแบบรายการ (เช่น String list) ไม่ได้	1
greaterThanOrEqual	คอลัมน์ต้องมีค่าที่มากกว่าหรือเท่ากับค่าใดค่าหนึ่งในรายการของตัวกรอง หากคุณระบุตัวกรองนี้สำหรับคอลัมน์ Boolean แล้ว API จะแปลง false เป็นค่าตัวเลขของ 0 และ true เป็น 1 หากคุณระบุตัวกรองนี้สำหรับคอลัมน์ String API จะเปรียบเทียบลำดับแบบพจนานุกรม ใช้กับประเภทข้อมูลแบบรายการ (เช่น String list) ไม่ได้	1
isNull	คอลัมน์ต้องว่างเปล่า ตัวอย่างเช่น หากคุณระบุ isNull สำหรับคอลัมน์ keywordMaxCpc ในรายงานคีย์เวิร์ด รายงานจะมีเฉพาะคีย์เวิร์ดที่ไม่ได้ระบุ CPC สูงสุด	0
isNotNull	คอลัมน์ดังกล่าวต้องมีค่า	0
startsWith	คอลัมน์ต้องขึ้นต้นด้วยสตริงใดสตริงหนึ่งในรายการของตัวกรอง ใช้ได้กับ String คอลัมน์เท่านั้น	ตัวแปร
containsSubstring	คอลัมน์ต้องมีสตริงทั้งหมดหรือบางส่วนที่ระบุในรายการของตัวกรอง ตัวอย่างเช่น ตัวกรอง containsSubstring ที่มีค่าต่อไปนี้ ["ham", "cheese"] จะแสดงแถวที่มีค่านี้: hamburger cheeseburger แต่จะไม่แสดงแถวที่มีค่าเหล่านี้ lobster roll lettuce high amplitude (high amplitude มี สตริงย่อย "h am" แต่อักขระทั้งหมดรวมถึงช่องว่างจะได้รับการประเมินโดยตัวกรอง) ใช้ได้กับ String คอลัมน์เท่านั้น	ตัวแปร
doesNotContainSubstring	คอลัมน์ต้องไม่มีสตริงใดๆ ในรายการของตัวกรอง ตัวอย่างเช่น ตัวกรอง doesNotContainSubstring ที่มีค่าดังนี้ ["ham", "cheese"] จะแสดงแถวที่มีค่านี้: lobster roll lettuce แต่จะไม่แสดงแถวที่มีค่าเหล่านี้ hamเบอร์เกอร์ cheeseเบอร์เกอร์ ใช้ได้กับ String คอลัมน์เท่านั้น	ตัวแปร
containsElement	คอลัมน์ต้องมีค่าอย่างน้อย 1 ค่าในรายการของตัวกรอง ใช้ได้เฉพาะกับคอลัมน์ที่มีประเภทข้อมูลแบบรายการ (เช่น String list) เช่น ในรายงาน campaign ตัวกรอง containsElement ที่มีค่าดังนี้ ["foo", "bar"] ที่กรองในคอลัมน์ effectiveLabels จะแสดงเฉพาะแคมเปญที่มีป้ายกำกับ foo, bar หรือทั้ง 2 แคมเปญ	ตัวแปร