Hướng dẫn cấu hình tìm kiếm Google trên website
Cấu hình Programmable Search, Key và ResultsUrl trong CMS; phân biệt hai module tìm kiếm và lưu ý thay đổi phạm vi Google từ 2026.
Chức năng tìm kiếm này dùng để làm gì?
Tìm kiếm Google nhúng giúp người xem nhập từ khóa trên website và nhận kết quả do Programmable Search xử lý trong phạm vi được cấu hình. Nó khác chức năng tìm trực tiếp trong cơ sở dữ liệu của CMS: bài vừa lưu chưa chắc đã có ngay trong kết quả Google.
Bài này áp dụng khi template dùng các module GoogleSearch và GoogleSearchResult. Không mặc định ô tìm kiếm của mọi template, kể cả T99, đều đang dùng hai module này. Cần xác định module/skin thực tế trước khi chỉnh.
Thay đổi phạm vi dịch vụ cần biết
Theo cập nhật của Google, từ 20/01/2026, công cụ mới dùng phạm vi các website chỉ định, tối đa 50 tên miền. Công cụ cũ tìm trên toàn web có giai đoạn chuyển tiếp đến 01/01/2027; tắt tùy chọn toàn web thì không thể bật lại theo quy định cập nhật. Xem phạm vi website của Programmable Search.
Vì vậy, không tiếp tục hướng dẫn người mới bật tìm kiếm toàn bộ Internet như một lựa chọn luôn có sẵn. Nhu cầu tìm trong website doanh nghiệp vẫn phù hợp để cấu hình phạm vi website; cần rà lại các tích hợp cũ trước mốc chuyển tiếp thay vì kết luận mọi ô tìm kiếm Google đều đã ngừng hoạt động.
Giao diện quản lý Programmable Search
Mở công cụ tìm kiếm mà doanh nghiệp sở hữu hoặc tạo theo lựa chọn hiện được tài khoản cung cấp. Đặt tên nội bộ dễ nhận biết và khai báo website/phạm vi muốn tìm. Danh sách website là phạm vi kết quả được phép trả, không phải danh sách liên kết hiển thị trong menu CMS.
Lấy mã công cụ tìm kiếm, thường được dùng trong tham số cx của mã nhúng. Mã này nhận diện công cụ và phạm vi tìm; nó không phải API key Google Maps, không phải mã xác minh Search Console và không phải mật khẩu tài khoản Google.
Trước khi đưa vào CMS, thử một từ khóa có nội dung đã được Google ghi nhận trong website. Nếu công cụ chưa có kết quả, kiểm tra phạm vi và nội dung được lập chỉ mục; sửa CSS của ô tìm không giải quyết được dữ liệu nguồn chưa được Google xử lý.
Giao diện module GoogleSearch - ô nhập tìm kiếm
Key
Nhập mã công cụ tìm kiếm. Trong các skin đang đối chiếu, giá trị Key được đưa vào URL tải script cse.js dưới tham số cx. Dán riêng mã, không dán toàn bộ thẻ script hoặc API key của dịch vụ khác.
ResultsUrl
Nhập đường dẫn trang hiển thị kết quả theo cấu trúc website đã cấu hình. Đây phải là trang người xem truy cập được và có module kết quả tương ứng; không nhập địa chỉ CMS hay trang không tồn tại.
Một ô nhập có giao diện đẹp nhưng ResultsUrl sai vẫn đưa người đọc tới trang lỗi. Kiểm tra bằng thao tác nhập từ khóa ngoài website sau khi lưu, không chỉ nhìn nội dung ô tham số trong CMS.
Giao diện module GoogleSearchResult - vùng kết quả
Module này đọc Key để sử dụng cùng công cụ tìm kiếm. Đặt Key thống nhất với ô tìm kiếm khi hai module phục vụ một luồng tìm. Không dùng mã của một website khác chỉ để làm vùng kết quả hiện lên.
Các skin GoogleSearch/GoogleSearchResult được đối chiếu dùng tên tham số truy vấn sq ở cả ô tìm và vùng kết quả. Hai phía cần khớp; nếu tự đổi thành q ở một phía mà phía còn lại vẫn đọc sq, trang có thể mở nhưng không nhận đúng từ khóa.
Vùng kết quả cần được gắn vào trang đúng với ResultsUrl. Module chỉ cung cấp dữ liệu và gọi công cụ, còn vị trí và bố cục do skin/template quyết định. Thay Key không tự tạo thêm một trang kết quả.
Quy trình cấu hình và kiểm tra
- Xác định template có dùng GoogleSearch/GoogleSearchResult hay một cơ chế tìm khác.
- Kiểm tra công cụ Google và phạm vi website, lấy đúng mã cx.
- Nhập Key ở cả hai module; nhập ResultsUrl ở module ô tìm.
- Kiểm tra trang kết quả đã gắn module và hai skin thống nhất tham số từ khóa.
- Lưu, xử lý cache đúng website nếu cần, rồi nhập một từ khóa có kết quả đã biết.
- Bấm tìm, đối chiếu URL trang kết quả, từ khóa và phạm vi các liên kết trả về.
- Thử thêm từ không có kết quả để kiểm tra người xem vẫn hiểu tình trạng và có thể đổi từ khóa.
Giải thích ảnh hưởng đến người xem
Key hoặc phạm vi công cụ sai có thể trả nội dung của website khác. ResultsUrl sai khiến điều hướng hỏng. Mã script bị chặn hoặc mạng không tải được dịch vụ có thể làm ô tìm/vùng kết quả không xuất hiện. Bài mới chưa có trên Google có thể chưa xuất hiện dù CMS đã bật Sử dụng.
Đây không phải công cụ tìm hàng tồn, đơn hàng hoặc dữ liệu riêng trong trang quản trị. Không cấu hình phạm vi để người xem truy cập dữ liệu nội bộ. Nếu doanh nghiệp cần kết quả ngay sau khi lưu bài, cần xem chức năng tìm trong dữ liệu website phù hợp thay vì kỳ vọng công cụ Google đồng bộ tức thời.
Rà soát tích hợp cũ
Ghi lại công cụ nào đang dùng tìm toàn web, người quản lý tài khoản và phương án chuyển phạm vi. Đối chiếu thông báo thay đổi sản phẩm tìm kiếm của Google khi bảo trì. Không gỡ một ô tìm vẫn phục vụ tốt phạm vi website chỉ vì đọc thông báo về một loại tích hợp khác.
