🔍 TagLite 使用者行為追蹤原理（How It Works）

本頁將說明 TagLite 如何運作，包括追蹤流程、資料內容、標籤生成與 API 回傳範例。

📐 一、系統架構簡介

只需在網站中嵌入一行 <script src="https://cdn.taglite.com.tw/js/core.js"></script> 即可啟動追蹤。

• 會自動向 tag.taglite.com.tw 傳送資料
• 並寫入伺服器端 /var/www/rawdata/tracker_tag/ 日誌

🧾 二、資料蒐集內容

• IP、地理位置、語言、時區、裝置資訊
• 使用者代理字串（User Agent）與瀏覽器資訊
• 載入時間與停留秒數
• SEO 標籤（og:title、meta:keywords、article:tag 等）

🧠 三、標籤生成邏輯

• 系統每日彙整出現天數與停留時間，篩出高關聯標籤
• 網站主亦可使用 taglite_customize('自定義標籤') 傳送標籤

🔄 四、資料處理流程

使用者行為會即時寫入 Log，後續由背景作業每日轉換成統計資料，可輸出：

• 每個 UUID 對每個網址的平均停留時間與標籤
• 每個 UUID 對各個標籤的累計曝光與互動

📦 五、API 回傳範例

{
  "uuid": "uid_xxx",
  "onsite": [{ "tag": "科技", "confidence": 0.83 }],
  "offsite": [{ "tag": "財經", "confidence": 0.54 }],
  "metadata": {
    "timestamp": "2025-06-16T10:00:00Z",
    "generated_by": "TagLite-TAG-Engine"
  }
}

🔧 六、應用方式

• 網站可使用 JS 或 Ajax 呼叫 /get-info.js 並接收推薦標籤
• 可根據 uuid 進行後端推薦查詢或 A/B 測試
• 也可搭配 CDN、iframe 等方式降低主站負擔

🛡️ 七、隱私與安全

• 不蒐集 email、手機或真實帳號
• 每位使用者僅以 UUID 表示，無法回推身分
• UUID 綁定 cookie、fingerprint 雜湊後產生，不具可逆性