सेगमेंट इंटीग्रेशन

डेवलपर सहायता की आवश्यकता है

इंटीग्रेशन सेट अप करने के लिए आपको अपनी डेवलपमेंट टीम से मदद की आवश्यकता होगी। कृपया इस गाइड को उनके साथ साझा करें।

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

एक बार इंटीग्रेशन सेट हो जाने के बाद, सेगमेंट निम्नलिखित डेटा Pushwoosh को भेजेगा:

• उपयोगकर्ता विशेषताएँ: नाम, डिवाइस, प्राथमिकताएँ, स्थान, व्यवहार, आदि। Pushwoosh इस डेटा को प्रत्येक उपयोगकर्ता के लिए टैग्स और उनके मानों के रूप में सहेजेगा।
• इवेंट्स: प्रत्येक सेगमेंट इवेंट को Pushwoosh में स्थानांतरित किया जाएगा और उसी नाम के साथ Pushwoosh इवेंट के रूप में सहेजा जाएगा। Pushwoosh को यह भी जानकारी मिलेगी कि प्रत्येक उपयोगकर्ता ने कौन से इवेंट्स ट्रिगर किए हैं।

सेगमेंट डेटा का उपयोग करके, आप Pushwoosh में सहज संचार के साथ अपने दर्शकों का अनुसरण कर सकते हैं। नीचे दो प्लेटफ़ॉर्म की शक्ति का लाभ उठाने के दो उदाहरण दिए गए हैं:

1. उपयोगकर्ता व्यवहार डेटा के आधार पर लक्षित अभियान बनाएँ। विशिष्ट उपयोगकर्ता व्यवहार के आधार पर Pushwoosh में सटीक उपयोगकर्ता सेगमेंट बनाने के लिए सेगमेंट से इवेंट्स डेटा का उपयोग करें।

उदाहरण के लिए, सेगमेंट SubscribedToOffers इवेंट के बारे में डेटा Pushwoosh को भेजता है। आप Pushwoosh में उन उपयोगकर्ताओं का एक उपयोगकर्ता सेगमेंट बना सकते हैं जिन्होंने विशेष ऑफ़र के लिए सब्सक्राइब किया है:

फिर, आप उन उपयोगकर्ताओं के लिए प्रोमो संदेशों और छूटों के साथ आकर्षक कस्टमर जर्नी बना सकते हैं जिन्होंने आपके ऑफ़र के लिए सब्सक्राइब किया है:

2. सेगमेंट से उपयोगकर्ता विशेषताओं के आधार पर संदेशों को वैयक्तिकृत करें। आप अपने पुश नोटिफिकेशन, इन-ऐप संदेशों और ईमेल की सामग्री को संशोधित करने के लिए सेगमेंट से प्राप्त उपयोगकर्ता विशेषताओं का लाभ उठा सकते हैं। यह आपको प्रासंगिक और उच्च-परिवर्तित संचार स्थापित करने की अनुमति देगा।

उदाहरण के लिए, सेगमेंट searched_product विशेषता मान Pushwoosh को भेजता है। आप एक पुश प्रीसेट बना सकते हैं जो उन उत्पादों पर छूट प्रदान करता है जिन्हें उपयोगकर्ता ने पहले खोजा है:

प्रत्येक उपयोगकर्ता को उस सटीक उत्पाद श्रेणी पर छूट की पेशकश करने वाला एक पुश प्राप्त होगा जिसे उन्होंने पहले ब्राउज़ किया था। उदाहरण के लिए, जिन्होंने स्पोर्ट्स शूज़ की खोज की थी, वे यह संदेश देखेंगे:

इंटीग्रेशन का अवलोकन

इंटीग्रेशन का प्रकार

• डेस्टिनेशन: डेटा सेगमेंट से Pushwoosh को भेजा जाता है।
• सोर्स: डेटा Pushwoosh से सेगमेंट को भेजा जाता है।

पूर्वापेक्षाएँ

Pushwoosh और सेगमेंट दोनों में पेड अकाउंट

सिंक्रनाइज़ की गई इकाइयाँ

सोर्स

• पुश सांख्यिकी

डेस्टिनेशन

• डिवाइस
• टैग्स

उपयोग के मामले

नोटिफिकेशन ट्रैक करना

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

इवेंट विश्लेषण

उपयोगकर्ता-ट्रिगर किए गए इवेंट्स का विश्लेषण करें, जैसे कि पुश नोटिफिकेशन या ईमेल डिलीवरी, और सुनिश्चित करें कि ये इवेंट्स सेगमेंट में सटीक रूप से दर्ज किए गए हैं।

