صمّم الإشعار الذي يصل وتطبيقك مفتوح
عندما يصل إشعار فوري والتطبيق مفتوح، يترك iOS القرار لك. تعرضه Pushwoosh iOS SDK كلافتة متحركة بألوانك وخطوطك، مع مادة Liquid Glass من Apple على iOS 26.
أكثر من 80,000 شركة تثق بنا لتوسيع تفاعل عملائها
الصيغة بالكامل
الإشعار الذي يصل وتطبيقك في المقدمة مسألة يجب أن يحلها تطبيقك. فـ iOS سيضع لافتة النظام البسيطة فوق واجهتك، أو لن يعرض شيئاً، والرسالة التي بنيت حولها رحلة عميل كاملة تصل كإطار رمادي باهت. وحدة PushwooshForegroundPush تعرض الحمولة نفسها كلافتة تملكها أنت.
Liquid Glass (iOS 26)
فعّل useLiquidView فتُرسم اللافتة بمادة Liquid Glass من Apple، فتبدو جزءاً من iOS 26 لا طبقة ملصقة فوق شاشتك.
لافتة قياسية (iOS 13 إلى 25)
في الإصدارات الأقدم من iOS 26 يعرض الاستدعاء نفسه لافتة صلبة بتدرجك وألوانك، وتعود أدوات Swift الأقدم إلى عرض ضبابي. إعداد واحد يغطي الحالات الثلاث.
صورة بطاقة وGIF
العنوان والرسالة وصورة البطاقة وGIF متحرك، كلها تُقرأ من الحمولة التي يحملها الإشعار أصلاً.
الحركة والاهتزاز ومدة العرض
حركة دخول، وإخفاء بنمط balls أو regularPush، واهتزاز عند الوصول من بين سبعة مستويات، ومدة بالثواني قبل أن تختفي اللافتة تلقائياً.
ما الذي تتحكم به
| الخاصية | ما تضبطه | القيم |
|---|---|---|
useLiquidView | مادة Liquid Glass على iOS 26 | Bool، القيمة الافتراضية false |
gradientColors، backgroundColor | السطح الذي تُرسم عليه اللافتة | ألوان علامتك |
titlePushColor، messagePushColor | لون النص في السطرين | ألوان علامتك |
titlePushFont، messagePushFont | خطوط السطرين | أي خط يتضمنه تطبيقك، بما فيها الخطوط العربية |
usePushAnimation | حركة الدخول | Bool، القيمة الافتراضية true |
duration | مدة بقاء اللافتة قبل اختفائها | بالثواني |
vibration | الاهتزاز عند الوصول | none، light، medium، heavy، soft، rigid، notification |
disappearedPushAnimation | طريقة خروج اللافتة من الشاشة | balls أو regularPush |
style | التخطيط المدمج | style1، الوحيد المتاح حالياً |
useLiquidViewfalsegradientColors، backgroundColortitlePushColor، messagePushColortitlePushFont، messagePushFontusePushAnimationtruedurationvibrationnone، light، medium، heavy، soft، rigid، notificationdisappearedPushAnimationballs أو regularPushstylestyle1، الوحيد المتاح حالياًأين تضبطها
استدعاء واحد عند التشغيل
foregroundNotificationWith(style:duration:vibration:disappearedPushAnimation:) في didFinishLaunchingWithOptions، إضافة إلى خصائص المظهر. يُضبط مرة واحدة للتطبيق كله.
استدعاء واحد عند الوصول
showForegroundPush(userInfo:) من استدعاء PWMessagingDelegate.onMessageReceived يعرض اللافتة مباشرة من حمولة الرسالة.
Delegate واحد للنقر
PWForegroundPushDelegate.didTapForegroundPush(userInfo:) يسلّمك الحمولة كاملة، فيفتح النقر الرابط العميق في المكان الذي قصدته الحملة بالضبط.
دوره داخل رحلة العميل
إشعار واحد، ثلاث طرق عرض
لافتة المقدمة طريقة عرض لرسالة ترسلها أصلاً. الشريحة نفسها، والمشغّل نفسه، والحمولة نفسها، والخطوة نفسها في رحلة العميل نفسها. ما يتغير هو ما يفعله الجهاز بها عند وصولها.
عندما يكون التطبيق مغلقاً، تصل الرسالة كإشعار نظام عادي أو تحدّث Live Activity. وعندما يكون مفتوحاً، ترسم SDK هذه اللافتة. وعندما تستحق اللحظة شاشة كاملة بعرض أو نموذج، تنتقل الرحلة نفسها إلى رسالة داخل التطبيق.
خبر عاجل بينما القارئ في منتصف مقال
حدث تحريري يطلق الرحلة. إشعار صامت يجهّز المقال في الخلفية دون أن يراه القارئ، ويتبعه التنبيه بعد ثانية.
القرّاء الذين أغلقوا التطبيق يرون إشعار النظام على شاشة القفل. أما القرّاء داخل التطبيق فيرون لافتة الصحيفة الخاصة تنزلق فوق المقال الذي يقرؤونه، مع صورة مصغّرة، ونقرة واحدة تنقلهم بالرابط العميق إلى الخبر الجديد. وصندوق الرسائل يحتفظ بالتنبيه في الحالتين.
فيمَ تستخدمه
لا يمكن للافتة أن تظهر إلا والمستخدم داخل تطبيقك، لذا ترتبط قيمتها بكثافة الجلسات: كم من إرسالاتك يصل إلى شاشة مفتوحة أصلاً. التطبيقات ذات الجلسات الطويلة تستفيد منها أكثر، والتطبيقات التي تصل رسائلها إلى هاتف في الجيب تستفيد قليلاً جداً.
| اللحظة | ما تقوله الرسالة | لماذا تناسب اللافتة |
|---|---|---|
| الإعلام والأخبار: خبر عاجل خلال جلسة قراءة | صدر الحكم | القارئ داخل التطبيق أصلاً، ولافتة النظام تقطع تصميم الصحيفة الخاص |
| البث: إصدار جديد خلال مشاهدة حلقة | الموسم الثالث متاح الآن | يمكن للتنبيه أن يحمل صورة المسلسل بدلاً من الوصول كإطار نظام |
| ألعاب الجوال: فعالية أو مكافأة خلال مباراة | دورك الآن: الغارة تبدأ بعد 5 دقائق | الجلسات الطويلة تعني أن معظم الإشعارات تصل أثناء اللعب، ولافتة تطابق التصميم تنسجم مع واجهة اللعبة |
| تطبيقات صنّاع المحتوى والاشتراكات: إصدار جديد أو تذكير بالتجربة | جديد من فنان تتابعه | التطبيق المصمم بعناية لا ينبغي أن يسلّم هذه اللحظة للنظام، والنقر يفتح صفحة الاشتراك مباشرة |
| الرياضة المباشرة: هدف أثناء المشاهدة داخل التطبيق | 1-0، الدقيقة 68 | فتح المستخدم التطبيق من أجل الحدث ويتابعه لحظة وصول الإشعار |
| التجارة الإلكترونية والأسواق: انخفاض سعر أثناء التصفح | عاد مقاسك إلى المخزون | لافتة مصممة في منتصف التمرير تبدو جزءاً من المتجر لا مقاطعة له |
| التكنولوجيا المالية: تأكيد خلال مهمة داخل التطبيق | تم إرسال التحويل | تأكيد بهوية العلامة يبدو أصيلاً في اللحظة التي ينتظره فيها المستخدم |
متى يكون سطح آخر هو الأنسب
اللافتة هي الدرجة الوسطى السريعة بين تنبيه النظام البسيط والسيطرة الكاملة على الشاشة داخل التطبيق. وكثير من اللحظات تقع على أحد الجانبين.
- اللحظة تصل والتطبيق مغلق: مندوب توصيل عند الباب، أو تغيير بوابة، أو تنبيه احتيال. هذا عمل إشعار عادي أو مستوى مقاطعة أو Live Activity.
- الحالة مستمرة لا لحظية: طلب قيد التنفيذ، أو رحلة في الطريق، أو نتيجة جارية. هذا عمل Live Activity.
- الرسالة تحتاج إلى شاشة كاملة: عرض، أو نموذج، أو صفحة اشتراك. هذا عمل الرسالة داخل التطبيق، الأغنى والمصممة بدون كود.
- تريد تغيير من يتلقى الرسالة أو ما تقوله. هذه الميزة تغيّر شكلها فقط، أما الوصول فيبقى مهمة إشعارات التطبيقات.
التغطية التقنية والمنصات
الوحدة خاصة بـ iOS. يدير Android سلوك المقدمة عبر قنوات الإشعارات، التي تنشئها Pushwoosh SDK من حمولة الإشعار بدلاً من أن يسجلها تطبيقك في الكود، ولا يوجد سطح مماثل على الويب. يوضح العمود الأخير ما يرسم اللافتة فعلاً، لأن معظم هذا يعيش في تطبيقك لا على الخادم.
| الإمكانية | iOS | Android | الويب | يتولاها |
|---|---|---|---|---|
| لافتة مقدمة مخصصة | iOS 13.0+، Pushwoosh SDK 6.10.0+ | – | – | وحدة PushwooshForegroundPush في تطبيقك |
| مادة Liquid Glass | iOS 26 مع Swift 5.13+ | – | – | مادة Apple، تُفعَّل عبر useLiquidView |
| لافتة صلبة بديلة | iOS أقدم من 26، Swift 5.13+ | – | – | عرض قياسي ترسمه SDK |
| لافتة ضبابية بديلة | أي iOS، Swift أقدم من 5.13 | – | – | عرض ضبابي ترسمه SDK |
| العنوان والرسالة وصورة البطاقة وGIF | نعم | – | – | حمولة الإشعار، دون تغيير |
| ألوان العلامة والتدرجات والخطوط | نعم | – | – | خصائص مظهر ثابتة في الوحدة |
| الاهتزاز وحركة الدخول والإخفاء والمدة | نعم | – | – | foregroundNotificationWith عند تشغيل التطبيق |
| معالجة النقر والرابط العميق | نعم | – | – | PWForegroundPushDelegate.didTapForegroundPush |
| ضبط المظهر بدون كود | – | – | – | غير متاح حالياً، التصميم يعيش في كود التطبيق |
| السطح المماثل داخل الجلسة في مكان آخر | الرسائل داخل التطبيق، Live Activities | الرسائل داخل التطبيق | الرسائل داخل التطبيق | منتجات منفصلة، تُصمم بدون كود في لوحة التحكم |
PushwooshForegroundPush في تطبيقكuseLiquidViewforegroundNotificationWith عند تشغيل التطبيقPWForegroundPushDelegate.didTapForegroundPushالأمان والاستضافة
تعمل Pushwoosh على خوادمها الخاصة في الولايات المتحدة وألمانيا، بموجب GDPR.
كيف يعمل
هذه الميزة تحتاج إلى وقت تطوير، ونقول ذلك صراحة. لا يوجد محرر في لوحة التحكم لمظهر المقدمة، لذا يربطها مطوّر مرة واحدة في التطبيق، وكل ما بعد ذلك هو الإرسال الذي تقوم به أصلاً.
-
أضف الوحدة وسلّم المقدمة لتطبيقك (مطوّر)
أضف
PushwooshForegroundPushإلى جانبPushwooshFrameworkوPushwooshCoreوPushwooshBridgeوPushwooshLiveActivities، ثم اضبطPushwoosh_SHOW_ALERTعلىfalseفيInfo.plist. هذا يمنع iOS من رسم تنبيهه الخاص، لأن اللافتة تحل محله لا تنضم إليه. -
اضبط المظهر مرة واحدة (مطوّر)
استدعِ
foregroundNotificationWith(style:duration:vibration:disappearedPushAnimation:)فيdidFinishLaunchingWithOptionsواضبط خصائص المظهر للألوان والتدرجات والخطوط. اعرض كل رسالة عبرshowForegroundPush(userInfo:)منonMessageReceived، وعالج النقرات فيdidTapForegroundPush. -
أرسل تماماً كما تفعل اليوم (بدون كود)
الجمهور نفسه، ورحلة العميل نفسها، والحمولة نفسها، سواء جاءت الحملة من لوحة التحكم أو من Messages API. اللافتة هي طريقة عرض ذلك الإشعار عندما يجد التطبيق مفتوحاً.
حدود يجب معرفتها
استكشف المنتجات ذات الصلة
منصة Pushwoosh لإشعارات الجوال الفورية: وصول لكل جهاز، محتوى غني وروابط عميقة، استهداف دقيق، ورحلات متعددة القنوات بموثوقية 99% وشهادات SOC 2 وISO 27001.
رسائل Pushwoosh داخل التطبيق: أكمل الإعداد والبيع الإضافي والإعلانات وجمع الملاحظات في اللحظة التي يكون فيها مستخدمو التطبيق منتبهين. محرر بدون كود، قوالب SDK أصلية، تحليلات لكل عنصر. متوافقة مع GDPR ومعتمدة ISO 27001. ابدأ مجاناً.
أضف أزرار إجراءات إلى إشعاراتك الفورية ليقبل المستخدم أو يطالب أو يوافق أو يتتبع بنقرة واحدة. أنشئ مجموعات أزرار iOS بدون كود في لوحة التحكم.
تعرض Live Updates الطلب أو الرحلة أو التوصيل على شاشة قفل Android 16 كبطاقة واحدة تتحدّث تلقائيًا. تبدؤها Pushwoosh وتحدّثها وتنهيها من الخادم.
ضع عدة صور في إشعار iOS واحد ودع المستخدم يتصفحها بالسحب في الإشعار الموسّع. Pushwoosh توفر امتداد عرض المحتوى، ويُرسل من الحملة ورحلة العميل نفسيهما.
يضيف Message Inbox مركز إشعارات داخل تطبيقك وموقعك. التسليم الصامت يصل إلى كل مستخدم، حتى من رفض الإشعارات الفورية، وتبقى الرسائل محفوظة.