@unionfab/web-track-browser
v0.3.1
Published
## 背景信息
Downloads
1
Readme
SLS WebTracking JavaScript SDK
背景信息
Web Tracking 可以采集各种浏览器、iOS APP 或 Android APP 的用户信息,例如:
- 用户使用的浏览器、操作系统、分辨率等信息。
- 用户浏览行为记录(例如:用户在网站上的单击行为、购买行为等)。
- 用户在 APP 中的停留时间、是否活跃等。
适用平台
@aliyun-sls/web-track-browser 只支持浏览器端。
小程序参见 @aliyun-sls/web-track-mini
注意事项
- 使用 Web Tracking 则表示该 Logstore 打开互联网匿名写入权限,没有经过有效鉴权,可能产生脏数据。
- POST 请求每次写入的日志数量上限为 3MB 或者 4096 条,详情请参见PutLogs。
数据采集
控制台配置
- 登录日志服务控制台。
- 单击目标 Project。
- 找到目标 Logstore,单击下的修改。
- 在Logstore 属性页面,单击右上方的修改。
- 打开WebTracking开关,并单击保存。
通过 SDK 采集数据
1.安装依赖包
npm install --save @aliyun-sls/web-track-browser
2.import
在您的应用程序模块。
import SlsTracker from '@aliyun-sls/web-track-browser'
3.使用CDN包(注意修改版本号)
<script src="https://g.alicdn.com/sls/sls-js-sdk/${version}/web-track-browser.js"></script>
window.SLS_Tracker &&
new SLS_Tracker({
project: 'xxx',
logstore: 'xxx',
host: 'xxx',
})
4.配置参数 opts。
| 参数 | 说明 | 是否填写 | | :----------: | :---------------------------------------------------------------------------------------------------------------------------------: | :------------------------------: | | host | 日志服务所在地域的 Endpoint,详情请参见服务入口。支持自定义域名,此时 host 格式为 https://自定义域名 或者 http://自定义域名 | 必填 | | project | 控制台创建的 project 名称。 | 必填 | | logstore | 控制台创建的 logstore 名称。 | 必填 | | time | 发送消息的时间间隔,数据格式为 Number 的方式,time*1000(毫秒)。 | 选填(默认是 10 秒) | | count | 发送消息的数量大小,数据格式为 Number 的方式。 | 选填(默认是 10 条数据) | | topic | 日志主题。 | 选填, string | | source | 日志来源。 | 选填, string | | tags | 日志标签。 | 选填, Record<string, string> |
const opts = {
host: '${host}', // 所在区域的host
project: '${project}', // project名称
logstore: '${logstore}', // logstore名称
time: 10, // 定义时间,默认是10秒,number类型,选填
count: 10, // 定义数据条数,默认是10条,number类型,选填
topic: 'topic',
source: 'source',
tags: {
tags: 'tags',
},
}
5.创建 SlsTracker 对象。
const tracker = new SlsTracker(opts)
6.上传日志。
tracker.send({
customer: 'zhangsan',
product: 'iphone 12',
price: 7998,
})
核心功能
send()
说明: 单条数据上传。
参数:Object 类型
示例:
tracker.send({
customer: 'zhangsan',
product: 'iphone 12',
price: 7998,
})
sendImmediate()
说明: 单条数据立即上传,time 和 count 参数此时配置不生效。
参数:Object 类型
示例:
tracker.sendImmediate({
customer: 'zhangsan',
product: 'iphone 12',
price: 7998,
})
sendBatchLogs()
说明: 批量数据上传。
参数:Object 类型
示例:
tracker.sendBatchLogs([
{
customer: 'zhangsan',
product: 'iphone 12',
price: 7998,
},
{
customer: 'zhangsan',
product: 'iphone 12',
price: 7998,
},
])
sendBatchLogsImmediate()
说明: 批量数据上传,time 和 count 参数此时配置不生效。
参数:Object 类型
示例:
tracker.sendBatchLogsImmediate([
{
customer: 'zhangsan',
product: 'iphone 12',
price: 7998,
},
{
customer: 'zhangsan',
product: 'iphone 12',
price: 7998,
},
])