उपयोगकर्ता प्रबंधन

उपयोगकर्ता जानकारी को पंजीकृत और प्रबंधित करें, जिसमें उपयोगकर्ताओं को प्रासंगिक विशेषताओं के साथ टैग करना या आवश्यकता पड़ने पर उपयोगकर्ताओं को हटाना शामिल है।

इंटीग्रेशन सेट अप करना

नोट

सेगमेंट के साथ इंटीग्रेशन सेट अप करने से पहले, Pushwoosh SDK को इंटीग्रेट करना सुनिश्चित करें।

एक डेस्टिनेशन कॉन्फ़िगर करना

1. सेगमेंट इंटरफ़ेस में, Connections → Destinations पर नेविगेट करें और Add Destination पर क्लिक करें।

2. Pushwoosh खोजें और इसे चुनें।

3. उन सोर्स को चुनें जिन्हें आप डेस्टिनेशन से कनेक्ट करना चाहते हैं।

4. डेस्टिनेशन सेटिंग्स पर जाएँ:

5. Pushwoosh API की और एप्लिकेशन कोड दर्ज करें। सुनिश्चित करें कि Enable Destination स्विच चालू है। उसके बाद, Save Changes पर क्लिक करें।

मुझे API की और एप्लिकेशन कोड कहाँ मिल सकता है?

आप API की Settings → API Access सेक्शन में पा सकते हैं:

एप्लिकेशन कोड Pushwoosh इंटरफ़ेस के ऊपरी बाएँ कोने में, प्रोजेक्ट नाम के ठीक नीचे पाया जा सकता है:

6. Mappings टैब पर जाएँ और सुनिश्चित करें कि Create or Update User Profile और Track Events विकल्प सक्षम हैं:

यह सत्यापित करना महत्वपूर्ण है कि आपके सोर्स से Pushwoosh तक इवेंट फ़ील्ड की मैपिंग सही है ताकि यह सुनिश्चित हो सके कि आपके इवेंट्स सही ढंग से संसाधित हों।

यदि किसी इवेंट में device_platform फ़ील्ड नहीं है या यह फ़ील्ड गलत है, तो आपके इवेंट को अनदेखा कर दिया जाएगा। इसके अतिरिक्त, यदि किसी इवेंट में userId या deviceId नहीं है, तो इसे भी अनदेखा कर दिया जाएगा।

यह सुनिश्चित करने के लिए कि आपकी मैपिंग सही ढंग से कॉन्फ़िगर की गई है, Pushwoosh as Destination > Settings पर जाएँ।

फिर, Mapping टैब चुनें और Track Events मेथड के लिए Edit Mapping पर क्लिक करें।

इसके बाद, सुनिश्चित करें कि आपके इवेंट्स की मैपिंग Pushwoosh को भेजे गए इवेंट्स से सही है, और Device Platform और External User ID (या Device ID) फ़ील्ड ठीक से मेल खाते हैं।

आपका इवेंट ऊपर दिए गए उदाहरण से भिन्न हो सकता है। हालाँकि, कुंजी यह है कि Pushwoosh को भेजे गए इवेंट के लिए प्लेटफ़ॉर्म और डिवाइस के लिए डेटा ट्रांसफर का मिलान किया जाए।

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

एक सोर्स कॉन्फ़िगर करना

1. अपने वर्कस्पेस के सोर्स कैटलॉग पेज से, Add Source पर क्लिक करें।
2. सोर्स कैटलॉग में “Pushwoosh” खोजें, Pushwoosh चुनें, और Add Source पर क्लिक करें।
3. अगली स्क्रीन पर, सोर्स को एक नाम दें और कोई अन्य सेटिंग्स कॉन्फ़िगर करें।

नोट

नाम का उपयोग सेगमेंट ऐप में एक लेबल के रूप में किया जाता है, और सेगमेंट आपके वेयरहाउस में एक संबंधित स्कीमा नाम बनाता है। नाम कुछ भी हो सकता है, लेकिन Pushwoosh कुछ ऐसा उपयोग करने की सलाह देता है जो सोर्स को ही दर्शाता है और आपके वातावरण के बीच अंतर करता है (उदाहरण के लिए: Pushwoosh_Prod, Pushwoosh_Staging, Pushwoosh_Dev)।

