प्रीलैंडिंग पर SDK
आमतौर पर एक आगंतुक प्रीलैंडिंग पर आता है और वहाँ से PWA स्टोर कार्ड पर जाता है, जहाँ इंस्टॉल बटन होता है। लेकिन इंस्टॉल और पुश सब्सक्रिप्शन सीधे आपके अपने प्रीलैंडिंग पर शुरू किए जा सकते हैं: आप Browser SDK जोड़ें और अपने बटनों से उसके मेथड कॉल करें। तब आगंतुक स्टोर कार्ड पर गए बिना ऐप इंस्टॉल करता है और पुश सब्सक्राइब करता है।
इसके लिए आगंतुक को ऐप इंस्टॉल करना आवश्यक नहीं है: पुश सब्सक्रिप्शन इसके बिना भी काम करता है।
पहले क्या चाहिए
- Qubix में अपलोड किया गया एक प्रीलैंडिंग। यह वेबसाइटें सेक्शन में आपका पेज है — इसे एक सामान्य साइट की तरह अपलोड करें (देखें एक वेबसाइट अपलोड करना)।
- एक सेट अप और सक्रिय डोमेन। प्रीलैंडिंग ऐसे डोमेन पर परोसी जानी चाहिए जो Qubix में सेट अप है और सक्रिय है (देखें डोमेन)। यह आवश्यक है: इंस्टॉल और पुश केवल तभी काम करते हैं जब पेज और SDK की सेवा-पते एक ही डोमेन पर हों।
- एक बनाया हुआ PWA — आपको PWA Apps सेक्शन में कार्ड से उसके पहचानकर्ता (
pwaId) की आवश्यकता होगी।
कैसे जोड़ें
-
प्रीलैंडिंग के कोड में, कॉन्फ़िग सेट करें और SDK स्क्रिप्ट लोड करें। कॉन्फ़िग स्क्रिप्ट से पहले जाता है:
index.htmlHTML<script>window.pwaConfig = {pwaId: 'YOUR-PWA-ID',domain: 'your-domain.com',}</script><script src="https://your-domain.com/sdk.js" defer></script>पुश की
/sdk.jsमें स्वचालित रूप से इनलाइन हो जाती है — इसे हाथ से जोड़ने की आवश्यकता नहीं है। फ़ील्ड का पूरा विवरण Browser SDK रेफ़रेंस में है। -
इंस्टॉल के लिए SDK तैयार करें — एक बार, पेज लोड होने पर। यह कॉल सर्विस भाग रजिस्टर करता है और ऐप मैनिफ़ेस्ट जोड़ता है:
JavaScriptsdk.pwa.init() -
इंस्टॉल को अपने बटन से जोड़ें:
HTML<button id="install">ऐप इंस्टॉल करें</button><script>document.getElementById('install').addEventListener('click', () => {sdk.pwa.install()})</script> -
पुश सब्सक्रिप्शन को अपने बटन से जोड़ें (या किसी उचित समय पर कॉल करें):
JavaScriptawait sdk.subscribePush()
बस — इंस्टॉल और सब्सक्रिप्शन आपके पेज पर होते हैं। कुछ भी आगंतुक को स्टोर कार्ड पर नहीं भेजता।
यदि किसी परिदृश्य में स्टोर कार्ड की आवश्यकता है, तो sdk.showStore() उसे खोलता है। इस मेथड को न कॉल करें — आगंतुक आपके प्रीलैंडिंग पर ही रहेगा।
इंस्टॉल बटन केवल तभी दिखाएँ जब इंस्टॉल वास्तव में उपलब्ध हो — sdk.pwa.canInstall() जाँचें। ब्राउज़र हमेशा इंस्टॉल प्रॉम्प्ट की अनुमति नहीं देते: एक सुरक्षित कनेक्शन (HTTPS) आवश्यक है, और आमतौर पर पेज पर आगंतुक की कोई क्रिया। इसीलिए इंस्टॉल और सब्सक्रिप्शन दोनों आमतौर पर लोड पर नहीं, बल्कि एक स्पष्ट टैप से जुड़े होते हैं।
सत्यापित करें
फ़ोन पर प्रीलैंडिंग खोलें और अपने बटन टैप करें — ब्राउज़र इंस्टॉल प्रॉम्प्ट और नोटिफ़िकेशन प्रॉम्प्ट दिखाएगा। परिणाम रिपोर्ट में दिखता है: install_accepted, push_allow और अन्य इवेंट इवेंट स्ट्रीम में आते हैं।