---
title: البيانات الوصفية للجهاز
description: قدرة تُعيد البيانات الوصفية للجهاز المستخدم في الالتقاط، مثل المنصة وعنوان IP والموقع وإشارات المخاطر المكتشفة عليه.
canonical: https://developer.unico.io/ar/capabilities/device-metadata
locale: ar
generated_by: markdown-export
---

# البيانات الوصفية للجهاز

تُعيد هذه القدرة بيانات الجهاز الذي أجرى منه المستخدم الالتقاط، إلى جانب نتائج المنتجات الأخرى المتعاقد عليها.

### ما الذي تفعله

تجمع البيانات الوصفية للجهاز المستخدم في جلسة الالتقاط وإشارات المخاطر المكتشفة عليه (تفاصيل البيانات أدناه).

هي ليست عملية تحقق: لا توافق على العملية ولا ترفضها أبداً، ولا تتسبب أبداً في فشلها. استخدم البيانات في قواعد المخاطر الخاصة بك أو في محركات القرار الداخلية لديك.

### المدخلات

لا حاجة إلى أي حقل إضافي. تستخدم القدرة جلسة الالتقاط الموجودة بالفعل في العملية.

- **Web:** الالتقاط الذي يتم في رحلة Unico.
- **API مع Unico SDK:** الال تقاط الذي يُجريه Unico SDK داخل تطبيقك.

> **البيانات الوصفية تعتمد على Unico SDK:** Unico SDK هو الذي يجمع البيانات الوصفية أثناء الالتقاط. قد يستخدم تكامل API الـ Unico SDK وقد لا يستخدمه:
>
> - **API مع Unico SDK:** تُعاد البيانات الوصفية كالمعتاد.
> - **API بدون Unico SDK:** لا توجد بيانات وصفية، وتكون الاستجابة `not_found`.

يتم تفعيل القدرة في تدفق متعاقد عليه لحسابك. تواصل مع جهة اتصالك في Unico لتفعيلها.

### الاستجابات المحتملة

تأتي النتيجة في الكائن `authenticationInfo.deviceMetadata` من [الحصول على العملية](/ar/developers/api-reference/get-process).

| `status` | المعنى |
| --- | --- |
| `found` | تم العثور على البيانات الوصفية للجهاز. الحقول أدناه مملوءة بما جمعه الجهاز. |
| `not_found` | لا توجد بيانات وصفية للجهاز لهذا الالتقاط، على سبيل المثال عملية API بدون Unico SDK. |
| `unavailable` | تعذّر جلب البيانات الوصفية في تلك اللحظة. لا تتأثر نتيجة العملية. |

عندما تكون قيمة `status` هي `found`:

| الحقل | النوع | الوصف |
| --- | --- | --- |
| `deviceId` | string | معرّف الجهاز. |
| `platform` | string | المنصة التي جاء منها الالتقاط، مثل `WEB`، `ANDROID`، `IOS`. |
| `ip` | string | عنوان IP للجهاز. |
| `ipCountry` | string | دولة عنوان IP. |
| `ipGeoCoordinates` | object | موقع عنوان IP (`lat`، `lng`). |
| `gpsCoordinates` | object | الموقع الذي أبلغ عنه GPS الجهاز (`lat`، `lng`). |
| `osName` | string | اسم نظام التشغيل. |
| `osVersion` | string | إصدار نظام التشغيل. |
| `browserName` | string | اسم المتصفح. Web فقط. |
| `userAgent` | string | وكيل المستخدم (user agent) للمتصفح. Web فقط. |
| `appStore` | string | متجر التطبيقات الذي تم تثبيت تطبيقك منه. SDK الأصلي فقط. |
| `detectedSignals` | مصفوفة سلاسل نصية | مجموعات إشارات المخاطر المكتشفة على الجهاز. تكون فارغة عندما لا يُكتشف أي منها. |

غياب أي حقل يعني أن الجهاز لم يجمع تلك البيانات.

تُدرج `detectedSignals` المجموعات المكتشفة فقط. تُعدّ المجموعة مكتشفة عند العثور على إشارة واحدة على الأقل من إشاراتها:

| المجموعة | ما تعنيه |
| --- | --- |
| `origin_obfuscated` | المصدر الحقيقي للوصول مخفي، على سبيل المثال عبر Tor أو أدوات مكافحة البصمة الرقمية. |
| `untrusted_location` | قد يكون الموقع مزيفاً، على سبيل المثال عبر وكيل (proxy) أو VPN أو أداة لتزييف GPS. |
| `environment_altered` | بيئة الجهاز معدّلة، على سبيل المثال محاكٍ أو جهاز مُخترق صلاحياته (root أو jailbreak). |
| `app_manipulated` | تم العبث بالتطبيق أو اعتراضه (hooking) أو تصحيحه بأداة تصحيح الأخطاء. |
| `assisted_session` | قد يكون شخص آخر هو من يتحكم في الجلسة، على سبيل المثال عبر مشاركة الشاشة أو بوت. |
| `payload_untrusted` | تم العبث بالبيانات المرسلة من الجهاز. |

ليست كل إشارة موجودة على كل منصة، لذلك قد يُظهر الجهاز نفسه مجموعات مختلفة على Web وعلى SDK الأصلي.

### التوافر

| مكونات التكامل المطلوبة |
| --- |
| SDK  Web or SDK |

### التوليفات الصالحة

البيانات الوصفية للجهاز ليست جزءاً من التدفقات المُعدّة مسبقاً في [التدفقات المتاحة](/ar/developers/start/flows). يمكن تفعيلها مع أي منتج آخر من Unico في تكاملات Web وSDK، في تدفق متعاقد عليه لحسابك.

### المنتجات التي تستخدم هذه القدرة

يمكن إضافتها إلى أي منتج من Unico في تكاملات Web وSDK.

آخر تحديث في **28 أكتوبر 2026**