小程序開發文件

telemetry 埋點 ​

畫面層、邏輯層都可用。需要容器 1.1.0。

sdk.telemetry.report() ​

ts
sdk.telemetry.report(events: TelemetryEvent[]): Promise<void>

interface TelemetryEvent {
  name: string;   // [A-Za-z0-9._-]，1–40 字
  value: number;
}

上報自訂的數值事件，例如頁面載入耗時、按鈕點擊次數。

規則上限
每次事件數最多 20 筆
name只能英數與 .、_、-，1–40 字
value數字
  • 違反規則時整批以 INVALID_PARAMS 失敗。
  • 事件會加上小程序 ID 與時間，名稱前綴 sdk.，和容器自己的事件（啟動耗時、錯誤）一起批次送出，不需要自己合併。
  • 不要放個人資料：name 只是事件名稱，不能夾帶使用者輸入。
ts
const start = performance.now();
await loadOrders();
void sdk.telemetry.report([{ name: 'orders.load_ms', value: Math.round(performance.now() - start) }]).catch(() => {});