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

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

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

सेगमेंट एक ग्राहक डेटा प्लेटफ़ॉर्म है जो उपयोगकर्ता डेटा एकत्र करने को सरल बनाता है और आपको इसका प्रभावी ढंग से लाभ उठाने में मदद करता है। यदि आप अपना ग्राहक डेटा सेगमेंट में संग्रहीत करते हैं, तो आप कुछ ही क्लिक में 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 उपयोगकर्ता आईडी को सेगमेंट userId प्रॉपर्टी के रूप में पास करता है। यदि कोई संबद्ध उपयोगकर्ता आईडी नहीं है, तो Pushwoosh HWID को सेगमेंट anonymousId के रूप में पास करेगा।

इवेंट्स

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

इवेंट का नाम	विवरण
Email Sent	ईमेल सफलतापूर्वक भेजा गया
Push Sent	पुश नोटिफिकेशन सफलतापूर्वक भेजा गया
SMS Sent	प्राप्तकर्ता को SMS भेजा गया
Push Opened	पुश नोटिफिकेशन खोला गया
Email Opened	ईमेल नोटिफिकेशन खोला गया
Email Delivered	ईमेल सफलतापूर्वक डिलीवर किया गया
Push Delivered	पुश नोटिफिकेशन सफलतापूर्वक डिलीवर किया गया
SMS Delivered	SMS सफलतापूर्वक डिलीवर किया गया
SMS Not Delivered	SMS डिलीवरी विफल रही
Email Bounced	स्थायी त्रुटि के कारण ईमेल प्रेषक को वापस कर दिया गया
Email Unsubscribed	ईमेल अनसब्सक्राइब लिंक पर क्लिक किया गया

इवेंट गुण

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

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

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

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

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

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

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

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

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

डेस्टिनेशन

track-user

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

post-event

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

delete-user

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

सोर्स

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

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

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

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

डेस्टिनेशन

• Track-User: Pushwoosh में Audience > User Explorer के तहत उपयोगकर्ता/डिवाइस जानकारी और टैग सत्यापित करें।
• Post-Event: सुनिश्चित करें कि इवेंट सांख्यिकी की जाँच करके Pushwoosh में इवेंट गिना गया है।
• Delete-User: पुष्टि करें कि उपयोगकर्ता/डिवाइस अब Pushwoosh में मौजूद नहीं है।

सोर्स

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

इवेंट का बेमेल होना

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

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

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

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

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

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

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

Push Sent, Email Sent, SMS Sent, Push Delivered, Email Delivered, SMS Delivered, और Email Bounced जैसे आरक्षित इवेंट्स सेगमेंट को भेजे जाते हैं।

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

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

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

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

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

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

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

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