比如业务有账号体系,并希望SDK同步用户状态。就可以考虑在用户登录后立即对SDK设置user_unique_id,在用户登出后立即对SDK清除user_unique_id。
说明
提示:用户登录态概念是站在业务角度的一个说法,SDK本身是没有用户登录/登出概念的,SDK只关心user_unique_id是否有被主动设置。
import { SDK } from '@datarangers/sdk-electron'; const $$sdk = new SDK({ // ... }); // 用户登录后立即设置user_unique_id $$sdk.config({ user_unique_id: '{{uuid}}', // 值可以考虑为能关联到用户的一些属性 }); // 用户登出后立即清除user_unique_id $$sdk.config({ user_unique_id: '', });
使用config方法可以设置公共属性,这些公共属性会在后续所有事件上报都携带上。
import { SDK } from '@datarangers/sdk-electron'; const $$sdk = new SDK({ // ... }); // 设置事件公共属性,这些公共属性会在后续所有事件上报时都携带上 $$sdk.config({ city: '南京', nick_name: 'vikings', });
SDK内部预设了一些公共属性字段,这些字段预定义好了字段名,如下表所列。
字段 | 类型 | 说明 | 是否自动设置 | 举例 |
|---|---|---|---|---|
width | number | Electron屏幕宽 | 是 | 1792 |
height | number | Electron屏幕高 | 是 | 1120 |
os_version | string | 操作系统版本 | 是 | 11_4_0 |
os_name | string | 操作系统名称 | 是 | mac |
platform | string | 平台名,默认web | 是 | web |
resolution | string | 屏幕宽*屏幕高 | 是 | 1792x1120 |
screen_width | number | 同width | 是 | 1792 |
screen_height | number | 同height | 是 | 1120 |
timezone | string | 时区 | 是 | 8 |
tz_offset | string | 时区偏移秒数 | 是 | -28800(东八) |
import { SDK } from '@datarangers/sdk-electron'; // 对构造器使用new操作产生实例1 const $$sdk1 = new SDK({ app_id: 1, // ... }); // 对构造器使用new操作产生实例2 const $$sdk2 = new SDK({ app_id: 2, // ... });
说明
提示: