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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

पुशवूश और सेगमेंट दोनों में पेड अकाउंट

सिंक्रनाइज़ की गई एंटिटीज़

सोर्स

• पुश आँकड़े

डेस्टिनेशन

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

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

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

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

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

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

यूज़र मैनेजमेंट

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

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

नोट

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

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

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

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

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

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

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

मैं API की और एप्लीकेशन कोड कहां ढूंढ सकता हूं?

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

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

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

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

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

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

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

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

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

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

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

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

नोट

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

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

स्ट्रीम

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

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

इवेंट्स

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

इवेंट का नाम	विवरण
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	संदेश का प्रकार (Push, Email, In-App या SMS) शामिल है
campaign_code	संदेश अभियान का अद्वितीय पहचानकर्ता
device_type	डिवाइस का प्रकार

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

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

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

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

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

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

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

डेस्टिनेशन

track-user

अपने Pushwoosh account > Your Connected Application > Audience > User Explorer पर जाएं। अपने उपयोगकर्ता/डिवाइस को ढूंढें और उन टैग्स की जांच करें जो सेगमेंट ने भेजे हैं।

post-event

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

delete-user

अपने PW account > Your Connected Application > Audience > User Explorer पर जाएं। सुनिश्चित करें कि उपयोगकर्ता/डिवाइस मौजूद नहीं है।

सोर्स

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

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

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

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

डेस्टिनेशन

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

सोर्स

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

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

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

प्रमाणीकरण संबंधी समस्याएं

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

डेटा प्रवाह संबंधी समस्याएं

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

अक्सर पूछे जाने वाले प्रश्न

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

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

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

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

अगर मुझे इंटीग्रेशन में कोई समस्या आती है तो मुझे क्या करना चाहिए?

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

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

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

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

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