用户登录态设置

比如业务有账号体系，并希望SDK同步用户状态。就可以考虑在用户登录后立即对SDK设置user_unique_id，在用户登出后立即对SDK清除user_unique_id。

import $$sdk from '@datarangers/sdk-quick';
$$sdk.init({
    // ...
});
$$sdk.send();

// 用户登录后立即设置user_unique_id
$$sdk.config({
    user_unique_id: '{{uuid}}', // 值可以考虑为能关联到用户的一些属性
});

// 用户登出后立即清除user_unique_id
$$sdk.config({
    user_unique_id: '',
});

web_id、ssid相关

获取SDK默认生成的web_id、ssid

SDK会为您自动生成web_id、ssid，如果您希望获取SDK默认生成的这些id，可参考以下方式。
获取web_id

import $$sdk from '@datarangers/sdk-quick';
$$sdk.init({
    // ...
});
$$sdk.send();

$$sdk.on($$sdk.types.Ready, () => {
    const webid = $$sdk.getConfig('web_id');
    console.log('web_id', webid);
});

获取ssid

注意：获取ssid时，实际需要调用getToken获取到ssid，该方法会发起请求去DataFinder的数据流服务中获取ssid，ssid不在SDK侧进行管理。

import $$sdk from '@datarangers/sdk-quick';
$$sdk.init({
    // ...
});
$$sdk.send();

$$sdk.getToken().then((ids) => {
    const ssid = ids.ssid;
    console.log('ssid', ssid);
});

设置事件公共属性

使用config方法可以设置公共属性，这些公共属性会在后续所有事件上报都携带上。

import $$sdk from '@datarangers/sdk-quick';
$$sdk.init({
    // ...
});
$$sdk.send();

// 设置事件公共属性，这些公共属性会在后续所有事件上报时都携带上
$$sdk.config({
    city: '南京',
    nick_name: 'vikings',
});

SDK内部预设了一些公共属性字段，这些字段预定义好了字段名，如下表所列，其中部分字段，SDK在初始化完成后会自动尝试获取，而其他字段需要业务方设置，比如nick_name、gender、avatar_url这些SDK无法自动获取到的，就需要您主动进行设置。

使用多实例

使用多实例，需要导入SDK类，即SDK构造器，位于SDK包中的esm目录下的sdk文件。

import SDK from '@datarangers/sdk-quick/esm/sdk';

提示，如下方式导入的是SDK的默认实例，非SDK构造器。注意观察导入的文件是不一样的。

import $$sdk from '@datarangers/sdk-quick';

示例：

import SDK from '@datarangers/sdk-quick/esm/sdk';

// 对构造器使用new操作产生实例1
$$sdk1 = new SDK();
$$sdk1.init({
    app_id: 1,
    // ...
});
$$sdk1.send();

// 对构造器使用new操作产生实例2
$$sdk2 = new SDK();
$$sdk2.init({
    app_id: 2, // app_id不能与其他实例相同
    // ...
});
$$sdk2.send();

自定义选择内部插件

SDK默认导出的实例包含了尽可能多的插件功能。使用自定义选择插件后，比起默认导出的实例在构建后的体积上会少一些。如果业务希望自定义选择使用哪些插件，可以考虑如下使用方式。

1. 首先导入SDK基础类文件：esm/base.js
2. 再根据需要导入相应的插件文件：esm/plugin/xxx.js
3. 将插件注册到SDK基础类：使用SDK类的usePlugin静态方法
4. 然后实例化SDK，接着再进行初始化设置

// 导入基础类
import BaseSDK from '@datarangers/sdk-quick/esm/base';

// 导入所需插件，比如AB实验插件
import Ab from '@datarangers/sdk-quick/esm/plugin/ab';
BaseSDK.usePlugin(Ab);

// 实例化SDK
const $$sdk = new BaseSDK();
$$sdk.init({
    app_id: 1, // 替换成申请的app_id
    enable_ab_test: true，//开启ab实验
});
$$sdk.send();

UTM相关

UTM追踪

SDK默认会尝试从快应用启动参数上获取utm相关参数：utm_source、utm_medium、utm_campaign、utm_term、utm_content。如果获取到了，就将这些参数放入事件公共属性中，后续所有事件上报时都会携带上。该能力自动开启，业务不需要做任何处理。

在特殊环境下使用方式

如果业务项目由于一些原因不支持使用npm包、或第三方依赖、甚至没有构建打包处理过程，可以考虑使用SDK提供的umd模块文件。

• 复制SDK包内的index.umd.js文件到项目下

const $$sdk = require('{{相对路径}}/index.umd.js');
$$sdk.init({
   // ...
});
$$sdk.send();