萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 精準統計網站訪問量:基於 Cookie 指紋 + 異步上報的完整實現

核心需求:區分「訪問量 PV」與「訪客數 UV」

  • PV (Page View):每次頁面加載計數 +1
  • UV (Unique Visitor):同一用戶(同一設備/瀏覽器)一天內只計 1

需解決:用戶標識生成、跨頁持久化、異步非阻塞上報、瀏覽器指紋補強。

完整統計腳本架構

1. 唯一訪客標識生成(StatID)

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]) : '';
}

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';
}

3. 異步上報:Beacon API / Fetch / Image 埋點

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}`;
}

4. 完整上報流程

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 個月後自動清理,聚合報表可長期保留

現代替代方案

  • Google Analytics 4 / Matomo / Umami:開箱即用、儀表板豐富、合規內建
  • Plausible / Fathom:輕量、無 Cookie、隱私優先
  • Cloudflare Web Analytics:邊緣計算、零 JS 體積、免費

總結

自建統計系統的核心難點不在「計數」,而在於:

  1. 穩定的用戶標識(Cookie + 指紋雙重保險)
  2. 可靠的數據上報(Beacon/Fetch keepalive 保障頁面卸載也能送達)
  3. 合規的隱私處理(最小化、透明化、用戶可控)

理解這套原理,既能在無法接入第三方服務時自建輕量統計,也能在評估第三方方案時看穿本質——數據採集的本質是「信任傳遞」。

copyright © 萬盛學電腦網 all rights reserved