वेब पुश कॉन्फ़िगरेशन

Pushwoosh के साथ वेब पुश नोटिफिकेशन भेजना शुरू करने के लिए, आपको अपने वेब पुश प्लेटफ़ॉर्म को कॉन्फ़िगर करना होगा और उपयोगकर्ताओं को दिखाए जाने वाले सदस्यता प्रॉम्प्ट को सक्षम करना होगा।

महत्वपूर्ण

सुनिश्चित करें कि वेब पुश SDK आपकी वेबसाइट में ठीक से एकीकृत है। यह उपयोगकर्ताओं को सब्सक्राइब करने और नोटिफिकेशन प्राप्त करने की अनुमति देने के लिए एक आवश्यक कदम है। और जानें

कॉन्फ़िगरेशन शुरू करने के लिए, Settings > Platform Configuration > Web Push Notifications पर जाएं और Configure पर क्लिक करें।

सभी ब्राउज़रों के लिए वेब पुश कॉन्फ़िगर करें (पुराने Safari संस्करणों को छोड़कर)

यह कॉन्फ़िगरेशन सभी आधुनिक ब्राउज़रों पर लागू होता है, जिसमें Safari के नवीनतम संस्करण भी शामिल हैं, जो अब वेब पुश नोटिफिकेशन को मूल रूप से समर्थन करते हैं।

ध्यान दें: पुराने Safari संस्करणों (macOS 10.14–12) के लिए एक अलग सेटअप की आवश्यकता होती है। आप इसे एक समर्पित अनुभाग में कॉन्फ़िगर कर सकते हैं। और जानें

सेटअप शुरू करने के लिए, All browsers configuration के तहत Configure पर क्लिक करें।

कॉन्फ़िगरेशन विंडो में, निम्नलिखित विकल्पों में से एक चुनें:

• एक नया पुश कॉन्फ़िगरेशन बनाएँ यदि आपने पहले किसी अन्य सेवा के माध्यम से वेब पुश नोटिफिकेशन सेट नहीं किया है तो इसकी अनुशंसा की जाती है। Pushwoosh स्वचालित रूप से एक नई VAPID कुंजी जोड़ी उत्पन्न करेगा।

• मौजूदा कॉन्फ़िगरेशन का उपयोग करें यह विकल्प चुनें यदि आपके पास पहले से ही VAPID कुंजियाँ हैं, उदाहरण के लिए, Firebase से, और आप उपयोगकर्ताओं को फिर से सब्सक्राइब करने के लिए कहे बिना उनका उपयोग जारी रखना चाहते हैं।

एक नया पुश कॉन्फ़िगरेशन बनाएँ

यदि आपने पहले किसी अन्य सेवा के साथ वेब पुश नोटिफिकेशन सेट नहीं किया है तो Create a new push configuration चुनें। Pushwoosh आपके लिए आवश्यक VAPID (Voluntary Application Server Identification) कुंजियाँ स्वचालित रूप से उत्पन्न करेगा।

VAPID कुंजियाँ क्या हैं?

VAPID कुंजियाँ एक पब्लिक-प्राइवेट कुंजी जोड़ी हैं जिनका उपयोग वेब पुश प्रोटोकॉल में वेब ब्राउज़रों को पुश नोटिफिकेशन भेजते समय एप्लिकेशन सर्वर को प्रमाणित करने के लिए किया जाता है। पब्लिक कुंजी को ब्राउज़र के साथ साझा किया जाता है जब कोई उपयोगकर्ता नोटिफिकेशन के लिए सब्सक्राइब करता है। प्राइवेट कुंजी आपके सर्वर पर रहती है और आपके द्वारा भेजे जाने वाले प्रत्येक संदेश पर सुरक्षित रूप से हस्ताक्षर करने के लिए उपयोग की जाती है।

कुंजियों को उत्पन्न करने और लागू करने के लिए Configure पर क्लिक करें।

एक बार बन जाने के बाद, Pushwoosh स्वचालित रूप से इन कुंजियों का उपयोग SDK कॉन्फ़िगरेशन में करेगा। वेब पुश SDK को एकीकृत करने के बारे में और जानें

मौजूदा कॉन्फ़िगरेशन का उपयोग करें

यदि आपके पास पहले से ही VAPID कुंजियाँ हैं (जैसे कि Firebase के माध्यम से उत्पन्न की गई), तो आप Pushwoosh में वेब पुश नोटिफिकेशन सेट करने के लिए उनका पुन: उपयोग कर सकते हैं।

इसके लिए:

1. Use existing configuration चुनें।

2. Web Push Certificate फ़ील्ड में, अपनी VAPID पब्लिक कुंजी दर्ज करें।

3. Web Push Private Key फ़ील्ड में, अपनी VAPID प्राइवेट कुंजी दर्ज करें।

4. सेटिंग्स को सहेजने और लागू करने के लिए Configure पर क्लिक करें।

Firebase में VAPID कुंजियाँ कैसे खोजें

