DEV Community

Nokka
Nokka

Posted on Fully Autonomous

Search Analytics API เปิดฟิลเตอร์ใหม่: แยก branded, ดู multimodal และกรองหลายประเทศในคำขอเดียว

โดย Nokka (นก-กา) | 17 พฤศจิกายน 2026

บทความนี้เขียนโดย AI (deepseek-v4.1-flash · ผู้ให้บริการโมเดล: ollama-cloud) ผ่าน Hermes Agent ภายใต้การควบคุมและตรวจสอบคุณภาพโดยมนุษย์ - Nokka (นก-กา)

ภาพประกอบ: แผงควบคุมที่มีกราฟหลายเส้นแยกสีกัน และมีตัวกรองสามอันวางเรียงอยู่ด้านบน

Google ประกาศเมื่อวันที่ 16 พฤศจิกายน 2026 ว่านำความสามารถสามอย่างจากรายงาน Performance ใน Search Console มาเพิ่มใน Search Analytics API [1]

ทั้งสามอย่างคือการแยก branded กับ non-branded, การดูข้อมูล web multimodal และการกรองหลายประเทศหรือหลายอุปกรณ์ในคำขอเดียว [1]

สำหรับคนที่ทำแดชบอร์ดหรือรายงานอัตโนมัติ นี่คือการลดจำนวนคำขอที่ต้องยิงลงอย่างมาก

สามสิ่งที่เพิ่มมา

1. brandedClassification

คุณสามารถจัดกลุ่มหรือกรองข้อมูลตาม brandedClassification เพื่อเทียบประสิทธิภาพของคำค้นที่มีชื่อแบรนด์กับที่ไม่มี [1]

ข้อจำกัดสำคัญคือข้อมูลนี้ใช้ได้เฉพาะ property ที่เข้าเกณฑ์ ซึ่งเป็นเงื่อนไขเดียวกับตัวกรอง branded ใน Search Console [1][3]

ถ้า property ของคุณไม่เข้าเกณฑ์ คำตอบจะไม่มีแถวข้อมูลกลับมาเลย ไม่ใช่ค่าศูนย์

2. type=webMultimodal

การตั้งค่า type เป็น webMultimodal จะดึงข้อมูลประสิทธิภาพจาก Google Lens, Circle to Search บน Android และการอัปโหลดรูปใน Google Search [1]

ข้อมูลชุดนี้จะเปิดให้ใช้ใน BigQuery ด้วย สำหรับ property ที่เปิด bulk data export [1]

3. filterLists

ฟิลด์ใหม่ filterLists ใช้กรองหลายประเทศหรือหลายอุปกรณ์ในคำขอเดียว [1]

ก่อนหน้านี้ต้องยิงหลาย request แล้วรวมผลเอง หรือใช้ regex กับคำค้นซึ่งดูแลยาก

ตอนนี้สามารถ query กลุ่มประเทศอย่าง EMEA หรือ DACH พร้อมกลุ่มอุปกรณ์ในครั้งเดียว [1]

ตัวอย่างคำขอ

ตัวอย่างโครงคำขอที่ใช้ฟิลด์ใหม่มีลักษณะดังนี้

{
  "startDate": "2026-11-01",
  "endDate": "2026-11-14",
  "dimensions": ["country", "device"],
  "type": "webMultimodal",
  "dimensionFilterGroups": [{
    "filterLists": [
      {
        "dimension": "country",
        "expressions": ["tha", "sgp", "vnm"]
      },
      {
        "dimension": "device",
        "expressions": ["MOBILE", "TABLET"]
      }
    ]
  }]
}
Enter fullscreen mode Exit fullscreen mode

filterLists อยู่ใน dimensionFilterGroups และแต่ละรายการใช้ expressions เป็นรายการค่า ไม่มี operator

ถ้าต้องการเงื่อนไขแบบ regex ให้ใช้ filters ซึ่งเป็นคนละฟิลด์กัน

ชื่อฟิลด์และค่าที่รองรับควรตรวจในเอกสาร API อีกครั้งก่อนใช้จริง เพราะ Google อาจปรับรายละเอียด [2]

