إشعارات الويب على iPhone وiPad

يمكن لمستخدمي iPhone وiPad الذين يعملون بنظام iOS وiPadOS 16.4 أو أحدث تلقي إشعارات الويب من موقعك بعد إضافته إلى الشاشة الرئيسية.

متى تعمل إشعارات الويب على iPhone وiPad

تعمل إشعارات الويب على iOS وiPadOS فقط للموقع الذي يُفتح من أيقونته على الشاشة الرئيسية. في علامة تبويب Safari العادية، لا يوفّر المتصفح الإشعارات الفورية إطلاقًا، لذلك تتم تهيئة Web SDK بدون الإشعارات الفورية ولا يستطيع الزائر الاشتراك.

لتلقي الإشعارات، يحتاج المستخدم إلى:

• جهاز iPhone أو iPad يعمل بنظام iOS أو iPadOS 16.4 أو أحدث.
• إضافة موقعك إلى الشاشة الرئيسية وفتحه من تلك الأيقونة.
• السماح بالإشعارات استجابةً لنقرة على موقعك.

نصيحة

نوصي بإعلام زوار iPhone وiPad على موقعك بأنهم يحتاجون إلى إضافته إلى الشاشة الرئيسية لتلقي الإشعارات. للقيام بذلك، ينقرون على مشاركة في Safari، ثم إضافة إلى الشاشة الرئيسية وإضافة، ثم يفتحون الموقع من الأيقونة الجديدة على شاشتهم الرئيسية.

ما يحتاجه موقعك

ادمج Web SDK بالطريقة نفسها المتبعة مع متصفحات سطح المكتب، ثم أضف بيان تطبيق الويب (manifest):

1. ادمج SDK وservice worker باتباع Web push SDK 3.0. إذا كان لموقعك service worker خاص به بالفعل، فاتبع دعم تطبيقات الويب التقدمية.

2. أضف بيان تطبيق ويب مع تعيين display إلى standalone أو fullscreen، واربطه من كل صفحة:

   manifest.json

   {
     "name": "Example Store",
     "short_name": "Store",
     "start_url": "/",
     "display": "standalone",
     "icons": [
       { "src": "/icon-192.png", "sizes": "192x192", "type": "image/png" },
       { "src": "/icon-512.png", "sizes": "512x512", "type": "image/png" }
     ]
   }

   <link rel="manifest" href="/manifest.json">

3. اطلب إذن الإشعارات عند نقرة المستخدم. لا يعرض iOS وiPadOS مربع حوار الإذن إلا استجابةً لإجراء مباشر من المستخدم، لذا استخدم أداة الاشتراك أو زرًا يستدعي Pushwoosh.subscribe():

   <button onclick="Pushwoosh.subscribe()">Get notifications</button>

كيفية العثور على مشتركي iPhone وiPad في Pushwoosh

يسجّل Pushwoosh مشتركي الويب على iPhone وiPad ضمن منصة Chrome، لذلك لا تعرضهم الإحصائيات بشكل منفصل، ولا توجد علامة افتراضية تحدد الجهاز بشكل موثوق.

لاستهداف هؤلاء المشتركين، عيّن علامة خاصة بك من الموقع:

1. أنشئ علامة مخصصة في Control Panel قبل أن يرسلها الموقع، على سبيل المثال علامة من نوع String باسم Web App Platform. ألغِ تحديد مربع الاختيار خاص بالمستخدم (User-specific)، المحدد افتراضيًا. ينتج عن ذلك علامة عامة (General) تُخزَّن لكل جهاز.

   بدون هذه الخطوة، ينشئ setTags العلامة تلقائيًا على أنها خاصة بالمستخدم. تتشارك قيمتها جميع الأجهزة التي تحمل User ID نفسه، لذا بمجرد أن يستدعي الموقع registerUser، يحصل متصفح سطح المكتب الخاص بالمستخدم أيضًا على ios ويتلقى الرسائل التي تستهدف بها مشتركي iPhone وiPad باستخدام هذه العلامة.

2. عيّن العلامة عندما يعمل الموقع من الشاشة الرئيسية على iPhone أو iPad:

   Pushwoosh.push((api) => {
     // iPadOS Safari reports a Mac user agent, so a touch screen marks an iPad
     const isIos = /iPhone|iPad/.test(navigator.userAgent)
       || (/Macintosh/.test(navigator.userAgent) && navigator.maxTouchPoints > 1);
     const isIosHomeScreen = isIos && (window.navigator.standalone === true
       || window.matchMedia('(display-mode: standalone)').matches);
   
     if (isIosHomeScreen) {
       api.setTags({ 'Web App Platform': 'ios' });
     }
   });

3. اشترك من جهاز iPhone أو iPad تجريبي.

4. تحقق من قيمة العلامة على ذلك الجهاز في مستكشف المستخدم. يُرجع setTags نجاحًا حتى عندما لا يحفظ Pushwoosh القيمة، على سبيل المثال عند إيقاف الإنشاء التلقائي للعلامات للحساب، لذا لا يؤكد الكود وحده أن القيمة قد حُفظت.

5. أنشئ شريحة بناءً على هذه العلامة لإرسال رسالة إلى مشتركي iPhone وiPad فقط.