تكوين إشعارات الويب
لبدء إرسال إشعارات الويب مع Pushwoosh، تحتاج إلى تكوين منصة إشعارات الويب الخاصة بك وتمكين نافذة الاشتراك التي تظهر للمستخدمين.
لبدء التكوين، انتقل إلى الإعدادات > تكوين المنصات > إشعارات الويب وانقر على اتصال.
تكوين إشعارات الويب لجميع المتصفحات (باستثناء إصدارات Safari القديمة)
Anchor link toينطبق هذا التكوين على جميع المتصفحات الحديثة، بما في ذلك أحدث إصدارات Safari، التي تدعم الآن إشعارات الويب بشكل أصلي.
ملاحظة: تتطلب إصدارات Safari القديمة (macOS 10.14–12) إعدادًا منفصلاً. يمكنك تكوين ذلك في قسم مخصص. اعرف المزيد
لبدء الإعداد، انقر على تكوين تحت تكوين جميع المتصفحات.
في نافذة التكوين، اختر أحد الخيارات التالية:
-
إنشاء تكوين إشعارات جديد موصى به إذا لم تكن قد قمت بإعداد إشعارات الويب من خلال خدمة أخرى من قبل. سيقوم Pushwoosh بإنشاء زوج مفاتيح VAPID جديد تلقائيًا.
-
استخدام التكوين الحالي اختر هذا الخيار إذا كان لديك بالفعل مفاتيح VAPID، على سبيل المثال، من Firebase، وترغب في الاستمرار في استخدامها دون أن تطلب من المستخدمين الاشتراك مرة أخرى.
إنشاء تكوين إشعارات جديد
Anchor link toاختر إنشاء تكوين إشعارات جديد إذا لم تكن قد قمت بإعداد إشعارات الويب مع خدمة أخرى من قبل. سيقوم Pushwoosh بإنشاء مفاتيح VAPID (تعريف خادم التطبيق الطوعي) المطلوبة لك تلقائيًا.
ما هي مفاتيح VAPID؟
مفاتيح VAPID هي زوج من المفاتيح العامة والخاصة المستخدمة في بروتوكول Web Push لمصادقة خادم التطبيق عند إرسال إشعارات الدفع إلى متصفحات الويب. يتم مشاركة المفتاح العام مع المتصفح عندما يشترك المستخدم في الإشعارات. يبقى المفتاح الخاص على خادمك ويستخدم لتوقيع كل رسالة ترسلها بشكل آمن.
انقر على تكوين لإنشاء وتطبيق المفاتيح.
بمجرد إنشائها، سيستخدم Pushwoosh هذه المفاتيح تلقائيًا في تكوين SDK. اعرف المزيد عن دمج Web Push SDK
استخدام التكوين الحالي
Anchor link toإذا كان لديك بالفعل مفاتيح VAPID (مثل تلك التي تم إنشاؤها من خلال Firebase)، يمكنك إعادة استخدامها لإعداد إشعارات الويب في Pushwoosh.
للقيام بذلك:
-
حدد استخدام التكوين الحالي.
-
في حقل شهادة Web Push، أدخل مفتاح VAPID العام الخاص بك.
-
في حقل مفتاح Web Push الخاص، أدخل مفتاح VAPID الخاص بك.
-
انقر على تكوين لحفظ الإعدادات وتطبيقها.
كيفية العثور على مفاتيح VAPID في Firebase
Anchor link toإذا كنت تقوم بالترحيل من Firebase وتحتاج إلى إعادة استخدام مفاتيح VAPID الحالية، فاتبع هذه الخطوات للعثور عليها.
شهادة Web Push
Anchor link to- في Firebase، انتقل إلى إعدادات المشروع ← Cloud Messaging.
- مرر لأسفل إلى قسم تكوين الويب وانسخ زوج المفاتيح الموجود.
مفتاح Web Push الخاص
Anchor link to- في Firebase Console، انتقل إلى إعدادات المشروع ← Cloud Messaging ← تكوين الويب.
- انقر على قائمة النقاط الثلاث تحت الإجراءات بجوار زوج المفاتيح وحدد إظهار المفتاح الخاص. هذا المفتاح ضروري لضمان عمل إشعارات Web Push بشكل صحيح.
-
انسخ المفتاح المعروض إلى الحافظة.
-
في نموذج تكوين الويب في Pushwoosh، الصقه في حقل مفتاح Web Push الخاص.
- انقر على تطبيق لحفظ تغييراتك.
إعادة تكوين إشعارات الويب
Anchor link toإذا كنت قد قمت بالفعل بإعداد إشعارات الويب ولكنك تحتاج إلى تحديث بيانات الاعتماد الخاصة بك (مثل استبدال مفاتيح VAPID)، فإليك كيفية القيام بذلك:
- انقر على إعادة التكوين تحت تكوين جميع المتصفحات.
-
في النافذة المنبثقة التي تظهر، أدخل مفاتيح VAPID الجديدة:
- شهادة Web Push: مفتاح VAPID العام الجديد الخاص بك
- مفتاح Web Push الخاص: مفتاح VAPID الخاص الجديد الخاص بك
-
انقر على تكوين لحفظ التغييرات.
تكوين نافذة الاشتراك
Anchor link toلإرسال إشعارات الدفع، يجب على المستخدمين منح الإذن صراحةً من خلال نافذة النظام الخاصة بالمتصفح. بدون هذا الإذن، لا يمكن تسليم الإشعارات.
بسبب التغييرات الأخيرة في سياسات Chrome و Firefox، لا يمكن أن تظهر نافذة الإذن الأصلية إلا بعد تفاعل المستخدم مع الصفحة (على سبيل المثال، عن طريق النقر على زر). لتلبية هذا المطلب، يعرض Pushwoosh أداة نافذة الاشتراك بشكل افتراضي. تشجع هذه الأداة المستخدمين على الاشتراك، وعند الموافقة، تطلق نافذة المتصفح الأصلية.
لتخصيص نص النافذة ومظهرها، انقر على الإعدادات.
أنواع النوافذ
Anchor link toهناك نوعان من نوافذ الاشتراك المتاحة:
-
الأداة الافتراضية مقدمة من Pushwoosh ويتم عرضها تلقائيًا. تعرف على كيفية تخصيص الأداة الافتراضية.
-
أداة مخصصة استخدم تصميم الأداة الخاص بك. اعرف المزيد
ملاحظة: بسبب قيود المنصة، قد تستغرق التغييرات على الأداة ما يصل إلى 30 دقيقة لتظهر. إذا لم تنعكس التغييرات، فاتصل بفريق دعم Pushwoosh.
تكوين Safari (macOS 10.14–12)
Anchor link toلدعم إشعارات الدفع على الإصدارات القديمة من Safari (macOS 10.14–12)، تحتاج إلى إكمال عملية تكوين منفصلة باستخدام بيانات اعتماد Apple Developer الخاصة بك. هذه الخطوة مطلوبة فقط لهذه الإصدارات القديمة حيث تدعم إصدارات Safari الأحدث (macOS Ventura والإصدارات الأحدث) إعداد إشعارات الويب القياسي المضمن في تكوين جميع المتصفحات.
الحصول على بيانات الاعتماد المطلوبة من Apple
Anchor link to-
انتقل إلى قسم الشهادات والمعرفات والملفات الشخصية في بوابة مطوري Apple.
-
أضف شهادة جديدة.
- اختر نوع شهادة معرف إشعارات موقع الويب وانقر على متابعة.
- حدد معرف إشعارات موقع الويب - وهو سلسلة نطاق عكسي فريدة خاصة بك، مثل web.com.example.domain (يجب أن تبدأ بـ web.).
-
قم بتحميل طلب توقيع شهادة. لمعرفة المزيد حول إنشاء طلبات توقيع الشهادات، يرجى الرجوع إلى مقالة مساعدة حساب المطور.
-
بعد ذلك، قم بتنزيل شهادة إشعارات الدفع.
تكوين Safari في Pushwoosh
Anchor link to- انقر على تكوين تحت تكوين Safari.
- املأ الحقول التالية في نموذج التكوين:
| اسم موقع الويب | اسم موقع الويب الخاص بك الذي يظهر في نافذة الإشعارات. |
| النطاقات المسموح بها | قائمة النطاقات المسموح لها بطلب إذن الإشعارات (واحد في كل سطر). |
| قالب URL | عنوان URL الذي يتم فتحه عندما ينقر المستخدم على الإشعار. يدعم العناصر النائبة مثل %@ لإدراج قيم ديناميكية. مثال: https://yourwebsite.com/%@ |
| أيقونة موقع الويب | قم بتحميل صورة PNG مربعة (256×256 بكسل). يقوم Pushwoosh بتغيير حجمها تلقائيًا لواجهات مختلفة. |
| ملف المفتاح | قم بتحميل شهادة .p12 التي تم تصديرها من حساب Apple Developer الخاص بك. |
| كلمة مرور المفتاح الخاص | كلمة المرور المستخدمة عند تصدير ملف .p12. |
- انقر على تكوين لحفظ تغييراتك.
سيقوم Pushwoosh بإنشاء حزمة الإشعارات تلقائيًا مع مجموعة الأيقونات، وقاموس JSON لموقع الويب، وملف البيان الذي يطلبه Safari من الخادم. يمكنك تنزيله كلما احتجت إليه.