यदि आप Firebase से माइग्रेट कर रहे हैं और अपनी मौजूदा VAPID कुंजियों का पुन: उपयोग करने की आवश्यकता है, तो उन्हें खोजने के लिए इन चरणों का पालन करें।

वेब पुश प्रमाणपत्र

1. Firebase में, Project Settings → Cloud Messaging पर नेविगेट करें।
2. Web Configuration अनुभाग तक नीचे स्क्रॉल करें और मौजूदा कुंजी जोड़ी को कॉपी करें।

3. इसे Pushwoosh वेब कॉन्फ़िगरेशन फ़ॉर्म में Web Push Certificate फ़ील्ड में पेस्ट करें।

वेब पुश प्राइवेट कुंजी

1. Firebase Console में, Project Settings → Cloud Messaging → Web Configuration पर जाएं।
2. कुंजी जोड़ी के आगे Actions के तहत तीन-डॉट मेनू पर क्लिक करें और Show private key चुनें। यह कुंजी यह सुनिश्चित करने के लिए आवश्यक है कि वेब पुश नोटिफिकेशन सही ढंग से काम करें।

3. प्रदर्शित कुंजी को अपने क्लिपबोर्ड पर कॉपी करें।

4. Pushwoosh Web Configuration फ़ॉर्म में, इसे Web Push Private Key फ़ील्ड में पेस्ट करें।

5. अपने परिवर्तनों को सहेजने के लिए Apply पर क्लिक करें।

वेब पुश कॉन्फ़िगरेशन को फिर से कॉन्फ़िगर करें

यदि आपने पहले ही वेब पुश नोटिफिकेशन सेट कर लिया है, लेकिन अपनी क्रेडेंशियल्स (जैसे अपनी VAPID कुंजियों को बदलना) को अपडेट करने की आवश्यकता है, तो इसे करने का तरीका यहां दिया गया है:

1. All browsers configuration के तहत Reconfigure पर क्लिक करें।

2. दिखाई देने वाले पॉपअप में, अपनी नई VAPID कुंजियाँ दर्ज करें:

   • Web Push Certificate: आपकी नई पब्लिक VAPID कुंजी
   • Web Push Private Key: आपकी नई प्राइवेट VAPID कुंजी

3. परिवर्तनों को सहेजने के लिए Configure पर क्लिक करें।

महत्वपूर्ण

आपकी VAPID कुंजियों को बदलने से आपका पूरा वेब पुश सेटअप प्रभावित होता है और यदि सही तरीके से प्रबंधित नहीं किया गया तो नोटिफिकेशन डिलीवरी में बाधा आ सकती है। कुंजियों को केवल तभी बदलें जब यह वास्तव में आवश्यक हो, और सुनिश्चित करें कि कोई भी अपडेट करने से पहले आप इसके प्रभाव को समझते हैं।

सदस्यता प्रॉम्प्ट कॉन्फ़िगर करें

पुश नोटिफिकेशन भेजने के लिए, उपयोगकर्ताओं को ब्राउज़र के सिस्टम-स्तरीय प्रॉम्प्ट के माध्यम से स्पष्ट रूप से अनुमति देनी होगी। इस अनुमति के बिना, नोटिफिकेशन डिलीवर नहीं किए जा सकते।

हाल के Chrome और Firefox नीति परिवर्तनों के कारण, मूल अनुमति पॉप-अप केवल उपयोगकर्ता द्वारा पृष्ठ के साथ इंटरैक्ट करने के बाद ही दिखाई दे सकता है (उदाहरण के लिए, एक बटन पर क्लिक करके)। इस आवश्यकता को पूरा करने के लिए, Pushwoosh डिफ़ॉल्ट रूप से एक Subscription Prompt widget प्रदर्शित करता है। यह विजेट उपयोगकर्ताओं को ऑप्ट-इन करने के लिए प्रोत्साहित करता है और, सहमति पर, मूल ब्राउज़र प्रॉम्प्ट को ट्रिगर करता है।

टिप

एक अच्छी तरह से डिज़ाइन किया गया प्रॉम्प्ट जो नोटिफिकेशन के मूल्य की व्याख्या करता है (उदाहरण के लिए, “नवीनतम समाचार और अपडेट प्राप्त करें”) ऑप्ट-इन दरों में काफी सुधार कर सकता है।

प्रॉम्प्ट टेक्स्ट और उपस्थिति को अनुकूलित करने के लिए, Settings पर क्लिक करें।

प्रॉम्प्ट प्रकार

दो प्रकार के सदस्यता प्रॉम्प्ट उपलब्ध हैं:

• Default widget Pushwoosh द्वारा प्रदान किया गया और स्वचालित रूप से प्रदर्शित किया गया। डिफ़ॉल्ट विजेट को कैसे अनुकूलित करें जानें।

• Custom widget अपने स्वयं के विजेट डिज़ाइन का उपयोग करें। और जानें

