ضع عدد غير المقروء على أيقونة تطبيقك
الشارة أصغر ما يمكنك قوله للمستخدم، ولا تكلّفه شيئاً لقراءتها. اضبطها أو زِدها أو صفّرها من الحملة ورحلة العميل نفسيهما اللتين ترسل منهما كل شيء آخر.
أكثر من 80,000 شركة تثق بنا لتوسيع تفاعل عملائها
الصيغة بالكامل
الشارة عدد صحيح واحد، وهذا سرّ جاذبيتها. لا تستهلك لافتة ولا صوتاً، ولا تستنفد شيئاً من إذن الإشعارات الذي بذلت جهداً للحصول عليه، وتواصل عملها مع المستخدم الذي أزاح إشعارك قبل ثلاث ساعات. هناك ثلاثة أمور يمكنك فعلها بهذا العدد من المحرر أو من API، إضافة إلى تنبيه واحد بشأن مكان ظهوره فعلياً.
عدد محدد
ios_badges: 5 يضع الرقم 5 على الأيقونة أياً كان ما سبقه. القيمة التي ترسلها هي القيمة التي يراها المستخدم، وهذا ما تريده عندما يعرف خادمك المجموع الحقيقي مسبقاً.
+1 و-1
التغييرات النسبية ترفع العدد أو تخفضه دون أن تتتبعه بنفسك. ترسل SDK القيمة الموجودة على الجهاز عبر نقطة النهاية الداخلية /setBadge، فيبقى عدّاد Pushwoosh مطابقاً للأيقونة الحقيقية.
0 يمسحها
أرسل 0 فتختفي الشارة من الأيقونة. المسح عند فتح التطبيق هو الفرق بين عدد يثق به المستخدمون ونقطة حمراء يتعلمون تجاهلها.
موحّدة على iOS، ومرتبطة بالمشغّل على Android
على iOS الشارة قيمة aps.badge قياسية، وكل جهاز يرسمها بالطريقة نفسها. أما Android فلا يملك API أصلية للشارات، لذا يعتمد ظهورها على المشغّل (Launcher)، وPushwoosh تصرّح بذلك بدلاً من الإيحاء بتغطية لا تستطيع تقديمها.
ما الذي تتحكم به
| ما ترسله | ما يحدث للعدد | أين يوجد |
|---|---|---|
عدد صحيح، 5 | يضبط الشارة على هذه القيمة بالضبط | ios_badges / android_badges، أو حقل Badges |
+1، +3 | يزيد العدد الحالي | الحقل نفسه. وأيضاً +n في إعدادات Android المسبقة |
-1 | ينقص العدد الحالي | الحقل نفسه، عند قراءة أو تجاهل من جهة الخادم |
0 | يزيل الشارة من الأيقونة | الحقل نفسه، أو التطبيق عند تشغيله |
| استدعاء SDK | يضبط الشارة أو يمسحها من حدث داخل التطبيق | setApplicationIconBadgeNumber على iOS، وPushwooshBadge على Android |
| لا شيء | تطبّق SDK أي شارة وصلت مع الإشعار | بلا كود في التطبيق للحالة الأساسية على iOS |
| امتداد (Extension) | يغيّر العدد قبل عرض الإشعار | PWNotificationExtensionManager مع App Groups |
5ios_badges / android_badges، أو حقل Badges+1، +3+n في إعدادات Android المسبقة-10setApplicationIconBadgeNumber على iOS، وPushwooshBadge على AndroidPWNotificationExtensionManager مع App Groupsأين تضبطها
حقل Badges في المحرر
يقبل نموذج Send-Push والإعدادات المسبقة للإشعارات رقماً أو +n أو -n أو 0. تغيير ما تفعله الحملة بالعدد لا يحتاج إلى إصدار ولا إلى مطوّر.
مفتاح واحد في API
ios_badges وandroid_badges في /createMessage. على iOS تُكتب القيمة في حقل aps.badge ضمن الحمولة التي تنقلها Apple أصلاً.
تطبّقها SDK وتزامنها
تطبّق SDK القيمة الواردة دون كود في التطبيق، وتُبقي تصوّر الخادم للشارة محدّثاً عبر /setBadge، فيبدأ +1 العدّ من الرقم الصحيح.
دورها داخل رحلة العميل
عدد واحد، ومصادر متعددة
الشارة سمة لرسالة ترسلها أصلاً، لذا لا تحتاج إلى تكامل خاص بها. رحلة العميل نفسها وملف العميل نفسه اللذان يقرران من يتلقى الإشعار يقرران أيضاً ما يصبح عليه العدد.
فالسؤال الوحيد المتبقي هو: ما الذي يغذّي الرقم؟ يمكن أن يكون مجموع غير المقروء في صندوق الرسائل هو العدد مباشرة، ويمكن لإشعار صامت أن يحرّكه دون أي تنبيه، ويحمله إشعار التطبيق المرئي معه. وخطوة عند هدف الرحلة تعيده إلى 0.
ثلاث مكافآت تتراكم أثناء غياب اللاعب
كل مكافأة تُمنح تطلق حدثاً، وكل حدث يرسل إشعاراً صامتاً يضيف +1. لا رنين، ولا إضاءة لشاشة القفل، وبحلول المساء تُظهر الأيقونة الرقم 3 بهدوء.
وعندما تبدأ الفعالية المباشرة، كفعالية خاصة بعد الإفطار في رمضان مثلاً، ترسل الرحلة نفسها إشعاراً مرئياً واحداً يستحق المقاطعة. وأياً كان ما يعيد اللاعب، تصفّر SDK الشارة إلى 0 عند التشغيل، فيبدأ عدد الغد من رقم صحيح.
فيمَ تستخدمها
تتناسب فائدة الشارة مع كثافة العدّ: هل لدى تطبيقك عدد حقيقي ومتزايد من العناصر غير المقروءة أو المعلّقة يستحق الظهور على الأيقونة؟ التطبيقات المبنية حول عدّاد تحصل على دفعة حقيقية لإعادة التفاعل مجاناً، والتطبيقات التي لا شيء فيها لتعدّه تحصل على نقطة حمراء تعلّم المستخدمين تجاهل النقاط الحمراء.
| اللحظة | ماذا يعني الرقم | لماذا تناسب الشارة |
|---|---|---|
| ألعاب الجوال: مكافآت، أرواح متجددة، دخول فعاليات | 3 أشياء لجمعها | العدد جزء من حلقة الاحتفاظ أصلاً، والجمع هو الدافع كله |
| تطبيقات صنّاع المحتوى والاشتراكات: إصدارات، رسائل مباشرة، تعليقات | 12 غير مقروءة | الموجز الاجتماعي يحتفظ بهذا الرقم داخلياً، فلا يبقى على الأيقونة سوى عرضه |
| الإعلام والأخبار: قصص غير مقروءة، حلقات جديدة | 5 قصص غير مقروءة | الحالة النموذجية، والتي تعيد القارئ إلى جلسة جديدة بشكل موثوق |
| التجارة الإلكترونية والأسواق: عناصر في السلة، عروض غير مقروءة | منتجان في سلتك | تذكير هادئ لا يكلّف المتسوّق شيئاً من انتباهه |
| التكنولوجيا المالية: كشوف حساب، تنبيهات، إجراءات معلّقة | إجراء واحد مطلوب | هناك عدد حقيقي من المستندات غير المقروءة، والأيقونة تحمله دون كشف التفاصيل على شاشة القفل |
| التداول والمراهنات: تنبيهات مفعّلة، رهانات مسوّاة | 4 تنبيهات أُطلقت | تتراكم التنبيهات في رقم له معنى فعلي للمستخدم |
| الرعاية الصحية والطب عن بُعد: نتائج، رسائل آمنة | نتائجك جاهزة | العدد يظهر على الشاشة الرئيسية بينما يبقى المحتوى خلف المصادقة |
| التعليم الرقمي: دروس غير مقروءة، سلاسل إنجاز، واجبات | درسان بانتظارك | سلسلة الإنجاز أو قائمة الدروس هي بالضبط نوع الأرقام التي يحب الناس إنهاءها |
متى تكون الشارة الأداة الخاطئة
الشارة تُبلغ عن كمية. أما كل ما يتعلق بماهية ما ينتظر ومدى إلحاحه فمكانه سطح آخر.
- المستخدم يحتاج إلى معرفة ما وصل: هذا عمل إشعار التطبيق أو إشعار الوسائط الغنية أو الرسالة داخل التطبيق.
- اللحظة لا تحتمل الانتظار. الشارة سلبية بطبيعتها، والإلحاح مكانه مستوى المقاطعة.
- الحالة مستمرة وليست معدودة: طلب في الطريق، أو نتيجة مباراة جارية. هذا عمل Live Activity.
- التطبيق لا يملك عدداً متزايداً بطبيعته. التأمين والفنادق والمرافق والأدوات أحادية الجلسة لديها فاتورة واحدة أو حجز واحد، والشارة هناك مجرد ضجيج.
- جمهورك يغلب عليه Android والشارة ستكون آلية أساسية. تعامل معها هناك كأفضل جهد، وصمّم المسار ليعمل بدونها.
التغطية التقنية والمنصات
في iOS شارة واحدة، وكل iPhone يرسمها بالطريقة نفسها. أما Android فلا يملك API عامة للشارات، لذا ما يظهر على الشاشة الرئيسية يعتمد على المشغّل الذي يستخدمه المستخدم. يسمّي العمود الأخير الجهة التي ترسم الرقم فعلاً، لأن الإجابة الصادقة لهذه الميزة تكمن هناك.
| الإمكانية | iOS | Android | الويب | يتولاها |
|---|---|---|---|---|
| قيمة شارة محددة | نعم، aps.badge قياسية | أفضل جهد، حسب المشغّل | – | حمولة الإشعار، تطبّقها SDK |
+1 و-1 النسبيان | نعم، Pushwoosh SDK 6.4.0+ | +n في الإعدادات المسبقة، حسب المشغّل | – | الإشعار، مع /setBadge لمزامنة العدّاد |
التصفير إلى 0 | نعم | حسب المشغّل | – | حمولة الإشعار، أو التطبيق عند التشغيل |
| حقل Badges بدون كود | نعم، في المحرر والإعدادات المسبقة | نعم، قيمة شارة في الإعدادات المسبقة | – | لوحة تحكم Pushwoosh |
| الضبط أو المسح من كود التطبيق | setApplicationIconBadgeNumber | PushwooshBadge | – | تطبيقك، عبر Pushwoosh SDK |
| تغيير العدد قبل العرض | نعم، في Notification Service Extension | – | – | PWNotificationExtensionManager مع App Groups |
| تحديث الشارة بلا تنبيه | نعم | أفضل جهد | – | إشعار صامت، بالجمهور والرحلة نفسيهما |
| تغطية المشغّلات والأجهزة | كل iPhone، بشكل متطابق | Sony وSamsung وLG وHTC وASUS وADW وAPEX وNOVA وHuawei وZUK وOPPO | – | com.pushwoosh:pushwoosh-badge مع أذونات المشغّلات |
| Pixel والمشغّلات غير المدعومة | لا ينطبق | – | – | لا توجد API أصلية للشارات في Android، فلا يظهر شيء |
| قراءة العدد الحالي من النظام | – | – | – | لا يوفّر iOS أي API للقراءة، فالعدد يعيش في تطبيقك أو على الخادم |
| شارة على أيقونة التطبيق أصلاً | نعم | حسب المشغّل | – | لا تملك المتصفحات سطحاً مماثلاً لإشعار الويب |
aps.badge قياسية+1 و-1 النسبيان+n في الإعدادات المسبقة، حسب المشغّل/setBadge لمزامنة العدّاد0setApplicationIconBadgeNumberPushwooshBadgePWNotificationExtensionManager مع App Groupscom.pushwoosh:pushwoosh-badge مع أذونات المشغّلاتالأمان والاستضافة
تعمل Pushwoosh على خوادمها الخاصة في الولايات المتحدة وألمانيا، بموجب GDPR.
كيف يعمل
ضبط الشارة بدون كود ومجاني في كل باقة. وقت التطوير يتركز في موضعين محددين، وليست الحالة الأساسية على iOS أحدهما.
-
حدّد العدد (بدون كود)
اكتب رقماً أو
+nأو-nأو0في حقل Badges ضمن نموذج Send-Push أو إعداد مسبق، أو أرسلios_badgesوandroid_badgesعبر Messages API. على iOS لا تحتاج الحالة الأساسية إلى أي شيء من تطبيقك: تطبّق SDK القيمة عند الوصول. -
اربط الموضعين اللذين يحتاجان إليه (مطوّر)
يحتاج Android إلى مكتبة
com.pushwoosh:pushwoosh-badgeإضافة إلى أذونات المشغّلات في ملف manifest. المسح عند فتح الإشعار وتشغيل التطبيق استدعاء SDK واحد، وNotification Service Extension مع App Groups مطلوبة فقط للأعداد التي يجب أن تتغير قبل العرض. -
نسّقها (بدون كود)
غذِّ الرقم من مجموع غير المقروء في صندوق الرسائل، وحرّكه بإشعار صامت لا يعرض أي تنبيه، وصفّره عند هدف رحلة العميل نفسها التي تدير إشعاراتك ورسائلك داخل التطبيق وبريدك الإلكتروني.
حدود يجب معرفتها
استكشف المنتجات ذات الصلة
منصة Pushwoosh لإشعارات الجوال الفورية: وصول لكل جهاز، محتوى غني وروابط عميقة، استهداف دقيق، ورحلات متعددة القنوات بموثوقية 99% وشهادات SOC 2 وISO 27001.
يضيف Message Inbox مركز إشعارات داخل تطبيقك وموقعك. التسليم الصامت يصل إلى كل مستخدم، حتى من رفض الإشعارات الفورية، وتبقى الرسائل محفوظة.
رسم وتبسيط حملاتك باستخدام أداة بصرية واحدة. تواصل، تفاعل، احتفظ، حوّل، قسّم، وجرّب باستخدام منشئ رحلة العميل من Pushwoosh.
رسائل Pushwoosh داخل التطبيق: أكمل الإعداد والبيع الإضافي والإعلانات وجمع الملاحظات في اللحظة التي يكون فيها مستخدمو التطبيق منتبهين. محرر بدون كود، قوالب SDK أصلية، تحليلات لكل عنصر. متوافقة مع GDPR ومعتمدة ISO 27001. ابدأ مجاناً.
اضبط مستوى المقاطعة في iOS للإشعار الذي ترسله بالفعل، ليتجاوز تنبيه الاحتيال أو تغيير البوابة وضع Focus والملخص المجدول. بلا كود في لوحة تحكم Pushwoosh.
منصة إشعارات دفع محمولة مخصصة لتطبيقات الألعاب. أرسل تنبيهات مخصصة، وعروضًا خاصة، وتذكيرات بالأحداث للحفاظ على عودة اللاعبين.