अपने पुश सब्सक्राइबर बेस का प्रबंधन करना

Pushwoosh में, प्रत्येक सब्सक्राइबर को एक पुश टोकन द्वारा पहचाना जाता है, जो एक अद्वितीय पहचानकर्ता है जो एक विशिष्ट डिवाइस पर संदेश वितरण को सक्षम बनाता है। यह पोस्ट कवर करती है कि पुश टोकन कैसे काम करते हैं और अपने सब्सक्राइबर बेस में केवल वैध टोकन कैसे रखें।

पुश टोकन को समझना और वे कैसे काम करते हैं

एक पुश टोकन एक अद्वितीय, अनाम पहचानकर्ता है जो एक डिवाइस पर एक विशिष्ट ऐप इंस्टेंस को उसके पुश सेवा प्रदाता द्वारा सौंपा जाता है:

iOS डिवाइस के लिए Apple Push Notification Service (APNs)
Android डिवाइस के लिए Firebase Cloud Messaging (FCM)

यह टोकन सुनिश्चित करता है कि पुश नोटिफिकेशन उपयोगकर्ता के डिवाइस पर सही ऐप तक पहुँचाए जाएँ।

Pushwoosh में, पुश टोकन जीवनचक्र में ये प्रमुख चरण शामिल हैं:

जब ऐप पहली बार लॉन्च होता है, तो यह डिवाइस के ऑपरेटिंग सिस्टम (OS) से पुश नोटिफिकेशन प्राप्त करने की अनुमति मांगता है।
एप्लिकेशन की पुश सेवा (जैसे, iOS के लिए APNs, Android के लिए FCM) उस ऐप इंस्टेंस के लिए एक अद्वितीय पुश टोकन उत्पन्न करती है। डिफ़ॉल्ट रूप से, Pushwoosh SDK इस टोकन को एकत्र और संग्रहीत करता है, भले ही उपयोगकर्ता ने नोटिफिकेशन प्रदर्शन की अनुमति न दी हो। इन उपयोगकर्ताओं को पुश संदेश नहीं दिखाए जाएँगे, लेकिन टोकन का उपयोग अभी भी उनके एप्लिकेशन इनबॉक्स में संदेश भेजने के लिए किया जा सकता है, जो Pushwoosh में एक और मैसेजिंग चैनल है।

हालांकि, आप SDK को केवल उन उपयोगकर्ताओं से टोकन एकत्र करने के लिए कॉन्फ़िगर कर सकते हैं जिन्होंने अनुमति दी है।
ऐप Pushwoosh SDK का उपयोग करके इस टोकन को Pushwoosh डेटाबेस में डिवाइस डेटा (हार्डवेयर आईडी या HWID सहित) के साथ /registerDevice API एंडपॉइंट के माध्यम से भेजता है।
Pushwoosh भविष्य के संदेशों के लिए टोकन को सुरक्षित रूप से संग्रहीत करता है।
जब कोई नोटिफिकेशन ट्रिगर होता है, तो Pushwoosh संग्रहीत टोकन का उपयोग करके संदेश को उपयुक्त डिलीवरी गेटवे के माध्यम से रूट करता है।
चुना हुआ गेटवे संदेश को डिवाइस तक पहुँचाता है, और OS इसे सिस्टम और ऐप नोटिफिकेशन सेटिंग्स के आधार पर प्रदर्शित करता है।
यदि पुश टोकन अमान्य हो जाता है (उदाहरण के लिए, ऐप अनइंस्टॉल होने के कारण), तो Pushwoosh दूसरे नोटिफिकेशन भेजने के बाद डिलीवरी विफलता का पता लगाता है, जब गेटवे भेजने की त्रुटियों की सूची लौटाता है, जिसमें समाप्त/अमान्य/आदि टोकन शामिल होते हैं। फिर Pushwoosh टोकन को निष्क्रिय के रूप में चिह्नित करता है और इसे डेटाबेस से हटा देता है। यदि ऐप उसी डिवाइस पर फिर से इंस्टॉल किया जाता है, तो एक नया टोकन जारी किया जाएगा।

पुश टोकन के अमान्य होने के सामान्य कारण

