Trong kỷ nguyên tìm kiếm hiện đại, website không chỉ là nơi cung cấp thông tin tĩnh mà còn phải trở thành một nền tảng tương tác trực tiếp. Sự chuyển dịch từ trạng thái “chỉ đọc” sang “có thể thực thi” đòi hỏi các quản trị viên web phải sử dụng các kỹ thuật cấu trúc dữ liệu nâng cao để giao tiếp hiệu quả với công cụ tìm kiếm. Trong đó, thuộc tính potentialAction đóng vai trò như một chiếc chìa khóa kỹ thuật quan trọng, giúp định hình cách người dùng và các hệ thống AI tương tác với nội dung trên trang.
Khái niệm thuộc tính potentialAction trong Schema.org
potentialAction là một thuộc tính trong Schema.org dùng để mô tả một hành động tiềm năng (như tìm kiếm, mua hàng, đặt chỗ) mà người dùng hoặc các tác vụ AI có thể thực hiện trực tiếp trên đối tượng hoặc trang web đó.

Trong cấu trúc dữ liệu, mọi thứ đều bắt đầu từ một thực thể tĩnh (Thing). Khi bạn muốn khai báo rằng thực thể này có thể tiếp nhận một hành động cụ thể, bạn sẽ sử dụng thuộc tính potentialAction. Thuộc tính này đóng vai trò là cầu nối giữa đối tượng và hành động (Action), đồng thời chỉ định rõ điểm truy cập (EntryPoint) nơi hành động đó được thực thi. Việc hiểu rõ cơ chế này cũng quan trọng tương tự như việc nắm bắt Ý nghĩa của DefinedTerm trong cấu trúc dữ liệu nhằm xây dựng một hệ thống dữ liệu ngữ nghĩa chặt chẽ cho website.
Các loại Action phổ biến sử dụng thuộc tính potentialAction
Thuộc tính này có thể kết hợp với nhiều loại Action khác nhau để phục vụ các mục đích tương tác đa dạng, từ tìm kiếm thông tin cơ bản đến các giao dịch thương mại phức tạp.
Dưới đây là bảng tóm tắt các loại Action thường được triển khai nhất:
|
Loại Action |
Mục đích sử dụng |
Trang áp dụng phù hợp |
Lợi ích hiển thị / Tương tác |
|
SearchAction |
Tìm kiếm nội dung trực tiếp trên website |
Trang chủ (Homepage) |
Kích hoạt Sitelinks Searchbox trên Google SERP |
|
BuyAction |
Thực hiện hành động mua sắm |
Trang chi tiết sản phẩm |
Giúp AI hiểu quy trình mua hàng trực tiếp |
|
ReserveAction |
Đặt chỗ, đặt lịch hẹn trực tuyến |
Trang dịch vụ, nhà hàng, khách sạn |
Tạo điểm chạm đặt lịch nhanh chóng |
|
ViewAction |
Xem nội dung, video, tài liệu |
Trang bài viết, video, tài liệu |
Khuyến khích tiêu thụ nội dung đa phương tiện |
SearchAction tối ưu hộp tìm kiếm
SearchAction là hành động tìm kiếm trực tiếp trên website từ trang kết quả của Google. Đây là ứng dụng phổ biến nhất của potentialAction trong SEO thực chiến.
Khi được cấu hình đúng, SearchAction giúp kích hoạt tính năng Sitelinks Searchbox (Hộp tìm kiếm liên kết trang web). Để tính năng này hoạt động, bạn cần khai báo chính xác thuộc tính urlTemplate, chỉ định rõ đường dẫn URL sẽ xử lý truy vấn tìm kiếm của người dùng khi họ nhập từ khóa vào hộp tìm kiếm trên Google.
BuyAction và ReserveAction cho thương mại điện tử
BuyAction và ReserveAction định nghĩa các điểm tương tác giao dịch trực tiếp trên trang sản phẩm hoặc dịch vụ.
Thay vì chỉ cung cấp thông tin sản phẩm tĩnh, việc khai báo BuyAction giúp các công cụ tìm kiếm và AI Agents nhận diện được luồng mua hàng. Khi kết hợp với Thuộc tính priceCurrency trong Schema Markup, hệ thống không chỉ hiểu được giá trị giao dịch mà còn biết chính xác URL nào sẽ đưa người dùng đến giỏ hàng hoặc trang thanh toán. Tương tự, ReserveAction cực kỳ hữu ích cho các doanh nghiệp dịch vụ muốn tối ưu hóa luồng đặt lịch hẹn tự động.
Vai trò quan trọng của potentialAction trong SEO và AI Search
potentialAction giúp tăng tỷ lệ nhấp chuột (CTR) thông qua các kết quả phong phú (Rich Results) và chuẩn bị cho website khả năng tương tác sâu hơn với các hệ thống AI Search.

