---
title: 모니터링 데이터 수집
description: 모니터링 및 옵저버빌리티 도구에서 사용자와 플로우를 식별하기 위해 캡처 세션에 선택적으로 첨부할 수 있는 메타데이터입니다.
canonical: https://developer.unico.io/ko/dual-api/developers/sdks-and-tools/web/web-sdk/capture-flow/monitoring-data-collection
locale: ko
generated_by: markdown-export
---

:::info[선택적 구현]
모니터링 데이터 수집은 **선택 사항**입니다. 이를 적용하면 **`prepareSelfieCamera` 호출에만 영향을 미치며** — 캡처 플로우의 다른 모든 단계(초기화, 콜백, 결과 처리)는 변경되지 않습니다.
:::

:::secondary[카메라가 전혀 필요 없으신가요?]
이 페이지는 `prepareSelfieCamera`/`prepareDocumentCamera` 호출과 함께일 때만 적용되는 `setSilentInfo`를 다룹니다. 카메라 세션을 전혀 열지 않고 사일런트 검증을 수행하고 싶다면(예: 로그인 화면), 대신 [사일런트 재검증](./capture-types/silent-revalidation)에 문서화된 `initializeSDK` + `startSilentValidation`을 사용하세요. 두 경로 모두 같은 페이지에서 사용할 수 있습니다.
:::

캡처 세션에 사용자 및 플로우 메타데이터를 첨부하면 Unico 측의 모니터링 및 옵저버빌리티 도구에서 상관관계를 파악할 수 있으며, 백엔드가 이 거래에 대한 사일런트 재검증 결과에 해당 데이터를 반영할 수 있습니다. 데이터가 제공되면 캡처와 함께 전달되며 SDK의 캡처 동작은 변경하지 않지만 — Create Process 응답에는 영향을 미칩니다: [사일런트 재검증](./capture-types/silent-revalidation)의 `silentAuth.result`를 참고하세요.

## setSilentInfo 매개변수

| 매개변수 | 타입 | 필수 여부 | 설명 |
|---|---|:-:|---|
| `externalUserId` | `String` | ✅ | 귀하의 시스템에서 사용자 식별자. 전송 전 SHA-256으로 자동 해시 처리되며 — 평문으로 전송되지 않습니다. |
| `useCase` | `String` | — | 실행 중인 플로우 또는 컨텍스트의 식별자(예: `"account_opening"`, `"password_recovery"`). 평문으로 전송됩니다. |

## 구현

빌드된 카메라 인스턴스에서 `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);
```