Web 追蹤器 SDK 參考

在 SDK 載入並初始化後使用本參考。先註冊，再按發生順序追蹤下游動作，以便更清晰的歸因。

事件上報 API

trackRegister

綁定首個唯一用戶識別碼；之後所有事件將連結到此帳戶。

tracker.trackRegister('user_123', {
  identifier: 'hashed_email_or_phone'
});

參數	類型	必填	說明
user_id	string	是	唯一用戶 ID。
identifier	string	否	用於去重的雜湊電郵或手機號。

trackDeposit

記錄資金流入，用於轉化及風險分析。

tracker.trackDeposit('user_123', {
  currency: 'USDT',
  network: 'TRON',
  amount: 100
});

參數	類型	必填	說明
user_id	string	是	唯一用戶 ID。
currency	string	是	貨幣代碼，如 USDT。
network	string	是	支付通道或鏈，如 TRON。
amount	number	是	金額。

trackEnterGame

擷取用戶開始核心體驗(遊戲或關鍵流程)時。

tracker.trackEnterGame('user_123', {
  currency: 'USDT',
  game_provider: 'provider_xyz',
  game_id: 'gamer_123',
  game_name: 'My Awesome Game'
});

參數	類型	必填	說明
user_id	string	是	唯一用戶 ID。
currency	string	是	所選面額。
game_provider	string	是	提供商或合作夥伴名稱。
game_id	string	是	內部遊戲或功能 ID。
game_name	string	是	遊戲或體驗顯示名稱。

trackLogin

確認回訪用戶並繼續同一帳戶工作階段。

tracker.trackLogin('user_123');

參數	類型	必填	說明
user_id	string	是	唯一用戶 ID。

trackDownloadClick

標記用戶從頁面觸發下載或跳轉應用商店時。

tracker.trackDownloadClick('user_123', {
  store_type: 'App Store'
});

參數	類型	必填	說明
user_id	string	否	唯一用戶 ID。
store_type	string	否	下載渠道，如 App Store 或 Play Store。
target	string	否	本次點擊把用戶帶去哪裡，如 af（AppsFlyer 點擊連結）或 fallback（你自己的商店/落地連結），便於與 MMP 的點擊數對賬。未傳則事件中不含該欄位。需 SDK 1.4.5 或以上。

trackDownloadClickRegister

標記用戶在註冊流程中觸發下載或跳轉應用商店時。

tracker.trackDownloadClickRegister('user_123', {
  store_type: 'App Store',
  identifier: 'hashed_email_or_phone'
});

參數	類型	必填	說明
user_id	string	否	唯一用戶 ID。
store_type	string	否	下載渠道，如 App Store 或 Play Store。
identifier	string	否	雜湊後的電郵或電話號碼。
target	string	否	本次點擊把用戶帶去哪裡，如 af（AppsFlyer 點擊連結）或 fallback（你自己的商店/落地連結），便於與 MMP 的點擊數對賬。未傳則事件中不含該欄位。需 SDK 1.4.5 或以上。

trackCustomEvent

新增業務特定事件，如任務完成或物品購買。

tracker.trackCustomEvent('custom_event_type', {
  event_detail: 'value'
});

參數	類型	必填	說明
event_type	string	是	自訂事件名稱。
payload	object	否	事件的鍵值對載荷。

工具參考

getClickid()

回傳 UTM 數據中儲存的 clickid。若 URL 包含 ?clickid=...，SDK 會自動擷取並儲存。

點擊 ID 保存在第一方 cookie 中，有效期 30 天，與歸因窗口一致。在 iOS / Safari 上，受 ITP 限制，它可能更早被清除。請在用戶註冊時呼叫此方法，並把回傳值保存到該用戶的記錄上 —— 參閱在註冊時保存點擊 ID。

const clickid = tracker.getClickid();
if (clickid) {
  console.log('Click ID:', clickid);
}

回傳：string | null

getVersion()

回傳目前 SDK 版本字串。

const version = tracker.getVersion();
console.log('SDK Version:', version);

回傳：string