Plugin Google Analytics trong PolyCMS cho RISE CRM
Plugin Google Analytics tích hợp sẵn giúp kết nối giao diện công khai của PolyCMS cho RISE CRM với hệ thống đo lường Google Analytics 4 (GA4), đồng thời vận hành bộ đếm lượt xem bài viết cục bộ ngay trong cơ sở dữ liệu CRM của bạn. Plugin tự động loại trừ các phiên truy cập của nhân sự và quản trị viên RISE CRM đã đăng nhập để giữ số liệu sạch, đồng thời bổ sung widget Top Performing Posts ngay trên màn hình PolyCMS Dashboard.
Các tính năng chính
- Tích hợp Google Analytics 4 (GA4): Tự động chèn đoạn mã bất đồng bộ
gtag.jsvào vùng <head> của trang ngoài thông qua hookpolycms_headngay khi bạn khai báo Measurement ID. - Tự động loại trừ lưu lượng nội bộ: Bỏ qua cả việc nhúng mã GA4 lẫn cộng lượt xem cục bộ đối với nhân viên và quản trị viên RISE CRM đang đăng nhập, tránh làm sai lệch báo cáo truy cập khi kiểm duyệt bài viết.
- Bộ đếm lượt xem bài viết cục bộ: Lưu lượt xem theo từng phiên (session) của mọi bài viết đã xuất bản vào bảng dữ liệu riêng (
{prefix}polycms_post_views), ngăn tình trạng tải lại trang nhiều lần làm tăng ảo lượt xem. - Widget bài viết nổi bật trên Dashboard: Hiển thị trực tiếp khối Top Performing Posts trong PolyCMS > Dashboard, liệt kê 5 bài viết xuất bản có lượt xem cao nhất kèm liên kết mở nhanh trình soạn thảo.
Kích hoạt plugin
- Trong trang quản trị RISE CRM, đi tới PolyCMS > Plugins.
- Tìm plugin Google Analytics trong danh sách và nhấn Activate.
- Khi kích hoạt, PolyCMS tự động khởi tạo bảng InnoDB
{prefix}polycms_post_viewsvà thêm lối tắt Google Analytics vào nhóm menu PolyCMS ở thanh bên trái. - Nhấn Settings trên thẻ plugin hoặc truy cập trực tiếp PolyCMS > Google Analytics (
/polycms/plugins/settings/google-analytics).
Cấu hình mã đo lường GA4
Để kết nối website với Google Analytics 4, bạn cần lấy mã Measurement ID có định dạng G-XXXXXXXXXX:
- Đăng nhập vào Google Analytics.
- Đi tới Admin > Data Streams > Web và chọn luồng dữ liệu website của bạn.
- Sao chép giá trị Measurement ID (
G-XXXXXXXXXX). - Quay lại trang cấu hình Google Analytics trong RISE CRM và dán mã vào ô Google Analytics Measurement ID.
- Nhấn Save Settings.
Khung Status bên phải sẽ chuyển ngay từ Not Configured sang Active kèm mã Measurement ID đang hoạt động.
Cơ chế ghi nhận dữ liệu ngoài giao diện
Khi khách truy cập mở một trang công khai trên PolyCMS, plugin thực thi hai lớp đo lường song song:
| Lớp đo lường | Hook / Cơ chế | Cách hoạt động |
|---|---|---|
| Thẻ toàn trang GA4 | polycms_head (ưu tiên 5) |
Xuất thẻ nạp googletagmanager.com/gtag/js và lệnh gtag('config', 'G-XXXXXXXXXX') trong vùng <head> chỉ dành cho khách truy cập bên ngoài. |
| Bộ đếm lượt xem cục bộ | polycms_single_post_view |
Tăng cột views và cập nhật last_viewed_at trong bảng {prefix}polycms_post_views tối đa một lần cho mỗi phiên đọc (ga_viewed_{post_id}). |
Nhờ thuộc tính async trong vùng <head>, mã theo dõi GA4 không làm chậm quá trình dựng giao diện mà vẫn ghi nhận chính xác lượt xem trang ngay trước khi độc giả chuyển trang.
Sử dụng Widget Top Performing Posts trên Dashboard
Sau khi kích hoạt plugin, hãy mở PolyCMS > Dashboard (/polycms/dashboard) để theo dõi widget Top Performing Posts. Widget tự động truy vấn các bài viết đã xuất bản kết hợp bảng {prefix}polycms_post_views để hiển thị:
- Danh sách 5 bài viết xuất bản đạt lượt xem cao nhất theo thứ tự giảm dần.
- Liên kết trực tiếp mở màn hình chỉnh sửa từng bài viết (
/polycms/posts/edit/{id}). - Số lượt xem cục bộ hoạt động độc lập ngay cả khi bạn chưa cấu hình GA4 Measurement ID.
Hàm hỗ trợ cho nhà phát triển Theme
Nếu bạn đang tùy biến hoặc xây dựng theme PolyCMS riêng, bạn có thể hiển thị lượt xem cục bộ hoặc danh sách bài viết đọc nhiều ngay trong template bằng các hàm helper có sẵn của plugin:
<?php
// Hiển thị tổng lượt xem cục bộ của một bài viết
if (function_exists('ga_plugin_get_views')) {
echo number_format(ga_plugin_get_views($post->id)) . ' lượt xem';
}
// Lấy danh sách 10 bài viết xuất bản có lượt xem cao nhất
if (function_exists('ga_plugin_get_top_posts')) {
$top_posts = ga_plugin_get_top_posts(10);
}
Kiểm tra và xác thực hoạt động
Vì các lượt truy cập từ tài khoản nhân sự RISE CRM đang đăng nhập luôn được loại trừ, hãy kiểm tra trên một phiên trình duyệt ẩn danh:
- Mở cửa sổ ẩn danh (Incognito/Private) chưa đăng nhập RISE CRM.
- Truy cập một bài viết đã xuất bản trên giao diện công khai của PolyCMS.
- Mở View Page Source (Xem nguồn trang) và tìm mã
G-XXXXXXXXXXbên trong vùng <head>. - Kiểm tra mục Reports > Realtime trên Google Analytics để xác nhận phiên truy cập đang được ghi nhận.
- Quay lại PolyCMS > Dashboard trong cửa sổ quản trị và kiểm tra bài viết vừa xem đã hiển thị trong widget Top Performing Posts.
Tài liệu liên quan
- Quản lý Plugins trong PolyCMS - Kích hoạt, tắt và cấu hình các plugin tích hợp hoặc plugin tùy biến.
- Bảng điều khiển và Phân tích PolyCMS - Khám phá toàn bộ chỉ số và widget trên PolyCMS Dashboard.
- Hướng dẫn cấu hình SEO - Kết hợp tối ưu công cụ tìm kiếm cùng đo lường lưu lượng truy cập.