@tripo3d/trace / TripoTrace

Class: TripoTrace

Defined in: trace/src/trace.ts:19

商业化埋点 / 广告归因 SDK。

用法：

const trace = new TripoTrace({ baseUrl: 'https://api-cn-test.tripo3d.com' });
await trace.initLanding();
trace.deviceId   // string
trace.headers    // { 'x-tripo-device-id': string }

Constructors

Constructor

new TripoTrace(params): TripoTrace;

Defined in: trace/src/trace.ts:25

构造时只存配置，不做任何 IO

Parameters

Parameter	Type
params	TripoTraceParams

Returns

TripoTrace

Accessors

deviceId

Get Signature

get deviceId(): string;

Defined in: trace/src/trace.ts:33

当前 device id；未初始化或 SSR 环境下为空字符串

Returns

string

---

headers

Get Signature

get headers(): Record<string, string>;

Defined in: trace/src/trace.ts:38

业务请求拦截器使用的 trace headers；无 device id 时为空对象

Returns

Record<string, string>

Methods

initLanding()

initLanding(): Promise<void>;

Defined in: trace/src/trace.ts:49

初始化归因系统：加载 device id（仅首次）+ 检测当前 URL 渠道 + 命中则上报 landing。

• SSR 环境立即 resolve（no-op）
• 幂等：可在 SPA 路由变化时重复调用，dedupe 保证当日同一 URL 只发一次
• device id 失败时不上报，但 deviceId/headers 仍然返回空字符串/空对象（不抛错）

Returns

Promise<void>