Khi quản trị website và theo dõi Google Search Console, nhiều người làm SEO thường xuyên bắt gặp cảnh báo lỗi liên quan đến dữ liệu có cấu trúc WebSite. Một trong những câu hỏi phổ biến nhất là query-input là gì và làm thế nào để xử lý triệt để các cảnh báo thiếu trường dữ liệu này. Đặc biệt, với việc Google vừa có những thay đổi lớn về giao diện kết quả tìm kiếm vào cuối năm 2024, việc hiểu rõ bản chất của các đoạn mã Schema trở nên quan trọng hơn bao giờ hết để định hình chiến lược Technical SEO bền vững.
Khái niệm query-input trong Schema Markup
query-input là một thuộc tính kỹ thuật bắt buộc trong cấu trúc dữ liệu SearchAction (thuộc WebSite Schema). Thuộc tính này có nhiệm vụ khai báo cho các công cụ tìm kiếm biết tên của tham số truy vấn mà hệ thống tìm kiếm nội bộ của website sử dụng để xử lý từ khóa do người dùng nhập vào.
Nói một cách đơn giản, đây là cầu nối kỹ thuật giúp liên kết từ khóa mà người dùng gõ trên trang kết quả tìm kiếm (SERP) với công cụ tìm kiếm nội bộ của chính website đó. Khi được cấu hình đúng, nó từng là điều kiện cần để Google hiển thị hộp tìm kiếm Sitelinks Searchbox ngay dưới tên miền của bạn.
Cấu trúc hoạt động của SearchAction
SearchAction là một loại Schema mô tả hành động tìm kiếm được thực hiện trên một đối tượng hoặc website cụ thể. Trong cấu trúc này, có hai thành phần luôn phải đi liền và đồng bộ với nhau:
- target: Định nghĩa URL mẫu (URL template) của trang kết quả tìm kiếm nội bộ, bao gồm một biến giữ chỗ cho từ khóa.
- query-input: Định nghĩa chính xác tên của biến giữ chỗ đó (thường sử dụng định dạng PropertyValueSpecification) để hệ thống biết cần truyền dữ liệu vào đâu.
Sự khớp nối hoàn hảo giữa hai thành phần này giúp các bot tìm kiếm hiểu được cách website của bạn tiếp nhận và trả về kết quả truy vấn.
Cú pháp JSON-LD chuẩn cho thuộc tính query-input
Để khai báo query-input chính xác, bạn cần sử dụng định dạng JSON-LD và đặt mã này bên trong thẻ của trang chủ. Đây là định dạng được Google và Schema.org khuyến nghị sử dụng vì tính rõ ràng và dễ đọc đối với các trình thu thập dữ liệu.
Ví dụ đoạn mã JSON-LD hoàn chỉnh
Dưới đây là đoạn mã mẫu chuẩn hóa cho một website. Bạn cần thay thế tên miền và URL tìm kiếm thực tế của mình vào các trường tương ứng:
{ “@context”: “https://schema.org”, “@type”: “WebSite”, “name”: “V4SEO”, “url”: “https://reviewcourses.online/”, “potentialAction”: { “@type”: “SearchAction”, “target”: “https://reviewcourses.online/?s={search_term_string}”, “query-input”: “required name=search_term_string” }
}
Trong đoạn mã trên, required name=search_term_string chính là giá trị của thuộc tính query-input. Nó chỉ định rằng biến {search_term_string} nằm trong phần target là một tham số bắt buộc. Bên cạnh SearchAction, bạn cũng nên kết hợp Ứng dụng thuộc tính sameAs trong Schema Markup để định danh rõ ràng thực thể doanh nghiệp trên môi trường số, giúp hệ thống AI dễ hiểu nội dung hơn.
Cách xác định URL tìm kiếm nội bộ của website
Để điền đúng giá trị vào phần target, bạn cần biết cấu trúc URL tìm kiếm của website mình. Quá trình này rất đơn giản:
Truy cập vào trang chủ website của bạn và tìm thanh công cụ tìm kiếm nội bộ. Gõ một từ khóa thử nghiệm, ví dụ như chữ “test” và nhấn Enter.
Quan sát thanh địa chỉ trình duyệt. Nếu URL trả về có dạng https://domain.com/?s=test, bạn chỉ cần copy URL này, sau đó thay thế chữ “test” bằng biến {search_term_string}. Kết quả cuối cùng đưa vào Schema sẽ là https://domain.com/?s={search_term_string}.
Cập nhật quan trọng: Google khai tử Sitelinks Searchbox
Google đã chính thức ngừng hỗ trợ hiển thị hộp tìm kiếm Sitelinks Searchbox từ ngày 21 tháng 11 năm 2024. Đây là một thay đổi lớn đối với những người làm SEO đã quen thuộc với việc tối ưu hóa tính năng này trong nhiều năm qua.
Theo thông báo từ Google Search Central, việc gỡ bỏ này áp dụng trên toàn cầu cho mọi ngôn ngữ và quốc gia. Tuy nhiên, Google cũng khẳng định rằng việc giữ lại đoạn mã SearchAction trên website sẽ không gây ra bất kỳ lỗi phạt nào và không làm ảnh hưởng đến thứ hạng từ khóa hiện tại.
Lý do Google ngừng hỗ trợ hộp tìm kiếm
Nguyên nhân chính dẫn đến quyết định này là sự thay đổi trong hành vi tìm kiếm của người dùng. Dữ liệu của Google cho thấy lượng người dùng thực sự tương tác với hộp tìm kiếm Sitelinks Searchbox đã giảm mạnh. Người dùng hiện nay có xu hướng truy cập trực tiếp vào website hoặc sử dụng các truy vấn dài, cụ thể ngay trên thanh tìm kiếm chính của Google.
Ngoài ra, động thái này cũng nằm trong nỗ lực đơn giản hóa giao diện kết quả tìm kiếm (SERP) của Google. Thay vì cố gắng duy trì các tính năng cũ ít người dùng, các SEOer nên tập trung vào việc Tối ưu hóa nội dung theo thuật toán QDF để đáp ứng nhanh chóng các xu hướng tìm kiếm mới và mang lại giá trị thực tế cao hơn.
Có nên giữ lại Schema SearchAction và query-input?
Bạn không nhất thiết phải xóa bỏ đoạn mã này nếu nó đang hoạt động bình thường, nhưng cũng không cần đầu tư thêm thời gian để tối ưu hóa nó cho Google. Việc đưa ra quyết định giữ hay xóa phụ thuộc vào chiến lược kỹ thuật tổng thể của website.
Lợi ích đối với các công cụ tìm kiếm khác
Mặc dù Google không còn hiển thị Sitelinks Searchbox, các công cụ tìm kiếm khác như Bing hoặc Yahoo vẫn có thể sử dụng dữ liệu có cấu trúc này để hiểu rõ hơn về kiến trúc website của bạn. Schema.org là một tiêu chuẩn chung của toàn ngành, do đó việc khai báo đầy đủ các hành động (Action) vẫn mang lại giá trị ngữ nghĩa nhất định.
Vai trò trong kỷ nguyên Agentic Search và AI Bot
Trong kỷ nguyên của Agentic Search (tìm kiếm qua các tác tử AI), các mô hình ngôn ngữ lớn và AI Bot không chỉ đọc nội dung mà còn tìm cách tương tác với website thay cho người dùng. Dữ liệu cấu trúc hành động như SearchAction giúp các hệ thống AI hiểu được website có khả năng tiếp nhận truy vấn nội bộ.
Giữ lại mã nguồn sạch sẽ, chuẩn xác giúp hệ thống AI dễ hiểu nội dung hơn và thân thiện hơn với các công cụ AI Search trong tương lai.
Cách khắc phục các lỗi thường gặp liên quan đến query-input
Lỗi phổ biến nhất khiến Google Search Console cảnh báo “Missing field query-input” là do sự không đồng bộ tên biến giữa thuộc tính target và query-input. Dưới đây là cách kiểm tra và xử lý triệt để.
Sửa lỗi không đồng bộ tên biến
Tên biến nằm trong dấu ngoặc nhọn {} của thuộc tính target phải khớp hoàn toàn 100% với tên được khai báo trong query-input. Nếu target của bạn là /?s={search_term}, nhưng query-input lại khai báo là required name=search_term_string, công cụ kiểm tra sẽ báo lỗi ngay lập tức.
Sau khi khắc phục xong các lỗi kỹ thuật này và đảm bảo mã nguồn sạch, bạn có thể tập trung vào Cách phân tích báo cáo query hiệu quả từ công cụ tìm kiếm nội bộ để hiểu rõ hơn nhu cầu thực sự của người dùng khi họ duyệt web.
Sửa lỗi viết sai định dạng queryInput
Một số plugin SEO tự động tạo ra mã JSON-LD nhưng lại sử dụng định dạng camelCase là queryInput (viết liền, chữ I viết hoa). Theo tiêu chuẩn của Schema.org, cú pháp chính xác bắt buộc phải có dấu gạch ngang là query-input. Bạn cần can thiệp thủ công hoặc cập nhật plugin để sửa lại định dạng này.
|
Thuộc tính |
Cú pháp đúng |
Lỗi sai thường gặp |
Hậu quả / Cách khắc phục |
|
Tên biến (Variable) |
target: “…/?s={query}” |
target: “…/?s={query}” |
Hậu quả: Báo lỗi Missing field. |
|
Định dạng thuộc tính |
“query-input” |
“queryInput” |
Hậu quả: Trình xác thực không nhận diện được thuộc tính. |
Giải đáp thắc mắc về query-input và Sitelinks Searchbox
Dưới đây là những giải đáp chi tiết cho các vấn đề thường gặp nhất khi quản trị viên xử lý dữ liệu có cấu trúc WebSite.
Lỗi Missing field query-input có làm giảm thứ hạng website không
Không. Đây chỉ là một cảnh báo (warning) ở cấp độ tính năng nâng cao, không phải là lỗi nghiêm trọng (error) làm mất index trang. Nó không ảnh hưởng trực tiếp đến thứ hạng SEO tổng thể của website. Tuy nhiên, việc dọn dẹp các cảnh báo này giúp báo cáo Technical SEO của bạn sạch sẽ và dễ kiểm soát hơn.
Có nên xóa bỏ hoàn toàn Schema SearchAction khỏi website
Nếu đoạn mã của bạn đang bị lỗi cú pháp phức tạp và bạn không muốn mất thời gian sửa chữa, việc xóa bỏ hoàn toàn SearchAction là an toàn và không gây hậu quả tiêu cực. Tuy nhiên, hãy cẩn thận chỉ xóa phần potentialAction chứa SearchAction, tuyệt đối giữ lại các phần khai báo Site Name (tên trang web) vì Google vẫn đang hỗ trợ mạnh mẽ tính năng này.
Tại sao cài đặt đúng Schema nhưng không hiển thị hộp tìm kiếm trên Google
Như đã đề cập, Google đã chính thức khai tử tính năng Sitelinks Searchbox vào tháng 11 năm 2024. Do đó, dù bạn có cài đặt đúng 100% ở thời điểm hiện tại, hộp tìm kiếm này cũng sẽ không bao giờ xuất hiện trên SERP nữa. Trước đây, việc hiển thị cũng phụ thuộc hoàn toàn vào thuật toán của Google dựa trên độ uy tín thương hiệu và lượng truy vấn điều hướng.
Phân biệt thuộc tính query-input và queryInput trong Schema
query-input (có dấu gạch ngang) là thuộc tính chuẩn mực được Schema.org và Google chấp nhận trong cấu trúc JSON-LD. Trong khi đó, queryInput thường là lỗi phát sinh do thói quen viết code camelCase của lập trình viên hoặc do các thư viện tự động sinh mã cũ tạo ra.
Cách kiểm tra tính hợp lệ của Schema SearchAction
Vì Google đã ngừng hỗ trợ Sitelinks Searchbox, công cụ Rich Results Test của Google có thể không còn highlight chi tiết các lỗi liên quan đến phần này. Thay vào đó, bạn nên sử dụng công cụ Schema Markup Validator chính thức của Schema.org. Chỉ cần dán URL hoặc đoạn mã JSON-LD vào, công cụ sẽ phân tích và chỉ ra chính xác dòng code nào đang gặp vấn đề.
Nếu bạn gặp khó khăn trong việc rà soát lỗi cấu trúc dữ liệu hoặc cần một chiến lược Technical SEO toàn diện, đội ngũ chuyên gia tại V4SEO luôn sẵn sàng hỗ trợ kiểm tra và tối ưu hóa website của bạn đạt chuẩn kỹ thuật cao nhất.
