特赞（上海）信息科技有限公司用户608
@tezignlab/tezign-external-track 特赞Web埋点sdk使用指南
输入“/”快速插入内容
@tezignlab/tezign-external-track 特赞Web埋点sdk使用指南
@tezignlab/tezign-external-track 特赞Web埋点sdk使用指南
✅
适用于web端/浏览器开发的埋点sdk
另：tezign-external-sdk 特赞微信小程序埋点sdk使用指南
埋点传参说明：tezign前端埋点SDK参数说明
目前 SDK 支持的功能
◦
全局点击 （插件集成）
◦
PV （插件集成）
◦
localStorage 缓存退出浏览器未来得及上报的事件并且下次自动上报 （插件集成）
◦
手动上报，批量发送，定时上报
◦
支持用户编写自定义插件
1.
集成 tezign sdk
1.1
npm
代码块
// npm
npm install @tezignlab/tezign-external-track
// yarn
yarn add @tezignlab/tezign-external-track
// pnpm
pnpm install @tezignlab/tezign-external-track
1.2
在 html 中里内嵌 script 标签
代码块
<head>
// ...其他
<script src="https://static.tezign.com/tezign-external-track/{版本号}/tezignExternalTrack.browser.min.js" ></script>
</head>
◦
对应 script 中的 src 此时是:
代码块
<script src="https://static.tezign.com/tezign-external-track/{版本号}/tezignExternalTrack.browser.min.js" ></script>
2.
使用
导入
NPM方式
代码块
import tezignSdk from '@tezignlab/tezign-external-track';
◦
Tezign sdk 提供了 commonjs 和 esm 规范的代码格式，一般情况下构建工具会取决于你当前使用 的module格式自动导入对应格式的代码。如果要指定格式:
▪
commonjs
代码块
import tezignSdk from '@tezignlab/tezign-external-track/npm/tezignExternalTrack.cjs'
▪
es6/esm
代码块
import tezignSdk from '@tezignlab/tezign-external-track/npm/tezignExternalTrack.mjs'
CDN 同步加载
对于使用 script 同步加载的方法，用户需要确保 sdk 调用 init 方法初始化的时机，在 script 加载也就是 tezignExternalTrack 被挂在到 window 之后，建议如下的方式初始化:
❗
确保初始化 sdk 的代码在后
代码块
<head>
// ...其他
<script src="https://static.tezign.com/tezign-external-track/{版本号}/tezignExternalTrack.browser.min.js"></script>
</head>
// 在项目的js中使用
window.tezignExternalTrack.init({
tenant_id: '',
client_id: '',
token,
http: {
api: 'https://open-auth.test.tezign.com/open-api/standard/v1/save-client-track-log',
},
});
// 插件：
const {pageViewPlugin, clickPlugin, persistLocalStoragePlugin} = window.tezignExternalTrack.plugins