Đối với SEO truyền thống, lợi ích lớn nhất của thuộc tính này là khả năng chiếm lĩnh diện tích hiển thị trên trang kết quả tìm kiếm (SERP). Một Sitelinks Searchbox nổi bật không chỉ thu hút sự chú ý của người dùng mà còn giúp họ bỏ qua các bước điều hướng trung gian, đi thẳng đến nội dung mong muốn trên website của bạn.
Trong bối cảnh AI Search (AEO/GEO) đang phát triển mạnh mẽ, potentialAction đóng vai trò như một “Public API” cho các AI Bot. Các trợ lý ảo không chỉ đọc nội dung mà còn cần biết cách thực thi tác vụ thay cho người dùng. Bằng cách khai báo rõ ràng các hành động tiềm năng, kết hợp với Cách khai báo đối tượng Seller để củng cố uy tín thương hiệu, website của bạn sẽ trở nên thân thiện hơn với AI, tăng cơ hội được hệ thống hiểu đúng ngữ cảnh và trích xuất thông tin chính xác.
Hướng dẫn khai báo potentialAction Schema chuẩn JSON-LD
Sử dụng định dạng JSON-LD được Google khuyến nghị là cách tốt nhất để khai báo thuộc tính potentialAction một cách chính xác, an toàn và dễ bảo trì.
Cấu trúc cơ bản của một đoạn mã JSON-LD chứa potentialAction thường bao gồm đối tượng chính (ví dụ: WebSite), thuộc tính potentialAction, loại hành động (ví dụ: SearchAction), và đối tượng mục tiêu (target) chứa EntryPoint. Trong đó, urlTemplate định nghĩa cấu trúc URL tìm kiếm, và query-input xác định tham số bắt buộc phải truyền vào.
Mẫu code JSON-LD cho Sitelinks Searchbox
Đoạn mã mẫu dưới đây giúp khai báo hộp tìm kiếm trang web chuẩn Google dành cho trang chủ.
{ “@context”: “https://schema.org”, “@type”: “WebSite”, “name”: “Tên Website Của Bạn”, “url”: “https://example.com/”, “potentialAction”: { “@type”: “SearchAction”, “target”: { “@type”: “EntryPoint”, “urlTemplate”: “https://example.com/search?q={search_term_string}” }, “query-input”: “required name=search_term_string” }
}
Khi áp dụng đoạn mã này, bạn cần thay thế https://example.com/ bằng URL trang chủ của bạn và điều chỉnh tham số search?q= sao cho khớp với cấu trúc URL tìm kiếm thực tế trên hệ thống mã nguồn website đang sử dụng.
Quy trình triển khai và kiểm tra lỗi Schema potentialAction
Quy trình triển khai chuẩn bao gồm việc xác định đúng loại hành động, viết mã JSON-LD, chèn vào mã nguồn và xác minh bằng các công cụ kiểm tra chính thức của Google.