जबकि Apple Push Notification Service (APNs) और Firebase Cloud Messaging (FCM) टोकन जीवनचक्र नीतियों में पूरी पारदर्शिता प्रदान नहीं करते हैं या सक्रिय टोकन सत्यापन की अनुमति नहीं देते हैं, ऐसे ज्ञात परिदृश्य हैं जिनमें पुश टोकन अमान्य या समाप्त हो सकते हैं।

कारण	APNs (iOS)	FCM (Android)
ऐप अनइंस्टॉल	ऐप अनइंस्टॉल के बाद टोकन अमान्य हो जाता है। APNs अंततः एक `410 Unregistered` त्रुटि लौटाता है। Apple यह निर्दिष्ट नहीं करता है कि अमान्यकरण कब होता है; इसमें कुछ मिनटों से लेकर कई दिनों तक का समय लग सकता है। और जानें	अनइंस्टॉल होने पर टोकन तुरंत अमान्य हो जाता है। बाद में भेजने पर एक `Unregistered` त्रुटि लौटती है। और जानें
टोकन रिफ्रेश	APNs OS अपग्रेड, डिवाइस बैकअप/रिस्टोर, ऐप रीइंस्टॉल, या OS अपडेट के बाद एक नया टोकन जारी करता है। और जानें	APNs के समान व्यवहार। ऐप डेटा क्लीयरेंस या डिवाइस रिस्टोरेशन द्वारा भी ट्रिगर होता है। और जानें
टोकन निष्क्रियता	निष्क्रियता के कारण कोई प्रलेखित समाप्ति नहीं है। और जानें	270 दिनों से अधिक समय तक निष्क्रिय टोकन को पुराना/समाप्त माना जाता है। FCM उन्हें अमान्य के रूप में चिह्नित करता है। और जानें

अमान्य पुश टोकन हटाकर अपनी सब्सक्राइबर सूची को कैसे साफ़ रखें

अपनी पुश सब्सक्राइबर सूची को साफ़ रखने के लिए, नियमित रूप से डिलीवरी आँकड़ों की जाँच करें, अमान्य टोकन हटाएँ, और सुनिश्चित करें कि आपके ऐप और बैकएंड में हमेशा नवीनतम टोकन डेटा हो।

Pushwoosh आपको ऐसा करने में मदद करने के लिए कई तरीके प्रदान करता है:

नियमित रूप से अपने पूरे सब्सक्राइबर बेस को पुश नोटिफिकेशन भेजें

नियमित रूप से अपने पूरे सब्सक्राइबर बेस को पुश संदेश भेजें। यह Pushwoosh को अमान्य टोकन की पहचान करने में मदद करता है। जब कोई संदेश डिलीवर करने में विफल रहता है, आमतौर पर एक अमान्य टोकन के कारण, पुश गेटवे एक त्रुटि लौटाता है। SDK इस प्रतिक्रिया को कैप्चर करता है और अमान्य टोकन को स्वचालित रूप से हटा देता है, यह सुनिश्चित करते हुए कि इसे भविष्य के भेजने से बाहर रखा गया है।

महत्वपूर्ण: टोकन की वैधता केवल तभी जाँची जाती है जब कोई पुश भेजा जाता है। Pushwoosh टोकन की वैधता पर पृष्ठभूमि जाँच नहीं करता है।

API का उपयोग करके डिवाइस को अपंजीकृत करें

आप अपने सब्सक्राइबर बेस से पुश टोकन हटाने के लिए /bulkUnregisterDevice डिवाइस API विधि का उपयोग कर सकते हैं, उदाहरण के लिए, जब उपयोगकर्ता ऑप्ट-आउट करते हैं या अब सक्रिय नहीं हैं।

ऐसा करने के लिए:

अपने मानदंडों से मेल खाने वाले उपयोगकर्ताओं का एक सेगमेंट बनाएँ (उदाहरण के लिए, ऑप्ट-आउट, फ्री-टियर उपयोगकर्ता, या जो X दिनों से निष्क्रिय हैं)।
कंट्रोल पैनल या exportSegment API विधि का उपयोग करके सेगमेंट को निर्यात करें।
उस सेगमेंट में डिवाइस के लिए पुश टोकन हटाने के लिए /bulkUnregisterDevice को कॉल करें।