4. अपनी सेटिंग्स को सहेजने के लिए Add Source पर क्लिक करें।
5. सेगमेंट UI से Write key कॉपी करें।
6. अपने Pushwoosh खाते में लॉग इन करें, और उस एप्लिकेशन का चयन करें जिसे आप कनेक्ट करना चाहते हैं।
7. Settings > 3rd party integration > Segment पर नेविगेट करें, Configure बटन पर क्लिक करें, और अपने सेगमेंट वर्कस्पेस से अपनी Write key दर्ज करें।
8. उन इवेंट्स को सूचीबद्ध करें जिन्हें आप Events फ़ील्ड में , सीमांकक का उपयोग करके निर्यात करना चाहते हैं, या यदि आप सभी इवेंट्स निर्यात करना चाहते हैं तो इसे खाली छोड़ दें, फिर Apply पर क्लिक करें।

स्ट्रीम

Pushwoosh सेगमेंट इवेंट डेटा भेजने के लिए सेगमेंट स्ट्रीम सोर्स घटक का उपयोग करता है। यह सेगमेंट को डेटा भेजने के लिए सर्वर-साइड ट्रैक विधि का उपयोग करता है। ये इवेंट्स फिर किसी भी डेस्टिनेशन में उपलब्ध होते हैं जो सर्वर-साइड इवेंट्स को स्वीकार करता है, और आपके डेटा वेयरहाउस में एक स्कीमा में उपलब्ध होते हैं।

डिफ़ॉल्ट रूप से, Pushwoosh Pushwoosh User ID को सेगमेंट userId प्रॉपर्टी के रूप में पास करता है। यदि कोई संबंधित User ID नहीं है, तो Pushwoosh HWID को सेगमेंट anonymousId के रूप में पास करेगा।

इवेंट्स

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

इवेंट का नाम	विवरण
ईमेल भेजा गया	ईमेल सफलतापूर्वक भेजा गया
पुश भेजा गया	पुश नोटिफिकेशन सफलतापूर्वक भेजा गया
SMS भेजा गया	SMS प्राप्तकर्ता को भेजा गया
पुश खोला गया	पुश नोटिफिकेशन खोला गया
ईमेल खोला गया	ईमेल नोटिफिकेशन खोला गया
ईमेल डिलीवर हुआ	ईमेल सफलतापूर्वक डिलीवर हुआ
पुश डिलीवर हुआ	पुश नोटिफिकेशन सफलतापूर्वक डिलीवर हुआ
SMS डिलीवर हुआ	SMS सफलतापूर्वक डिलीवर हुआ
SMS डिलीवर नहीं हुआ	SMS डिलीवरी विफल रही
ईमेल बाउंस हुआ	स्थायी त्रुटि के कारण ईमेल प्रेषक को वापस कर दिया गया
ईमेल अनसब्सक्राइब किया गया	ईमेल अनसब्सक्राइब लिंक पर क्लिक किया गया

इवेंट प्रॉपर्टीज़

नीचे दी गई तालिका ऊपर सूचीबद्ध इवेंट्स में शामिल प्रॉपर्टीज़ को सूचीबद्ध करती है।

प्रॉपर्टी का नाम	विवरण
message_type	संदेश का प्रकार (पुश, ईमेल, इन-ऐप या SMS) शामिल है
campaign_code	संदेश अभियान का अद्वितीय पहचानकर्ता
device_type	डिवाइस का प्रकार

डेस्टिनेशन जोड़ना

अब जब आपका सोर्स सेट हो गया है, तो आप इसे डेस्टिनेशन से कनेक्ट कर सकते हैं।

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

यदि सेगमेंट में इवेंट्स के आने में कोई समस्या है, तो हमारी सहायता टीम से संपर्क करें।

इंटीग्रेशन कैसे काम करता है

1. पुश नोटिफिकेशन की शुरुआत: एक क्लाइंट Pushwoosh इंटरफ़ेस के माध्यम से एक पुश नोटिफिकेशन शुरू करके प्रक्रिया शुरू करता है।
2. इवेंट उत्पादन: Pushwoosh बैकएंड पुश नोटिफिकेशन अनुरोध को संसाधित करता है और एक इवेंट उत्पन्न करता है। यह इवेंट फिर Pushwoosh द्वारा प्रबंधित channels-tracking-log नामक काफ्का विषय पर भेजा जाता है।
3. इवेंट की खपत: सेगमेंट इंटीग्रेशन सेवा लगातार channels-tracking-log काफ्का विषय को सुनती है और इवेंट्स के आने पर उनका उपभोग करती है।
4. इवेंट प्रसंस्करण: उपभोग किए गए इवेंट्स को सेगमेंट इंटीग्रेशन सेवा द्वारा संसाधित किया जाता है, जो उन्हें सेगमेंट ट्रैक इवेंट्स में बदल देती है।
5. इवेंट ट्रांसमिशन: संसाधित सेगमेंट ट्रैक इवेंट्स को फिर आगे की हैंडलिंग और विश्लेषण के लिए सेगमेंट बैकएंड में भेजा जाता है।

