访客 ID 即 _visitor_id,是用户在设备上安装了应用之后,登录状态之前该用户的唯一标识。
我们提供访客 ID 自定义设置的接口,如果您有自己的访客管理体系需要替换访客 ID,应在 SDK 初始化之前进行设置。
数据上报时仅以最后一次传入的访客 ID 为准,应避免多次调用造成多个非正常访客 ID 先后上报数据的情况。
设置访客 ID
调用 setVisitorID 方法来设置访客 ID。
方法示例
export function setVisitorID(visitorID:string);
参数说明
参数名称 | 参数含义 | 参数类型 | 是否必传 |
visitorID
|
需要设置的访客 ID | string | 是 |
调用示例
注:
- 该调用仅为向 SDK 传入访客 ID,不会上报用户设置事件。
- 开发者设置的访客 ID 长度不能超过 128 个字符,否则会设置失败。
获取访客 ID
获取当前设置的访客 ID,可以调用 fetchVisitor 方法获取。
方法示例
export function fetchVisitor():string;
返回值:返回已经设置的访客 ID
调用示例
let visitorID = SolarEngine.fetchVisitor();