@aliyun-sls/web-track-browser
TypeScript icon, indicating that this package has built-in type declarations

0.3.5 • Public • Published

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

数据采集

控制台配置

  1. 登录日志服务控制台
  2. 单击目标 Project。
  3. 找到目标 Logstore,单击pic下的修改
  4. Logstore 属性页面,单击右上方的修改
  5. 打开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,
  },
])

Readme

Keywords

none

Package Sidebar

Install

npm i @aliyun-sls/web-track-browser

Weekly Downloads

483

Version

0.3.5

License

none

Unpacked Size

18.6 kB

Total Files

6

Last publish

Collaborators

  • nosmilen
  • ruiqi.hy
  • yuecjnadt
  • perezyuan