Xác định loại Action phù hợp
Lựa chọn Action dựa trên mục đích của từng trang cụ thể trên website để đảm bảo tính logic của dữ liệu cấu trúc.
Trang chủ là nơi lý tưởng nhất để đặt SearchAction vì nó đại diện cho toàn bộ trang web. Ngược lại, các trang chi tiết sản phẩm nên tập trung vào BuyAction, trong khi các trang bài viết blog có thể không cần khai báo potentialAction nếu không có hành động tương tác đặc thù nào ngoài việc đọc.
Kiểm tra bằng công cụ Rich Results Test
Sử dụng công cụ chính thức của Google để xác minh tính hợp lệ của Schema trước khi xuất bản lên môi trường thực tế.
Bạn có thể truy cập công cụ Kiểm tra kết quả phong phú (Rich Results Test), dán trực tiếp đoạn mã JSON-LD hoặc nhập URL trang web đã cài đặt mã. Công cụ sẽ phân tích và trả về kết quả hợp lệ hoặc hiển thị các cảnh báo lỗi chi tiết. Việc này giúp đảm bảo bot tìm kiếm có thể thu thập dữ liệu mà không gặp rào cản kỹ thuật.
Các lỗi thường gặp khi cấu hình potentialAction và cách khắc phục
Các lỗi phổ biến nhất khi triển khai thuộc tính này thường liên quan đến sai cú pháp JSON hoặc cấu hình không khớp tham số trong urlTemplate.
- Lỗi cú pháp JSON-LD: Thiếu dấu phẩy giữa các thuộc tính, thiếu dấu ngoặc nhọn đóng/mở, hoặc sử dụng sai loại dấu ngoặc kép. Cách khắc phục là luôn chạy mã qua Schema Markup Validator trước khi lưu.
- Lỗi cấu hình sai tham số query-input: Tên biến trong query-input (ví dụ: search_term_string) phải khớp hoàn toàn với chuỗi biến nằm trong dấu ngoặc nhọn của urlTemplate. Nếu sai lệch, hộp tìm kiếm sẽ không thể truyền dữ liệu từ khóa.
- Lỗi đặt sai vị trí trang: Khai báo SearchAction trên mọi trang con thay vì chỉ đặt ở trang chủ. Điều này làm loãng tín hiệu và khiến Google khó xác định đâu là điểm truy cập tìm kiếm chính của toàn bộ website.
Giải đáp thắc mắc về thuộc tính potentialAction
Dưới đây là giải đáp cho những câu hỏi phổ biến nhất về việc triển khai và tối ưu hóa thuộc tính potentialAction trong thực tế.
Khai báo potentialAction có bắt buộc đối với mọi website không?
Không bắt buộc, nhưng cực kỳ khuyến khích đối với các website có lượng tìm kiếm thương hiệu lớn hoặc các trang thương mại điện tử muốn tối ưu hóa trải nghiệm người dùng và chuẩn bị dữ liệu cho AI Search. Nó là một điểm cộng lớn về mặt Technical SEO.
Tại sao cài đặt SearchAction nhưng Google không hiển thị hộp tìm kiếm?
Google sử dụng thuật toán tự động để quyết định có hiển thị Sitelinks Searchbox hay không. Quyết định này dựa trên độ uy tín của thương hiệu, lượng truy vấn tìm kiếm thương hiệu và cấu trúc website. Việc khai báo Schema chỉ là điều kiện cần, không phải là yếu tố đảm bảo hiển thị 100%.
Có thể khai báo nhiều potentialAction trên cùng một trang không?
Có, một đối tượng (Thing) có thể có nhiều hành động tiềm năng khác nhau. Ví dụ, một trang chi tiết về bộ phim vừa có thể cung cấp hành động xem trailer (ViewAction) vừa có thể cung cấp hành động mua vé (BuyAction). Tuy nhiên, cần đảm bảo các Action được khai báo logic và không gây xung đột.

potentialAction có ảnh hưởng trực tiếp đến thứ hạng từ khóa không?
Thuộc tính này không phải là yếu tố xếp hạng trực tiếp giúp đẩy từ khóa lên top. Tuy nhiên, nó có tác động gián tiếp cực kỳ mạnh mẽ thông qua việc tăng tỷ lệ nhấp chuột (CTR) từ SERP và giúp các công cụ tìm kiếm hiểu rõ thực thể website, từ đó phân phối nội dung đến đúng đối tượng hơn.
Làm thế nào để kiểm tra xem Schema potentialAction đã hoạt động chính xác chưa?
Bạn nên sử dụng công cụ Kiểm tra kết quả phong phú (Rich Results Test) hoặc Schema Markup Validator chính thức của Schema.org. Chỉ cần dán URL hoặc mã code vào, hệ thống sẽ báo cáo chi tiết về tính hợp lệ của cú pháp và các thuộc tính đi kèm.
Nếu bạn gặp khó khăn trong việc cấu hình Schema phức tạp hoặc cần một chiến lược tối ưu Technical SEO toàn diện, đội ngũ chuyên gia tại V4SEO luôn sẵn sàng tư vấn và cung cấp các giải pháp kỹ thuật chuẩn xác nhất.