You need to enable JavaScript to run this app.
导航
Electron SDK集成场景实践
最近更新时间:2025.08.08 18:09:15首次发布时间:2025.08.08 18:09:15
复制全文
我的收藏
有用
有用
无用
无用

user_unique_id相关

用户登录态设置

比如业务有账号体系,并希望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,
    // ...
});

说明

提示:

  • 不同实例的app_id要求不能相同。
  • 当前仅SaaS-云原生环境、私有化环境支持多应用能力,SaaS-非云原生环境不支持。使用前,您需联系火山引擎技术支持人员开启功能开关并在DataFinder的项目中绑定多个应用,多应用的端到端操作指导请参见使用多应用