用戶行爲(wéi / wèi)分析 JSSDK
用戶行爲(wéi / wèi)分析 JS-SDK 主要(yào / yāo)用于(yú)前端頁面的(de)數據采集,支持移動端和(hé / huò) PC 兩種适配方式。
獲取和(hé / huò)引入 JavaScript SDK
獲取和(hé / huò)安裝
從私有 npm 倉庫獲取 sdk :
npm install mskj-js-sdk --registy=yourPrivateRegistry
如何使用
通過 npm 獲取 sdk 之(zhī)後,我們就(jiù)可以(yǐ)開始在(zài)代碼中引入和(hé / huò)使用了(le/liǎo):
import MSKJ from 'mskj-js-sdk';
const mskj = new MSKJ({
// 服務器地(dì / de)址
url: '...',
// 項目唯一(yī / yì /yí)标識
productid: 'xxxx',
// 用戶唯一(yī / yì /yí)标識
xwho: "9692043c-7d85-417a-b84e-fd37e1b7a67e",
.......
});
mskj.track({
{
xwhat: "lezhu_search_keyword",
type: "user_behavior",
xcontext: {
lezhu_search_type: "制度庫搜索",
lezhu_search_keyword: "年假制度"
}
}
});
參數配置
必填參數
url:用于(yú)指定用戶分析服務器地(dì / de)址
productid:用于(yú)唯一(yī / yì /yí)标識 app 項目
可選參數
xwho:用于(yú)唯一(yī / yì /yí)标識用戶,若未傳遞,則會自動生成唯一(yī / yì /yí)标識
limit:用于(yú)自定義批量發送的(de)阈值,SDK 在(zài)達到(dào)該阈值時(shí)将自動發送采集數據,默認值爲(wéi / wèi) 1
自定義事件追蹤
SDK 初始化成功之(zhī)後,即可以(yǐ)通過mskj.track(event)
,方法來(lái)記錄事件:
- event:
object
,表示事件的(de)屬性
// 追蹤關鍵字查詢事件
mskj.track({
{
xwhat: "lezhu_search_keyword",
type: "user_behavior",
xcontext: {
lezhu_search_type: "制度庫搜索",
lezhu_search_keyword: "年假制度"
}
}
});
預置屬性
獲取 SDK 預置屬性
mskj.getContext()
該方法可以(yǐ)獲取 SDK 中的(de)公共屬性,主要(yào / yāo)包括:productid
、url
、xwho
以(yǐ)及xcontext
,我們的(de)預置屬性主要(yào / yāo)包含于(yú)xcontext
字段下。
預置屬性列表
字段名稱 | 類型 | 說(shuō)明 | 版本 |
---|---|---|---|
_lib_version | string | sdk 版本 | 無 |
_os | string | 操作系統 | 無 |
_debug | number | 預留字段 | 無 |