---
title: モニタリングデータ収集
description: 監視・オブザーバビリティツールでユーザーとフローを識別するために、任意のキャプチャセッションに添付できるオプションのメタデータです。
canonical: https://developer.unico.io/ja/dual-api/developers/sdks-and-tools/web/web-sdk/capture-flow/monitoring-data-collection
locale: ja
generated_by: markdown-export
---

:::info[オプション実装]
モニタリングデータ収集は**オプション**です。採用する場合、**`prepareSelfieCamera` 呼び出しのみが影響を受けます** — キャプチャフローの他のすべてのステップ（初期化、コールバック、結果処理）は変更されません。
:::

:::secondary[そもそもカメラが不要な場合は?]
このページでは、`prepareSelfieCamera`/`prepareDocumentCamera` の呼び出しと組み合わせた場合にのみ効果を持つ `setSilentInfo` について説明します。カメラセッションを一切開かずにサイレント検証を行いたい場合（ログイン画面など）は、代わりに `initializeSDK` + `startSilentValidation` を使用してください — 詳細は[サイレント再検証](./capture-types/silent-revalidation)を参照してください。どちらも同じページで使用できます。
:::

キャプチャセッションにユーザーとフローのメタデータを添付することで、Unico 側の監視・オブザーバビリティツールで相関付けることができるだけでなく、バックエンドがこの取引のサイレント再検証の結果にそのメタデータを反映できるようになります。提供された場合、データはキャプチャと一緒に転送され、SDK のキャプチャ動作は変更されません — ただし、Create Process のレスポンスには影響します。詳細は[サイレント再検証](./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);
```