आपको कैसे पता चलेगा कि इंटीग्रेशन काम कर रहा है?

डेस्टिनेशन

ट्रैक-यूज़र

अपने Pushwoosh खाते > आपका कनेक्टेड एप्लिकेशन > ऑडियंस > यूज़र एक्सप्लोरर पर जाएँ। अपने उपयोगकर्ता/डिवाइस को ढूंढें और उन टैग्स की जाँच करें जो सेगमेंट ने भेजे हैं।

पोस्ट-इवेंट

अपने Pushwoosh खाते > आपका कनेक्टेड एप्लिकेशन > ऑडियंस > इवेंट्स पर जाएँ। इवेंट चुनें, तीन-डॉट मेनू पर क्लिक करें, और इवेंट सांख्यिकी चुनें। सुनिश्चित करें कि इवेंट गिना गया है।

डिलीट-यूज़र

अपने PW खाते > आपका कनेक्टेड एप्लिकेशन > ऑडियंस > यूज़र एक्सप्लोरर पर जाएँ। सुनिश्चित करें कि उपयोगकर्ता/डिवाइस मौजूद नहीं है।

सोर्स

सोर्स डीबगर का उपयोग उन इवेंट्स का पता लगाने के लिए करें जो Pushwoosh से सेगमेंट में भेजे गए थे।

समस्या निवारण

इंटीग्रेशन स्थिति की जाँच करें

Pushwoosh इंटीग्रेशन के साथ समस्याओं का निवारण करने के लिए, निम्नलिखित को सत्यापित करके शुरू करें:

डेस्टिनेशन

• ट्रैक-यूज़र: ऑडियंस > यूज़र एक्सप्लोरर के तहत Pushwoosh में उपयोगकर्ता/डिवाइस जानकारी और टैग सत्यापित करें।
• पोस्ट-इवेंट: इवेंट सांख्यिकी की जाँच करके सुनिश्चित करें कि इवेंट Pushwoosh में गिना गया है।
• डिलीट-यूज़र: पुष्टि करें कि उपयोगकर्ता/डिवाइस अब Pushwoosh में मौजूद नहीं है।

सोर्स

सेगमेंट डीबगर पर सोर्स डीबगर का उपयोग यह जांचने के लिए करें कि क्या Pushwoosh से इवेंट्स ठीक से सेगमेंट में भेजे जा रहे हैं।

इवेंट का मेल न खाना

यदि इवेंट्स सेगमेंट में सही ढंग से दिखाई नहीं दे रहे हैं, तो सुनिश्चित करें कि Pushwoosh इवेंट्स प्रदान किए गए मैपिंग नियमों के अनुसार सेगमेंट ट्रैक इवेंट्स से सही ढंग से मैप किए गए हैं।

प्रमाणीकरण समस्याएँ

सत्यापित करें कि Pushwoosh और सेगमेंट के अनुरोधों में सही प्रमाणीकरण टोकन या API की का उपयोग किया गया है।

डेटा प्रवाह समस्याएँ

पुष्टि करें कि Pushwoosh और सेगमेंट के बीच डेटा प्रवाह निर्बाध है और काफ्का विषयों की सही ढंग से निगरानी की जा रही है।

सामान्य प्रश्न

Pushwoosh से सेगमेंट में किस प्रकार के इवेंट्स भेजे जाते हैं?

आरक्षित इवेंट्स जैसे पुश भेजा गया, ईमेल भेजा गया, SMS भेजा गया, पुश डिलीवर हुआ, ईमेल डिलीवर हुआ, SMS डिलीवर हुआ, और ईमेल बाउंस हुआ सेगमेंट में भेजे जाते हैं।

मैं कैसे सत्यापित कर सकता हूँ कि इवेंट्स सही ढंग से सेगमेंट में भेजे गए हैं?

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

यदि मुझे इंटीग्रेशन के साथ समस्याओं का सामना करना पड़ता है तो मुझे क्या करना चाहिए?

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

इंटीग्रेशन में उपयोगकर्ता और डिवाइस की जानकारी को कैसे संभाला जाता है?

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

मैं इंटीग्रेशन के लिए विस्तृत दस्तावेज़ीकरण कहाँ पा सकता हूँ?

विस्तृत दस्तावेज़ीकरण सेगमेंट और Pushwoosh इंटीग्रेशन मैनुअल में, साथ ही उनके संबंधित API दस्तावेज़ीकरण में उपलब्ध है।