# شرح أنواع الأجهزة

هناك ثلاثة أنواع من السجلات حول الأجهزة المسجلة في Pushwoosh:

*   [الأجهزة الإجمالية (Total Devices)](#total-devices)
*   [الأجهزة المفعلة للدفع (Push Enabled devices)](#push-enabled-devices)
*   [أجهزة تنبيهات الدفع المفعلة (Push Alerts Enabled devices)](#push-alerts-enabled-devices)

## الأجهزة الإجمالية (Total Devices)

يُشار إلى عدد **الأجهزة الإجمالية (Total Devices)** في حساب Pushwoosh الخاص بك — وهو الرقم الموجود على اليمين في الجزء العلوي الأيسر من لوحة التحكم (Control Panel).

تشمل **الأجهزة الإجمالية (Total Devices)** **جميع الأجهزة التي تم تسجيلها** في Pushwoosh وكانت **نشطة خلال الـ 90 يومًا الماضية**. قد تحتوي هذه الأجهزة على رموز دفع (push tokens) أو لا. الأجهزة التي لا تحتوي على رموز دفع يمكن الوصول إليها عبر رسائل داخل التطبيق (In-App Messages).

<Aside type="note">
رمز الدفع (Push token) هو مفتاح فريد يحدد تطبيقًا على جهاز معين؛ يتم إصداره بواسطة بوابات سحابية ويستخدم لتسليم إشعارات الدفع إلى الجهاز.
</Aside>

يتم تسجيل الجهاز بمجرد أن يفتح المستخدم التطبيق الذي يحتوي على Pushwoosh SDK لأول مرة بعد التثبيت. بمجرد تشغيل التطبيق، سيقوم SDK بإجراء عدة استدعاءات إلى الواجهة الخلفية لدينا، مثل `/applicationOpen` و `/getInApps`. على سبيل المثال:

```
Pushwoosh request:
 Url: https://api.pushwoosh.com/json/1.3/applicationOpen
 Payload: {"request": {"jailbroken": 0, "notificationTypes": 7,
"app_version": "1.11.2","application": "66716-7F06D","device_type": 1,
"userId": "76051F70-....-46B5-B4BA-F3FC94BD3534", "language": "en",
"hwid": "76051F70-....-46B5-B4BA-F3FC94BD3534","package": "com.pushwoosh.pushon",
"os_version": "12.1.4","v": "5.9.1","device_model": "iPhone10,1"}}
```

سيؤدي هذا إلى تسجيل جهاز بمعرف العتاد الخاص به (hwid) في قاعدة بيانات Pushwoosh ويجعله مؤهلاً لتلقي رسائل داخل التطبيق (In-App Messages)، وستزيد إحصائيات فتح التطبيق بمقدار واحد. بمجرد تسجيل الجهاز في قاعدة البيانات، يمكنك البدء في إرسال الوسوم (Tags) لذلك الجهاز وتعيين معرف مستخدم (User ID)، إذا لزم الأمر.

في هذه المرحلة، لا يوجد رمز دفع (push token) بعد، وسيقع هذا الجهاز ضمن فئة الأجهزة الإجمالية (Total Devices).

إذا لم يكن الجهاز نشطًا لأكثر من 90 يومًا، على سبيل المثال، لا توجد طلبات `/applicationOpen` من SDK الخاص بنا لذلك الجهاز، ولم يتم تشغيل أي أحداث (Events)، ولا يحتوي ذلك الجهاز على رمز دفع (push token)، فسيتم مسحه من قاعدة البيانات. فترة عدم النشاط هذه قابلة للتكوين؛ لإعادة تعيين فترة عدم النشاط، اتصل بمدير نجاح العملاء أو فريق دعم العملاء لدينا.

## الأجهزة المفعلة للدفع (Push Enabled devices)

الأجهزة المفعلة للدفع (Push Enabled) هي أجهزة مرتبطة برموز دفع (push tokens). هذا يعني أنه يمكنك إرسال إشعارات الدفع إلى هذه الأجهزة، وستقوم البوابات السحابية بتسليم إشعارات الدفع الخاصة بك.

يُشار إلى عدد الأجهزة المفعلة للدفع (Push Enabled devices) في حساب Pushwoosh الخاص بك — وهو الرقم الموجود على اليسار في الجزء العلوي الأيسر من لوحة التحكم (Control Panel).

بمجرد موافقة المستخدم على تلقي إشعارات الدفع، يتم إصدار رمز الدفع (push token) بواسطة البوابات السحابية، مثل APNS و FCM، ويرسل SDK الخاص بنا طلب API إلى نقطة نهاية [`/registerDevice`](../../api-reference/device-api#registerdevice) الخاصة بـ Pushwoosh مع هذا الرمز:

```
Pushwoosh request:
 Url: https://api.pushwoosh.com/json/1.3/registerDevice
 Payload: {"request": {"gateway": "production", "jailbroken": 0,
 "notificationTypes": 7, "app_version": "1.11.2", "application": "66716-7F06D",
 "sounds": ["bubble.wav"], "device_type": 1, "userId": "76051F70-....-46B5-B4BA-F3FC94BD3534",
 "language": "en", "hwid": "76051F70-....-46B5-B4BA-F3FC94BD3534",
 "package": "com.pushwoosh.pushon", "timezone": "25200", "os_version": "12.1.4",
 "push_token": "9c943351faaa7080a1c076343521.......17d220a0c68f42125cd98bb",
 "v": "5.9.1", "device_model": "iPhone10,1"}}
```

الآن، بما أن لدينا رمز دفع (push token) مسجل في قاعدة بياناتنا لجهاز ما، فإنه يعتبر مفعلًا للدفع (Push Enabled)، ويمكنك البدء في إرسال إشعارات الدفع إلى ذلك الجهاز.

<Aside type="note">
عمليًا، حتى لو كان هناك رمز دفع (push token) مرتبط بجهاز ما، قد لا يرى بعض المستخدمين إشعارات الدفع في حال قاموا بتعطيل التنبيهات يدويًا من إعدادات أجهزتهم. يمكن الوصول إلى هؤلاء المستخدمين عبر إشعارات الدفع الصامتة (Background (silent) pushes)، والرسائل داخل التطبيق (In-App Messages)، ويمكنهم تلقي الإشعارات في صندوق الوارد (Inbox). انظر [أجهزة تنبيهات الدفع المفعلة (Push Alerts Enabled)](#push-alerts-enabled-devices) لمزيد من المعلومات.
</Aside>

عندما ترسل إشعار دفع، تعيد لنا APNS و FCM حالة رمز الدفع (push token) لكل مستلم. إذا تم وضع علامة على أي رمز بأنه غير صالح أو غير موجود، فسنقوم بإزالته من قاعدة البيانات، وسينخفض عدد الأجهزة المفعلة للدفع (Push Enabled devices) وفقًا لذلك.

عندما يتم إزالة رمز الدفع (push token) من النظام، لم يعد الجهاز في فئة الأجهزة المفعلة للدفع (Push Enabled) ولكنه يظل في الأجهزة الإجمالية (Total Devices). إذا فتح المستخدم التطبيق بعد ذلك، سيتم تعيين رمز دفع (push token) جديد للجهاز ويعود إلى الأجهزة المفعلة للدفع (Push Enabled devices). إذا لم يكن هناك نشاط في غضون 90 يومًا بعد إزالة الرمز، يتم مسح الجهاز تمامًا من قاعدة البيانات.

## أجهزة تنبيهات الدفع المفعلة (Push Alerts Enabled devices)

يمكن لأجهزة تنبيهات الدفع المفعلة (Push Alerts Enabled devices) عرض تنبيهات إشعارات الدفع خارج التطبيق: على شاشة القفل، في مركز الإشعارات، أو كشارة على أيقونة التطبيق. يعتمد ذلك على ما إذا كان المستخدم يمكّن أو يعطّل تنبيهات إشعارات الدفع من إعدادات جهازه.

يتم تمييز الأجهزة التي تم تمكين التنبيهات فيها بقيمة "True" للوسم الافتراضي "Push Alerts Enabled"، بينما يتم تمييز الباقي بـ "False". يمكنك التحقق من ذلك في إحصائيات الوسوم (Tags) الخاصة بك. يتتبع هذا الوسم عدد المستخدمين الذين يمكنهم بالفعل تلقي تنبيهات إشعارات الدفع عندما يكون التطبيق في الخلفية أو مغلقًا.

وسم "Push Alerts Enabled" هو وسم افتراضي ويتم جمعه تلقائيًا بواسطة Pushwoosh SDK. يتطلب أحدث إصدارات Pushwoosh SDK (التي تم إصدارها في خريف 2018 أو أحدث).

<Aside type="caution" title="هام">


لا يمكن تحديث حالة التنبيهات في Pushwoosh إلا إذا فتح المستخدم التطبيق مرة واحدة على الأقل بعد تغيير تفضيلات الإشعارات في إعدادات الجهاز. في حال سمح المستخدم بتنبيهات إشعارات الدفع ولكنه لم يفتح التطبيق، فلن نتعرف على هذا المستخدم كواحد من مستخدمي "Push Alerts Enabled"؛ لهذا السبب من المهم جدًا أن تستهدف جميع الأجهزة التي تحتوي على رموز لضمان أقصى وصول.
</Aside>

تمنحك مقارنة الأجهزة المفعلة للدفع (Push Enabled) وأجهزة تنبيهات الدفع المفعلة (Push Alerts Enabled devices) صورة أفضل عن معدلات الاشتراك ويمكن أن تساعد في اختيار قناة الاتصال المناسبة للتفاعل مع الجمهور الأوسع. يتيح لك بناء شريحة من الأجهزة ذات التنبيهات المعطلة الوصول إليها عبر قنوات بديلة وتحفيزها على إعادة تمكين تنبيهات الإشعارات.