RevoSurge
Web Tracker SDK

Web Tracker SDK 集成简表

按顺序完成三步：引入脚本 → 初始化 → 上报事件。

引入脚本 初始化 上报事件 工具方法

SDK 作用

专为 Web 端设计，帮你快速拿到真实转化链路。

1. 引入脚本

在页面 <head> 添加脚本标签，确保在业务代码前加载。

<script src="https://assets.revosurge.com/js/web-tracker.js"></script>

2. 初始化

脚本加载后立即创建实例，填入后台分配的 trackerId，如需区分环境可补充 env。


const tracker = new WebTracker({
  trackerId: 'your-tracker-id',
  // env: 'prod' | 'test' | 'dev',
});
参数 类型 必填 说明
trackerId string 必填 分配给你的 tracker 标识，必填。
env dev | test | prod 可选 可选，环境标识，默认 prod，可设 dev/test。

3. 事件上报接口

  1. 1
    REGISTER

    注册

    参数 类型 必填 说明
    user_id string 必填 用户唯一 ID，作为第一个参数传入。
    identifier string 可选 可选，用于脱敏的邮箱或手机号哈希。 
    
tracker.trackRegister('user_123', {
  identifier: 'hashed_email_or_phone'
});
  2. 2
    DEPOSIT

    充值/入金

    参数 类型 必填 说明
    user_id string 必填 用户唯一 ID，作为第一个参数传入。
    currency string 必填 币种，如 USDT。
    network string 必填 支付或链路名称，如 TRON。
    amount number 必填 金额数值。 
    
tracker.trackDeposit('user_123', {
  currency: 'USDT',
  network: 'TRON',
  amount: 100
});
  3. 3
    ENTER_GAME

    进入游戏/产品核心环节

    参数 类型 必填 说明
    user_id string 必填 用户唯一 ID，作为第一个参数传入。
    currency string 必填 选择的计价单位。
    game_provider string 必填 提供方或合作方名称。
    game_id string 必填 游戏或核心功能的内部 ID。
    game_name string 必填 游戏名称或展示标题。 
    
tracker.trackEnterGame('user_123', {
  currency: 'USDT',
  game_provider: 'provider_xyz',
  game_id: 'gamer_123',
  game_name: 'My Awesome Game'
});
  4. 4
    LOGIN

    登录

    参数 类型 必填 说明
    user_id string 必填 用户唯一 ID，作为第一个参数传入。 
    
tracker.trackLogin('user_123');
  5. 5
    DOWNLOAD_CLICK

    点击下载

    参数 类型 必填 说明
    user_id string 必填 用户唯一 ID。
    store_type string 可选 可选，下载渠道。例如 App Store、Play Store。 
    
tracker.trackDownloadClick('user_123', {
  store_type: 'App Store'
});
  6. 6
    CUSTOM_EVENT

    自定义事件

    参数 类型 必填 说明
    event_type string 必填 自定义事件名称，放在第一个参数。
    payload object 可选 键值对形式的事件字段，作为第二个参数。 
    
tracker.trackCustomEvent('custom_event_type', {
  event_detail: 'value'
});

4. 工具方法

SDK 提供了一些实用的工具方法，用于获取存储的数据和版本信息。

  1. 1
    getClickid()

    获取点击ID

    从存储的 UTM 数据中获取 clickid 值。如果 URL 中包含 ?clickid=xxx 参数，SDK 会自动提取并存储。

    返回值 类型 说明 示例
    clickid string | null 找到则返回 clickid 字符串，否则返回 null "abc123" 或 null 
    
const clickid = tracker.getClickid();
if (clickid) {
  console.log('Click ID:', clickid);
}
  2. 2
    getVersion()

    获取SDK版本

    返回当前 SDK 的版本号字符串。

    返回值 类型 说明 示例
    version string SDK 版本号 "1.0.2" 
    
const version = tracker.getVersion();
console.log('SDK Version:', version);