TOPLEAD 商业线索雷达接入开发指南

面向工业制造与外贸独立站的轻量级商业意向与流量渠道分析探针 (大小约 2.8KB，零第三方依赖，对首屏速度与 SEO 评分零负面影响)。

一、 快速接入（只需 1 行代码）

在目标网站任意页面的 </body> 闭合标签前（或 </head> 标签内），直接粘贴以下脚本：

<script src="https://lead.lunaraspace.top/assets/js/tracker.js" data-site="您的站点唯一标识" defer></script>

二、 默认全自动捕获的 7 大商业转化行为

只要目标网站的 HTML 结构遵循常规标准，无需编写任何额外 JavaScript，SDK 即可全自动识别并上报：

• 1. 访问与 SEO / 社媒来源分析 (pv)：自动穿透识别 Google、Bing、Yandex 自然搜索，精准穿透 X (Twitter) (包括 t.co 短链)、Facebook、LinkedIn、Instagram、Pinterest，并解析 UTM 推广参数与具体落地页路径。
• 2. 拨打电话 (call)：点击任何 <a href="tel:..."> 时，自动抓取所拨打的电话号码。
• 3. WhatsApp 即时洽谈 (whatsapp)：点击任何包含 wa.me 或 whatsapp.com 的链接时自动上报。
• 4. 微信咨询与扫码 (wechat)：在微信按钮或弹窗上添加 data-track="wechat" 或 class 包含 wx/wechat。
• 5. 技术图纸/规格书下载 (download)：点击 .pdf、.zip、.dwg、.stp 等附件时自动抓取文件名。
• 6. RFQ / 询盘表单提交 (rfq)：自动监听 <form> 提交或带有“询盘、inquiry、rfq、quote、报价”的按钮点击。
• 7. 深度阅读停留心跳 (duration)：访客在页面停留满 30秒、60秒、180秒 时自动静默上报高价值意向。

三、 高级用法：手动上报自定义业务事件

针对现代单页应用（Vue / React / Next.js）或复杂业务弹窗，可通过全局 API 手动触发：

if (window.TopleadTracker) {
  // 手动上报询盘提交
  window.TopleadTracker.track('rfq', {
    detail: '提交了 40HQ 柜商业仿真树报价单'
  });

  // 手动上报特定技术咨询
  window.TopleadTracker.track('call', {
    detail: '点击了右侧悬浮栏紧急技术咨询'
  });
}

四、 接入验收与自查（30 秒核验）

1. 网络抓包：打开嵌入页面的控制台 F12 → 切换至 Network (网络) → 过滤 track，刷新页面可见向 api/track 发送的状态为 200 的请求；
2. 雷达大屏核实：访问 https://lead.lunaraspace.top/radar.html，即可在“实时跨站线索事件流”中看到刚刚产生的访问、来源渠道与点击动作。