埋點安裝
標準安裝是一段 async 指令碼,放在要統計的每個頁面 </body> 之前。把 XXXX 換成「站點管理」裡顯示的 site_id。
<script async src="https://9ping.dev/hm.min.js" data-sid="XXXX"></script>
如果用 Google Tag Manager:新增「自訂 HTML 程式碼」標籤,貼上同一段,觸發條件選 All Pages。
訪客停用 JavaScript、或在郵件 / AMP 等無指令碼環境,加一段 1×1 像素備援——至少能記到 PV。
<noscript><img src="https://9ping.dev/collect.php?sid=XXXX&type=pv" width="1" height="1" alt=""></noscript>
單頁應用(React / Vue / Next / Nuxt 等):啟動時注入一次指令碼——客戶端路由切換會自動算一次虛擬 PV。
(function(){var s=document.createElement('script');s.async=true;s.src='https://9ping.dev/hm.min.js';s.dataset.sid='XXXX';document.head.appendChild(s);})();
自訂事件
埋點載入後,全域 window.tj 函式即可用於按鈕點擊、表單提交、下載等臨時事件。簽章是 category, action, label。
tj('event', 'button', 'click', 'download_whitepaper');
自己控制路由時,可用 tj('pv') 顯式回報一次 PV。指令碼載入前的早期點擊:早期樁會排隊並在指令碼載入後重播,無需 setTimeout 包一層。
所有權驗證
建議在開啟進階報表前完成驗證。「站點管理」每個站列出四種等價方法——選最方便的一種。
方法一 · HTML 檔案。在後台下載 tj-verify-TOKEN.html,上傳到網站根目錄。
方法二 · meta 標籤。把一段 meta 貼到首頁 <head>。
<meta name="tj-site-verification" content="YOUR_TOKEN">
方法三 · 統計程式碼。首頁已執行我們的 tag 並至少有一次造訪,即自動驗證。方法四 · DNS TXT。在主域上新增一筆 TXT:tj-site-verification=YOUR_TOKEN。
開放 API 與批次部署
每個帳號自帶一個個人 API 金鑰(前置 tjk_),可透過 HTTPS 列站、建站、取埋點碼、讀資料。驗證方式:傳送 X-API-Key 請求標頭。
curl -H "X-API-Key: $TJ_KEY" "https://9ping.dev/openapi.php?action=sites"
要在一臺 Linux 上把埋點鋪到整個站群:從「站點管理」下載 tj-deploy.sh。它會逐域名呼叫 API 註冊、產生埋點碼,並可選地注入到你的範本。
開放 API 支援從文字檔批次建站,每行可以是裸域名或 域名|名稱。完整動作列表見 API 文件。
安全:兩步驟驗證與復原碼
所有後台帳號強制 Google Authenticator 兩步驟驗證(TOTP,RFC 6238)。註冊時會拿到 10 個一次性復原碼——務必妥善保存;遺失手機時它們是唯一備援。
復原碼一次性,伺服器端只存雜湊。復原入口在登入頁「用復原碼復原」;復原流程允許你重設密碼並重新繫結驗證器。
從 GA4 或 Baidu Tongji 遷移
你不需要為試用 9ping 而下掉原埋點——兩段埋點可以並存、各自獨立回報,這是切換前用一週對帳最穩的姿勢。
遷移步驟:在「站點管理」新增你的域名,把一行埋點貼到 </body> 之前(或透過 GTM 推送),看即時面板亮起,確認無誤後再撤掉舊埋點。
自訂事件可平滑遷移:例如 GA4 名為 signup、參數 method/plan 的事件,對應 tj('event','signup',method,plan)。9ping 的目標與漏斗透過標記相關事件實現,無需單獨維護一份目標設定。