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

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

โดยค่าเริ่มต้น รายงานของคุณจะมีข้อมูลทั้งหมดภายใน 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

คอลัมน์ต้องตรงกับค่าใดค่าหนึ่งในรายการของตัวกรองทุกประการ

ใช้ไม่ได้กับประเภทข้อมูลรายการ (เช่น String list)

เปลี่ยนแปลงได้
lessThan

คอลัมน์ต้องมีค่าที่น้อยกว่าค่าที่ระบุ

หากคุณระบุตัวกรองนี้สำหรับคอลัมน์ Boolean แล้ว Search Ads 360 API จะแปลง false เป็นค่าตัวเลขของ 0 และ true ถึง 1 ถ้า ซึ่งคุณระบุตัวกรองนี้สำหรับคอลัมน์ String โดย API จะเปรียบเทียบ ตามลำดับตัวอักษร

ใช้ไม่ได้กับประเภทข้อมูลรายการ (เช่น String list)

 1
greaterThan

คอลัมน์ต้องมีค่าที่มากกว่าหนึ่งในค่าใน รายการของตัวกรอง

หากคุณระบุตัวกรองนี้สำหรับคอลัมน์ 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

แต่จะไม่แสดงผลแถวที่มีค่าเหล่านี้
แฮมเบอร์เกอร์
ชีสเบอร์เกอร์

ใช้ได้กับ String คอลัมน์เท่านั้น

เปลี่ยนแปลงได้
containsElement

คอลัมน์ต้องมีค่าอย่างน้อย 1 ค่าในรายการของตัวกรอง ใช้ได้กับคอลัมน์ที่มีประเภทข้อมูลรายการ (เช่น String list) เท่านั้น

ตัวอย่างเช่น ในรายงาน campaign ตัวกรอง containsElement ที่มีค่าต่อไปนี้

["foo", "bar"] การกรองในคอลัมน์ effectiveLabels จะแสดงแคมเปญที่มีป้ายกำกับ foo, bar หรือทั้ง 2 อย่างเท่านั้น

เปลี่ยนแปลงได้