---
title: جمع بيانات المراقبة
description: بيانات وصفية اختيارية يمكنك إرفاقها بأي جلسة التقاط لتحديد هوية المستخدم والتدفق في أدوات المراقبة والرصد.
canonical: https://developer.unico.io/ar/dual-api/developers/sdks-and-tools/web/web-sdk/capture-flow/monitoring-data-collection
locale: ar
generated_by: markdown-export
---

:::info[تنفيذ اختياري]
جمع بيانات المراقبة **اختياري**. إذا اعتمدته، **فإن استدعاء `prepareSelfieCamera` فقط هو المتأثر** — تبقى جميع الخطوات الأخرى في تدفق الالتقاط (التهيئة، وردود الاستدعاء، ومعالجة النتائج) دون تغيير.
:::

:::secondary[لا تحتاج إلى الكاميرا إطلاقًا؟]
تتناول هذه الصفحة `setSilentInfo`، الذي لا يصبح فعالًا إلا مع استدعاء `prepareSelfieCamera`/`prepareDocumentCamera`. إذا كنت تريد التحقق الصامت دون فتح جلسة كاميرا إطلاقًا (مثلاً، شاشة تسجيل الدخول)، استخدم `initializeSDK` + `startSilentValidation` بدلاً من ذلك — راجع [إعادة التحقق الصامتة](./capture-types/silent-revalidation). يمكن استخدام الاثنين معًا في نفس الصفحة.
:::

أرفق بيانات المستخدم والتدفق الوصفية بجلسة الالتقاط حتى يمكن ربطها في أدوات المراقبة والرصد على جانب Unico، وحتى يتمكن الخادم الخلفي (backend) من أخذها في الاعتبار ضمن نتيجة إعادة التحقق الصامتة لهذه المعاملة. عند توفيرها، تُرسَل البيانات مع الالتقاط ولا تغيّر سلوك الالتقاط في SDK — لكنها تؤثر على استجابة إنشاء العملية (Create Process): راجع `silentAuth.result` في [إعادة التحقق الصامتة](./capture-types/silent-revalidation).

## setSilentInfo parameters

| المعامل | النوع | مطلوب | الوصف |
|---|---|:-:|---|
| `externalUserId` | `String` | ✅ | معرّف المستخدم في نظامك. يُجزَّأ تلقائيًا بخوارزمية SHA-256 قبل الإرسال — لا يُرسَل أبدًا كنص عادي. |
| `useCase` | `String` | — | معرّف التدفق أو السياق الجاري (مثلاً، `"account_opening"`، `"password_recovery"`). يُرسَل كنص عادي. |

## Implementation

استدعِ `setSilentInfo` على نسخة الكاميرا المُنشأة **قبل** استدعاء `prepareSelfieCamera`. يبقى كل شيء آخر في تدفق الالتقاط كما هو.

```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);
```