Tích hợp Google Search Console

Kết nối Google Search Console (GSC) với KTHSEO để lấy dữ liệu performance thực tế — hỗ trợ Content Refresh và theo dõi hiệu quả SEO.

Google Search Console là gì?

Google Search Console (GSC) là công cụ miễn phí của Google, cho bạn biết:

🔑

Keywords

Website xuất hiện cho keyword nào trên Google Search

👁️

Impressions

Mỗi keyword có bao nhiêu lượt hiển thị trên SERP

🖱️

Clicks & CTR

Bao nhiêu click và tỷ lệ click-through cho mỗi query

📊

Position

Vị trí trung bình trên trang kết quả tìm kiếm Google

Điều kiện cần

Trước khi kết nối, đảm bảo bạn có:

1
Tài khoản Google đã xác minh website

Đăng ký và verify website tại Google Search Console

2
Google Cloud Project + OAuth Client ID

Tạo project trên Google Cloud Console, bật Search Console API, tạo OAuth credentials.

ℹ️ Chưa có Google Cloud Project? Đọc hướng dẫn chi tiết: Tạo Google Cloud Project & OAuth — hướng dẫn từng bước tạo project, bật API, cấu hình OAuth consent screen, thêm test users và publish app.

Kết nối GSC với KTHSEO

1
Nhập Client ID / Secret

Mở KTHSEO Desktop → Cài đặt (⚙️) → tab API Keys → mục Google Search Console → điền Client ID và Client Secret → Lưu.

123456789-xxx.apps.googleusercontent.com
2
Xác thực tài khoản Google

Click Xác thực → trình duyệt mở trang đăng nhập Google → chọn tài khoản có quyền GSC → Allow.

⚠️ "Google hasn't verified this app" → Click Advanced → Go to KTHSEO (unsafe). App do bạn tạo, hoàn toàn an toàn.
3
Chọn Property (website)

KTHSEO hiển thị danh sách properties → chọn website đang làm SEO → Xác nhận.

💡 Loại property: Domain property (example.com) bao gồm tất cả subdomain — nên chọn nếu có. URL prefix (https://www.example.com) chỉ bao gồm prefix cụ thể.
4
Liên kết với dự án

Mở dự án → Cài đặt dự án → tab GSC → chọn Property đã kết nối → Lưu. Data GSC bắt đầu hiển thị!

Xem dữ liệu GSC trong KTHSEO

Sau khi kết nối, mở dự án → chọn tab Search Console:

Performance Overview

🖱️ Total Clicks

Tổng số click từ Google Search trong khoảng thời gian chọn.

👁️ Total Impressions

Tổng số lượt hiển thị trên SERP. Impressions cao + clicks thấp = cần optimize title.

📈 Avg. CTR

Tỷ lệ click-through trung bình. CTR > 3-5% = tốt. CTR < 1% = cần cải thiện.

📊 Avg. Position

Vị trí trung bình. 1-3 = top 3. 4-10 = trang 1. 11-20 = trang 2, cần push lên.

Top Queries & Top Pages

🔑 Top Queries (Keyword)

Danh sách keyword website đang rank, sắp xếp theo clicks:

  • Impressions cao + position > 10 → cơ hội lớn
  • Impressions cao + CTR thấp → cải thiện title/meta
  • Position 4-10 → gần top 3, cần bổ sung content

📄 Top Pages (Trang)

Nhóm theo URL trang — phát hiện:

  • Trang nào đem nhiều traffic nhất
  • Trang nào nhiều impressions nhưng ít clicks
  • Trang nào đang giảm thứ hạng

Content Refresh với GSC

Tính năng mạnh nhất khi kết hợp GSC với KTHSEO. Data GSC tự động được sử dụng trong Content Refresh:

📊
Data GSC

Clicks, impressions, position của từng bài viết

🔍
KTHSEO phân tích

Bài nào cần refresh? Dựa trên position giảm, CTR thấp, impressions cao

🤖
AI đề xuất

Thêm gì, sửa gì, bỏ gì? AI phân tích gaps và đề xuất cải thiện

Review & xác nhận

Bạn review đề xuất → chấp nhận hoặc chỉnh sửa

🚀
Update lên website

Publish bài đã refresh → theo dõi kết quả sau 2-4 tuần

Tiêu chí refresh

Tín hiệuNgưỡngHành động
Position giảmGiảm > 5 vị tríRefresh nội dung, thêm keyword mới
CTR thấp< 1% với position < 10Tối ưu title + meta description
Impressions cao> 1000 nhưng clicks < 50Cải thiện content + thêm featured snippet
Position 4-10Gần top 3Bổ sung nội dung chuyên sâu

Xử lý lỗi thường gặp

LỗiNguyên nhânCách khắc phục
Access deniedApp ở chế độ Testing, email chưa thêm Test usersThêm email vào Test users hoặc Publish App
No properties foundTài khoản Google chưa verify website trên GSCĐăng ký website tại search.google.com/search-console
Token expiredApp chưa publish, token hết hạn sau 7 ngàyPublish App trên Google Cloud Console
Quota exceededVượt giới hạn API callsĐợi 24h hoặc tăng quota trong Cloud Console

Lưu ý quan trọng

ℹ️ Đặc điểm data GSC:
• Data GSC có 3 ngày delay — dữ liệu hôm nay sẽ có sau 3 ngày
• KTHSEO cache data 24 giờ — click Refresh để lấy data mới nhất
• Search Console API hoàn toàn miễn phí, không giới hạn quota thông thường
• Data chỉ bao gồm traffic từ Google Search (không gồm Ads, social, direct)
✅ Best Practices:
• Kết nối GSC ngay khi bắt đầu dự án — càng sớm càng có nhiều data
• Kiểm tra data hàng tuần — phát hiện sớm bài viết sụt giảm
• Dùng Content Refresh mỗi 3-6 tháng cho bài quan trọng
Publish App trên Google Cloud để token không hết hạn mỗi 7 ngày