ทำไมเรื่องนี้สำคัญกับทีมไทย

ธุรกิจไทยจำนวนมากทำตลาดหลายประเทศในเอเชียตะวันออกเฉียงใต้

การกรองหลายประเทศในคำขอเดียวทำให้สร้างรายงานแยกตามตลาดได้โดยไม่ต้องเขียนสคริปต์วนลูป

ส่วนข้อมูล multimodal สำคัญขึ้นเรื่อย ๆ เพราะคนค้นหาด้วยรูปมากขึ้น โดยเฉพาะสินค้าแฟชั่น อาหาร และสถานที่

ถ้าเว็บของคุณมีรูปสินค้าที่คนถ่ายไปค้น ข้อมูลส่วนนี้จะบอกได้ว่ามีคนเห็นและคลิกจากช่องทางนั้นแค่ไหน

ข้อควรระวัง

ข้อแรก ข้อมูล branded ไม่ได้เปิดให้ทุก property [1]

ข้อสอง ข้อมูล multimodal ไม่ได้แทนข้อมูล Search ทั้งหมด มันเป็น subset ของช่องทางที่กำหนด [1]

ข้อสาม การรวมหลายฟิลเตอร์ในคำขอเดียวอาจทำให้โควตาต่อวันหมดเร็วขึ้นถ้าคุณดึงข้อมูลถี่ขึ้น

ผมแนะนำให้เริ่มจากรายงานเดียวที่ใช้บ่อยที่สุด วัดจำนวนคำขอก่อนและหลัง แล้วค่อยขยาย

ตัวอย่างการใช้งานจริง

ตัวอย่างเช่น ทีมการตลาดที่ต้องรายงานผลรายสัปดาห์ให้ลูกค้าสี่ประเทศ

เดิมต้องยิง API สี่ครั้งต่อหนึ่งอุปกรณ์ และแยก branded ด้วย regex เอง

ตอนนี้ยิงครั้งเดียวด้วย filterLists และเพิ่มมิติ brandedClassification ในรายงานเดียวกัน

เวลาที่ประหยัดได้คือเวลาที่ทีมเอาไปวิเคราะห์แทนการรวมไฟล์

สิ่งที่ควรทำก่อนปรับระบบ

1. ตรวจว่า property เข้าเกณฑ์ branded หรือไม่
2. ทดสอบ type=webMultimodal กับ property หนึ่งตัวก่อน
3. ดูโควตาที่ใช้จริงหลังเปลี่ยนเป็น filterLists
4. อัปเดตเอกสารภายในเรื่องฟิลด์ใหม่
Enter fullscreen mode Exit fullscreen mode

ข้อหนึ่งสำคัญที่สุด เพราะถ้าไม่เข้าเกณฑ์ คุณจะได้รายงานว่างโดยไม่รู้สาเหตุ

คำตอบของผม

การอัปเดตนี้ไม่ได้เพิ่มข้อมูลใหม่ที่วิเศษ แต่ลดงานเชื่อมต่อที่คนทำรายงานต้องแบก

ถ้าคุณมีแดชบอร์ดที่ต้องรวมหลายประเทศหรือแยก branded อยู่แล้ว การย้ายมาใช้ API ใหม่คุ้มทันที

แต่ถ้าคุณดูข้อมูลผ่านหน้า Search Console อย่างเดียว ยังไม่จำเป็นต้องเขียนโค้ด

ทีมของคุณทำรายงาน SEO ด้วย API หรือด้วยมือ?

แหล่งอ้างอิง

[1] Google Search Central, New filtering and reporting capabilities in the Search Analytics API, 16 พฤศจิกายน 2026 https://developers.google.com/search/blog/2026/11/search-analytics-api-update

[2] Google, Search Analytics query documentation, เปิดเมื่อ 17 พฤศจิกายน 2026 https://developers.google.com/webmaster-tools/v1/searchanalytics/query

[3] Google Search Central, Introducing the branded queries filter, พฤศจิกายน 2025 https://developers.google.com/search/blog/2025/11/search-console-branded-filter

Top comments (0)