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

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

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

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

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

### المدخلات

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

- **عقد Web و Native:** يتم تفعيلها في تدفق متعاقد عليه لحسابك. تُدرج العملية `PROCESS_CAPACITY_DEVICE_METADATA` في `capacities`.
- **عقد API:** يتم تفعيلها في Recipe الخاصة بمفتاح API لديك.

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

تواصل مع جهة اتصالك في Unico لتفعيلها.

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

تأتي النتيجة في كائن `deviceMetadata`:

- **عقد Web و Native:** في `authenticationInfo.deviceMetadata` من [الحصول على العملية](/dual-api/developers/api-reference/web-sdk/get-process).
- **عقد API:** في `deviceMetadata` من [الحصول على العملية](/dual-api/developers/api-reference/api/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` | مصفوفة سلاسل نصية | مجموعات إشارات المخاطر المكتشفة على الجهاز. تكون فارغة عندما لا يُكتشف أي منها. |

الحقل الذي لم يجمعه الجهاز يكون غائباً في عقد Web و Native، وتكون قيمته `null` في عقد API.

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

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

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

### التوافر

| السطح | مدعوم |
|---|:-:|
| **SDK** (Android, iOS, Flutter) | ✅ |
| **Web** (iFrame, Redirect) | ✅ |

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

البيانات الوصفية للجهاز ليست جزءاً من كتالوج `flow` المُعدّ مسبقاً في [التدفقات المتاحة](/dual-api/capabilities/available-flows). يتم تفعيلها في تدفق متعاقد عليه لحسابك (عقد Web و Native) أو في Recipe الخاصة بمفتاح API لديك (عقد API)، ويمكن تفعيلها مع أي منتج آخر من Unico في تكاملات Web وSDK.

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

يمكن إضافتها إلى أي حالة استخدام من Unico في تكاملات Web وSDK.