स्वतःसत्यापन के साथ 90 दिनों के बाद निष्क्रिय टोकन को स्वचालित रूप से हटाएँ

Pushwoosh में स्वचालित निष्क्रियता सफाई एल्गोरिथ्म उन उपयोगकर्ताओं के पुश टोकन को हटाकर आपकी सब्सक्राइबर सूची को साफ़ रखने में मदद करता है जो 90 दिनों से सक्रिय नहीं हैं।

यह डिफ़ॉल्ट Last Application Open टैग का उपयोग करके ट्रैक करता है कि उपयोगकर्ताओं ने आखिरी बार आपका ऐप कब खोला था। यदि किसी उपयोगकर्ता ने 90 दिनों या उससे अधिक समय तक ऐप नहीं खोला है, तो उनका पुश टोकन निष्क्रिय के रूप में चिह्नित किया जाता है और आपके सब्सक्राइबर बेस से हटा दिया जाता है।

अनइंस्टॉल ट्रैकिंग का उपयोग करें

अनइंस्टॉल ट्रैकिंग यह पता लगाकर आपकी पुश सब्सक्राइबर सूची को सटीक रखती है कि उपयोगकर्ता आपके ऐप को कब अनइंस्टॉल करते हैं। यह Pushwoosh को स्वचालित रूप से अमान्य टोकन हटाने की अनुमति देता है।

ध्यान दें: अनइंस्टॉल ट्रैकिंग केवल iOS और Android पर समर्थित है।

यह इस तरह काम करता है:

Pushwoosh सभी सब्सक्राइब्ड डिवाइस पर दिन में एक बार एक साइलेंट पुश नोटिफिकेशन भेजता है। ये साइलेंट नोटिफिकेशन उपयोगकर्ताओं के लिए अदृश्य होते हैं, जिनमें कोई अलर्ट, ध्वनि या बैज नहीं होता है।
प्रत्येक डिवाइस में एक नोटिफिकेशन गेटवे द्वारा प्रदान किया गया एक अद्वितीय पुश टोकन होता है। यदि ऐप अनइंस्टॉल कर दिया गया है, तो टोकन अमान्य हो जाता है। जब साइलेंट पुश विफल हो जाता है, तो गेटवे एक त्रुटि लौटाता है।
Pushwoosh त्रुटि का पता लगाता है और आपकी सब्सक्राइबर सूची से अमान्य टोकन को हटा देता है।

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

अनइंस्टॉल ट्रैकिंग की सीमाएँ

नोटिफिकेशन गेटवे साइलेंट पुश की डिलीवरी की गारंटी नहीं देते हैं। इन संदेशों को गेटवे द्वारा प्राथमिकता कम की जा सकती है या छोड़ दिया जा सकता है, जिससे अनइंस्टॉल का पता लगाने में देरी या सटीकता सीमित हो सकती है। और जानें

अनइंस्टॉल डेटा देखें

अनइंस्टॉल गतिविधि की निगरानी के लिए, अपने Pushwoosh कंट्रोल पैनल में सांख्यिकी > डैशबोर्ड > एप्लिकेशन डैशबोर्ड पर जाएँ। ऐप अनइंस्टॉल ग्राफ आपके एप्लिकेशन के लिए अनइंस्टॉल रुझानों का एक टाइमलाइन दृश्य प्रदान करता है।

क्या आप पुश टोकन हटाने के बाद उपयोगकर्ताओं को पुनर्स्थापित कर सकते हैं?

किसी भी समर्थित विधि का उपयोग करके पुश टोकन को हटाना आसानी से प्रतिवर्ती है।

जब कोई उपयोगकर्ता आपका ऐप फिर से खोलता है:

Pushwoosh SDK स्वचालित रूप से एक नए पुश टोकन का अनुरोध करता है।
यह फिर डिवाइस को फिर से पंजीकृत करता है (registerDevice के माध्यम से)।
उपयोगकर्ता फिर से एक सक्रिय सब्सक्राइबर बन जाता है और आगे पुश नोटिफिकेशन प्राप्त करेगा।