Tuleer
開發者文件

幾分鐘完成統計接入

新增網站、安裝 t.js，即可採集頁面瀏覽、會話和自定義事件。

步驟 1

建立網站

註冊並登入使用者面板，點選“新增網站”，填寫網站名稱、主域名和統計時區。系統會生成唯一的 32 位站點 ID。

註冊 Tuleer 賬戶 →
步驟 2

安裝統計程式碼

在當前網站的“網站設定”中複製統計程式碼，並放到所有頁面的 <head> 中。

<script defer src="https://tuleer.com/t.js" data-site="你的網站ID"></script>

如果站點使用統一佈局模板，只需要安裝一次。

步驟 3

驗證接入

訪問安裝了指令碼的頁面，然後開啟使用者面板的“實時”頁面。正常情況下，15 秒內可以看到線上訪客和活躍頁面。

自定義事件

使用自定義事件記錄註冊、購買、提交諮詢等關鍵動作。事件名稱必須以字母開頭，支援字母、數字、點、下劃線、冒號和短橫線。

window.tuleer.track('signup_completed', {
    plan: 'pro',
    source: 'pricing_page'
});

然後在使用者面板“目標”中建立同名事件，即可作為轉化目標管理。

單頁應用

t.js 會監聽 History API 的 pushState、replaceState 和瀏覽器前進後退事件，自動記錄路由變化，無需重複初始化。

採集與隱私

  • 不讀取表單內容、密碼或頁面業務儲存。
  • 訪客 ID 和會話 ID 均為匿名隨機標識。
  • 尊重瀏覽器 Do Not Track 設定。
  • 請求來源必須匹配後臺配置的主域名或允許來源。
  • 單次屬性資料最大 16 KB，整個請求最大 64 KB。

故障排查

實時頁面沒有資料

確認程式碼中的站點 ID 完整，並檢查網站狀態是否為“統計中”。

請求返回 403

檢查當前訪問域名是否與網站主域名一致；子域名需加入“額外允許來源”。

本地測試不生效

將本地開發地址加入額外允許來源，並確認瀏覽器未開啟 Do Not Track。

自定義事件被拒絕

檢查事件名稱格式、屬性是否為合法 JSON，以及屬性大小是否超限。