---
title: 监控数据采集
description: 可附加到任何采集会话的可选元数据，用于在监控和可观测性工具中识别用户和流程。
canonical: https://developer.unico.io/zh-CN/dual-api/developers/sdks-and-tools/web/web-sdk/capture-flow/monitoring-data-collection
locale: zh-CN
generated_by: markdown-export
---

:::info[可选实现]
监控数据采集是**可选的**。如果您采用它，**仅 `prepareSelfieCamera` 调用会受到影响** — 采集流程中的其他所有步骤（初始化、回调、结果处理）保持不变。
:::

:::secondary[完全不需要相机？]
本页介绍 `setSilentInfo`，它仅在伴随 `prepareSelfieCamera`/`prepareDocumentCamera` 调用时才会生效。如果您希望在完全不打开相机会话的情况下进行静默验证（例如登录页面），请改用 `initializeSDK` + `startSilentValidation`——详见[静默重新验证](./capture-types/silent-revalidation)。两者可以在同一页面中同时使用。
:::

将用户和流程元数据附加到采集会话，以便在 Unico 的监控和可观测性工具中进行关联，并使后端能够将其纳入本次交易的静默重新验证结果。提供后，数据会随采集一并转发，且不会改变 SDK 的采集行为——但会影响创建流程的响应：详见[静默重新验证](./capture-types/silent-revalidation)中的 `silentAuth.result`。

## setSilentInfo parameters

| 参数 | 类型 | 必填 | 描述 |
|---|---|:-:|---|
| `externalUserId` | `String` | ✅ | 您系统中的用户标识符。传输前自动使用 SHA-256 进行哈希处理 — 从不以明文发送。 |
| `useCase` | `String` | — | 运行的流程或上下文的标识符（例如 `"account_opening"`、`"password_recovery"`）。以明文传输。 |

## Implementation

在调用 `prepareSelfieCamera` **之前**，在已构建的相机实例上调用 `setSilentInfo`。采集流程中的其他所有内容保持不变。

```typescript
import { UnicoCheckBuilder, UnicoConfig, SelfieCameraTypes, SDKEnvironmentTypes } from "@acesso-io/unico-webframe";

const config = new UnicoConfig()
  .setHostname("<YOUR_HOSTNAME>")
  .setHostKey("<YOUR_HOST_KEY>");

const unicoCamera = new UnicoCheckBuilder()
  .setEnvironment(SDKEnvironmentTypes.UAT)
  .build();

unicoCamera.setSilentInfo("external_user_id", "flow_id");

await unicoCamera.prepareSelfieCamera(config, SelfieCameraTypes.SMART);
```