ध्यान दें: प्लेटफ़ॉर्म सीमाओं के कारण, विजेट में परिवर्तनों को प्रदर्शित होने में 30 मिनट तक लग सकते हैं। यदि परिवर्तन प्रतिबिंबित नहीं होते हैं, तो Pushwoosh सहायता टीम से संपर्क करें।

Safari कॉन्फ़िगरेशन (macOS 10.14–12)

Safari के पुराने संस्करणों (macOS 10.14–12) पर पुश नोटिफिकेशन का समर्थन करने के लिए, आपको अपने Apple डेवलपर क्रेडेंशियल्स का उपयोग करके एक अलग कॉन्फ़िगरेशन प्रक्रिया पूरी करनी होगी। यह कदम केवल इन पुराने संस्करणों के लिए आवश्यक है क्योंकि नए Safari संस्करण (macOS Ventura और बाद के) मानक वेब पुश सेटअप का समर्थन करते हैं जो All Browsers Configuration में शामिल है।

Apple से आवश्यक क्रेडेंशियल्स प्राप्त करें

1. Apple डेवलपर पोर्टल के Certificates, Identifiers & Profiles section पर जाएं।

2. नया प्रमाणपत्र जोड़ें।

3. Website Push ID Certificate प्रकार चुनें और Continue पर क्लिक करें।

4. Website Push ID चुनें - आपका अद्वितीय रिवर्स-डोमेन स्ट्रिंग, जैसे web.com.example.domain (यह web. से शुरू होना चाहिए)।

5. एक Certificate Signing Request अपलोड करें। सर्टिफिकेट साइनिंग रिक्वेस्ट बनाने के बारे में अधिक जानने के लिए, कृपया Developer Account Help article देखें।

6. इसके बाद, पुश नोटिफिकेशन प्रमाणपत्र डाउनलोड करें।

नोट

Apple से आप जो प्रमाणपत्र डाउनलोड करते हैं वह एक .cer फ़ाइल है। Pushwoosh को कॉन्फ़िगर करने के लिए आवश्यक .p12 फ़ाइल प्राप्त करने के लिए, आपको एक प्राइवेट कुंजी निर्यात करनी होगी। विवरण iOS Configuration guide में देखें।

Pushwoosh में Safari कॉन्फ़िगर करें

1. Safari Configuration के तहत Configure पर क्लिक करें।

2. कॉन्फ़िगरेशन फ़ॉर्म में निम्नलिखित फ़ील्ड भरें:

वेबसाइट का नाम	आपकी वेबसाइट का नाम जो पुश प्रॉम्प्ट में दिखाई देता है।
अनुमत डोमेन	नोटिफिकेशन अनुमति का अनुरोध करने के लिए अनुमत डोमेन की सूची (प्रति पंक्ति एक)।
URL टेम्पलेट	जब कोई उपयोगकर्ता नोटिफिकेशन पर क्लिक करता है तो खुलने वाला URL। डायनेमिक मान डालने के लिए %@ जैसे प्लेसहोल्डर्स का समर्थन करता है। उदाहरण: https://yourwebsite.com/%@
वेबसाइट आइकन	एक वर्गाकार PNG छवि (256×256 px) अपलोड करें। Pushwoosh इसे विभिन्न इंटरफेस के लिए स्वचालित रूप से आकार बदलता है।
कुंजी फ़ाइल	अपने Apple डेवलपर खाते से निर्यात किया गया .p12 प्रमाणपत्र अपलोड करें।
प्राइवेट कुंजी पासवर्ड	.p12 फ़ाइल निर्यात करते समय उपयोग किया गया पासवर्ड।

3. अपने परिवर्तनों को सहेजने के लिए Configure पर क्लिक करें।

Pushwoosh स्वचालित रूप से आइकन सेट, वेबसाइट JSON डिक्शनरी, और मैनिफेस्ट फ़ाइल के साथ पुश पैकेज उत्पन्न करेगा जिसे Safari सर्वर से अनुरोध करता है। आप इसे जब चाहें डाउनलोड कर सकते हैं।

महत्वपूर्ण

जब किसी उपयोगकर्ता से पुश नोटिफिकेशन प्राप्त करने की अनुमति मांगी जाती है, तो Safari Pushwoosh के वेब सर्वर से एक push package मांगता है। पैकेज में नोटिफिकेशन UI द्वारा उपयोग किया जाने वाला डेटा होता है, जैसे आपकी वेबसाइट का नाम और आइकन, साथ ही एक क्रिप्टोग्राफ़िक हस्ताक्षर जो यह सत्यापित करता है कि आपका नोटिफिकेशन एक विश्वसनीय स्रोत से आ रहा है: आप।

पुश पैकेज अपनी सभी सामग्री के साथ प्रत्येक सब्सक्राइब्ड उपयोगकर्ता द्वारा पंजीकरण पर केवल एक बार डाउनलोड किया जाता है, और इसे डिवाइस पर जबरन अपडेट नहीं किया जा सकता है।

अपनी वेबसाइट के लिए उत्पादन में Safari पुश नोटिफिकेशन लॉन्च करते समय इस पर विचार करें।