=== Plugin WordPress AI Analytics ===
Contributors: hungtv6699
Tags: analytics, statistics, ai, privacy, vietnamese
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Thống kê AI truy cập WordPress, nội dung AI đọc và người dùng từ AI. Miễn phí, không cần tài khoản hay API key.

== Description ==
AI Analytics by ONTER đặt crawler AI, nội dung AI truy cập và người dùng đến từ AI làm trọng tâm. Dữ liệu người dùng và bot tìm kiếm dùng để so sánh; không trộn các nhóm. Giao diện tiếng Việt, dữ liệu tại website, không gửi raw analytics về Onter.vn.

Nhận diện dựa trên các tín hiệu có thể quan sát: User-Agent, referrer, UTM và IP chính thức khi có. User-Agent không phải bằng chứng tuyệt đối. Googlebot không được coi là Gemini; Bingbot không được coi là Copilot. Không thể biết AI dùng nội dung để trả lời câu hỏi nào.

Crawler được ghi phía máy chủ khi request tới WordPress. Full-page cache/CDN phục vụ trước WordPress nằm ngoài khả năng quan sát của plugin. Người dùng được ghi bằng JavaScript; REST bị chặn, chặn JavaScript hay từ chối tracking sẽ tạo khoảng trống.

Người truy cập là tổng mã trình duyệt ngẫu nhiên riêng biệt theo ngày, không phải danh tính hay số người riêng biệt xuyên ngày. Phiên hết hạn sau 30 phút không hoạt động. Thời lượng được ước tính từ hoạt động/heartbeat khi tab hiển thị. Gửi biểu mẫu là thao tác submit, không xác nhận máy chủ xử lý thành công.

== Installation ==
1. Tải ZIP và vào Plugin → Thêm plugin → Tải plugin lên.
2. Kích hoạt AI Analytics by ONTER.
3. Mở AI Analytics by ONTER → Tổng quan AI; điều chỉnh Cài đặt khi cần.

Không hỗ trợ Multisite trong phiên bản này; chặn kích hoạt trên Multisite. Hỗ trợ tiền tố bảng riêng, permalink và cài trong thư mục con. Role quản trị cần manage_options. Endpoint quản trị yêu cầu phiên và REST nonce.

== Frequently Asked Questions ==
= Có miễn phí không? =
Có, không có paywall, license server, tài khoản Onter hay API key.
= Có gửi dữ liệu khách về Onter.vn không? =
Không. Cron có tải danh sách IP công khai từ nhà cung cấp crawler; không gửi dữ liệu khách trong yêu cầu đó.
= Có biết mọi lượt AI không? =
Không. Chỉ nhận diện tín hiệu kỹ thuật quan sát được. Crawler chưa xác minh được ghi là có khả năng là AI.
= Có thay Google Analytics không? =
Tập trung thống kê đơn giản trong WordPress và quan sát lưu lượng AI; không định vị như bản sao Google Analytics.
= Vì sao crawler chưa được xác minh? =
Nhà cung cấp có thể không công bố IP; cron có thể chưa cập nhật, dữ liệu IP quá 48 giờ hoặc UA có thể giả mạo. Khi đó không gán nhãn đã xác minh.
= Có dùng cookie không? =
Tracker dùng sessionStorage cho phiên và localStorage cho mã ngẫu nhiên hết hạn sau 24 giờ. Không fingerprint. Nếu storage bị chặn, mã chỉ tồn tại trong lượt tải trang.
= Có opt-out không? =
Tôn trọng DNT và GPC. Có thể đặt window.onterAnalyticsOptOut=true trước tracker hoặc localStorage onter_analytics_optout=1. Dùng filter/consent manager để chỉ enqueue tracker khi phù hợp chính sách website.

== Screenshots ==
1. Tổng quan tiếng Việt với biểu đồ dữ liệu thật.
2. Lưu lượng AI tách người dùng đến từ AI và crawler AI.
3. Cài đặt lưu dữ liệu và loại trừ.

== Privacy ==
Không lưu IP đầy đủ, query string, nội dung biểu mẫu, mật khẩu, số điện thoại, email hay tên file tải lên. Referrer chỉ lưu hostname. UTM chỉ nhận slug ngắn, không thu query tùy ý. Trang riêng tư, preview, admin, tài khoản và người dùng đăng nhập bị loại trừ mặc định. Mã IP HMAC thay theo ngày chỉ dùng rate limit, dọn sau khi hết hạn. Không geolocation mặc định.

== Data storage ==
Bảng riêng theo tiền tố WordPress: onter_analytics_sessions, pageviews, events, bot_visits, daily_stats, visitors, limits. Chi tiết mặc định 90 ngày, có thể 30/180/365; tổng hợp giữ lâu hơn. Cleanup chạy hourly theo WP-Cron; crawler IP cập nhật daily. Dashboard dùng bảng tổng hợp theo ngày. Tối đa 366 ngày mỗi truy vấn, 50 hàng mỗi trang.

== Uninstall behavior ==
Deactivate luôn giữ dữ liệu. Gỡ plugin mặc định giữ dữ liệu để cài lại. Bật Xóa dữ liệu khi gỡ plugin trước khi uninstall nếu muốn xóa bảng/options. Có nút xóa dữ liệu kèm nhập xác nhận trong Cài đặt.

== Demo Mode ==
Dữ liệu minh hoạ chỉ ở JavaScript, không ghi DB hay gửi ingest. Badge và nút Quay lại dữ liệu thật luôn hiển thị. Demo không phải benchmark. Gemini/Copilot trong demo chỉ có referral; không giả crawler.

== Changelog ==
= 1.1.1 =
* Cải tổ AI-first: KPI/provider chart/cards/feed, nội dung AI đọc, referral, comparison và Demo Mode riêng.
* Không đổi tracking/schema/classification.
