需解決:用戶標識生成、跨頁持久化、異步非阻塞上報、瀏覽器指紋補強。
const STAT_ID_NAME = 'vlstatId';
const STAT_ID_EXPIRE_DAYS = 365;
function genStatId() {
// 時間戳 + 隨機數 = 極低衝突概率
return `vlstat-${Date.now()}-${Math.round(Math.random() * 3e9)}`;
}
function getStatId() {
let statId = getCookie(STAT_ID_NAME);
if (!statId) {
statId = genStatId();
setCookie(STAT_ID_NAME, statId, STAT_ID_EXPIRE_DAYS);
}
return statId;
}
// Cookie 工具函數
function setCookie(name, value, days) {
const expires = new Date(Date.now() + days * 864e5).toUTCString();
document.cookie = `${name}=${encodeURIComponent(value)};expires=${expires};path=/;domain=cecb2b.com;SameSite=Lax`;
}
function getCookie(name) {
const match = document.cookie.match(new RegExp(`(^| )${name}=([^;]+)`));
return match ? decodeURIComponent(match[2]) : '';
}
function collectFingerprint() {
return {
ua: navigator.userAgent.slice(0, 250), // 截長 UA
browser: detectBrowser(navigator.userAgent), // 瀏覽器類型
language: navigator.language || navigator.browserLanguage || '',
platform: navigator.platform, // 作業系統平台
screen: `${screen.width}x${screen.height}`, // 屏幕分辨率
timezone: Intl.DateTimeFormat().resolvedOptions().timeZone, // 時區
referrer: document.referrer, // 來源頁面
title: document.title, // 頁面標題
url: location.href, // 當前 URL
timestamp: Date.now() // 客戶端時間戳
};
}
function detectBrowser(ua) {
if (ua.includes('Edg/')) return 'Edge';
if (ua.includes('Chrome/')) return 'Chrome';
if (ua.includes('Firefox/')) return 'Firefox';
if (ua.includes('Safari/') && !ua.includes('Chrome/')) return 'Safari';
if (ua.includes('MSIE') || ua.includes('Trident/')) return 'IE';
if (ua.includes('Opera/') || ua.includes('OPR/')) return 'Opera';
return 'Other';
}
function reportStats(data) {
const url = 'https://stats.example.com/collect';
const payload = new URLSearchParams(data).toString();
// 優先級 1: navigator.sendBeacon(頁面卸載也能發送、無阻塞)
if (navigator.sendBeacon) {
const blob = new Blob([payload], { type: 'application/x-www-form-urlencoded' });
if (navigator.sendBeacon(url, blob)) return;
}
// 優先級 2: fetch keepalive(現代瀏覽器支援)
if (fetch) {
fetch(url, {
method: 'POST',
body: payload,
keepalive: true,
credentials: 'omit', // 跨域不攜帶 Cookie
headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
}).catch(() => {}); // 靜默失敗
return;
}
// 降級: Image 埋點(GET、長度受限、無法攜帶大數據)
const img = new Image();
img.src = `${url}?${payload}`;
}
function trackPageView() {
const statId = getStatId();
const fp = collectFingerprint();
const payload = {
stat_id: statId,
event: 'pageview',
...fp,
// 可擴展:頁面停留時間、滾動深度、點擊熱力等
};
// 異步非阻塞上報
requestIdleCallback?.(() => reportStats(payload)) || setTimeout(() => reportStats(payload), 0);
}
// 頁面加載即上報
if (document.readyState === 'complete') {
trackPageView();
} else {
window.addEventListener('load', trackPageView);
}
// SPA 路由變化手動觸發(需框架路由守衛調用)
// trackPageView();
# 概念性 SQL 聚合
-- PV: 直接計數
SELECT COUNT(*) FROM stats WHERE event='pageview' AND date = '2024-01-15';
-- UV: 去重統計 stat_id
SELECT COUNT(DISTINCT stat_id) FROM stats WHERE event='pageview' AND date = '2024-01-15';
-- 瀏覽器分布
SELECT browser, COUNT(*) FROM stats WHERE date = '2024-01-15' GROUP BY browser;
-- 熱門頁面
SELECT url, COUNT(*) as pv, COUNT(DISTINCT stat_id) as uv
FROM stats WHERE date = '2024-01-15' GROUP BY url ORDER BY pv DESC LIMIT 20;
| 合規點 | 實施建議 |
|---|---|
| GDPR/個人信息保護法 | IP 脫敏、提供退出機制、隱私政策說明統計目的 |
| Cookie 同意 | 統計類 Cookie 屬「必要」或「分析」,需按地區法規獲取同意 |
| 數據最小化 | 僅採集統計必需字段,不採集姓名、身份證等敏感信息 |
| 數據保留期 | 原始日誌建議 13 個月後自動清理,聚合報表可長期保留 |
自建統計系統的核心難點不在「計數」,而在於:
理解這套原理,既能在無法接入第三方服務時自建輕量統計,也能在評估第三方方案時看穿本質——數據採集的本質是「信任傳遞」。