एम्प्लिट्यूड इंटीग्रेशन

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

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

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

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

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

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

गंतव्य: डेटा एम्प्लिट्यूड से Pushwoosh को भेजा जाता है।

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

एम्प्लिट्यूड से Pushwoosh तक इवेंट स्ट्रीमिंग और कोहोर्ट सिंक इंटीग्रेशन सेट करने के लिए, सुनिश्चित करें कि निम्नलिखित पूर्वापेक्षाएँ पूरी हों:

• आपके पास एक सक्रिय Pushwoosh खाता होना चाहिए।
• डेटा भेजने के लिए Pushwoosh में एक API एक्सेस टोकन जेनरेट करें।
• इंटीग्रेशन को कॉन्फ़िगर करने से पहले अपना Pushwoosh एप्लिकेशन कोड खोजें।
• यह इंटीग्रेशन केवल सशुल्क योजनाओं वाले एम्प्लिट्यूड ग्राहकों के लिए उपलब्ध है।
• इस इंटीग्रेशन का उपयोग करने के लिए आपके पास एक सशुल्क Pushwoosh योजना होनी चाहिए।

शब्दावली (यदि वे भिन्न हैं तो इकाई नामों का मानचित्रण)

एम्प्लिट्यूड में कोहोर्ट्स = Pushwoosh में सेगमेंट्स

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

• इवेंट्स
• टैग्स
• सेगमेंट्स

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

Pushwoosh के साथ एम्प्लिट्यूड इंटीग्रेशन उपयोगकर्ता जुड़ाव और विभाजन को बढ़ाने के लिए दो प्लेटफार्मों के बीच डेटा को सिंक करके संचालित होता है। यह कैसे काम करता है इसका विस्तृत विवरण यहां दिया गया है:

डेटा ट्रांसमिशन

• इवेंट्स: एम्प्लिट्यूड Pushwoosh को इवेंट डेटा भेजता है। प्रत्येक इवेंट में एक यूजर आईडी (external_id), एक एप्लिकेशन कोड (app_id), इवेंट का नाम (event_name), एक टाइमस्टैम्प (created_at) और इवेंट प्रॉपर्टीज़ (properties) होती हैं।

  • Pushwoosh प्लेटफ़ॉर्म properties.platform (iOS, Android या Web) से लेता है। इसके बिना आने वाला इवेंट iOS इवेंट के रूप में रिकॉर्ड होता है।
  • Pushwoosh डिवाइस आईडी properties.device_id से लेता है। इसके बिना यूजर आईडी को ही डिवाइस आईडी के रूप में इस्तेमाल किया जाता है।
  • किसी भी प्रकार की प्रॉपर्टी वैल्यू स्वीकार की जाती है और इवेंट एट्रिब्यूट्स के रूप में सहेजी जाती है। संख्याएँ और बूलियन उनके टेक्स्ट रूप में रखे जाते हैं, और खाली (null) वैल्यू छोड़ दी जाती हैं।
  • पहली बार प्राप्त होने पर Pushwoosh में नया इवेंट अपने-आप बन जाता है। इसके एट्रिब्यूट्स के प्रकार वैल्यू से तय होते हैं: दिनांक, पूर्णांक, बूलियन, कीमत या स्ट्रिंग। जब किसी मौजूदा इवेंट में नई प्रॉपर्टी आती है, तो Pushwoosh उसे अपने-आप एट्रिब्यूट के रूप में जोड़ देता है, प्रति इवेंट अधिकतम 100 एट्रिब्यूट्स तक। ऐसे एट्रिब्यूट्स का प्रकार केवल टेक्स्ट से तय होता है, जैसे दिनांक, वर्ज़न या स्ट्रिंग, इसलिए बाद में जोड़ी गई संख्यात्मक प्रॉपर्टी स्ट्रिंग एट्रिब्यूट बन जाती है।

• टैग्स: Pushwoosh यूजर प्रॉपर्टीज़ प्राप्त करता है और उन्हें यूजर पर टैग्स के रूप में सहेजता है। प्रत्येक अनुरोध में एक यूजर आईडी (external_id, आवश्यक), एक एप्लिकेशन कोड (app_id) और यूजर प्रॉपर्टीज़ (properties) होती हैं।

  • जो टैग मौजूद नहीं हैं, वे अपने-आप बन जाते हैं; उनका प्रकार वैल्यू से उसी तरह तय होता है जैसे इवेंट एट्रिब्यूट्स के लिए।
  • Pushwoosh के डिफ़ॉल्ट टैग्स जैसे नाम वाली प्रॉपर्टीज़, जैसे Language, Country या Timezone, अनदेखी कर दी जाती हैं।

• सेगमेंट्स: प्रत्येक सिंक किए गए कोहोर्ट के लिए Pushwoosh कोहोर्ट के नाम से एक सेगमेंट बनाता है। कोहोर्ट सदस्यता यूजर पर CSV import लिस्ट टैग की वैल्यू के रूप में सहेजी जाती है, और यूजर्स का मिलान User ID से होता है। जैसे-जैसे एम्प्लिट्यूड कोहोर्ट को सिंक करता है, यूजर्स सेगमेंट में जोड़े या उससे हटाए जाते हैं।

डेटा प्रवाह

• इवेंट्स और टैग्स: एम्प्लिट्यूड में ट्रैक किए गए उपयोगकर्ता इंटरैक्शन या विशेषताओं के आधार पर डेटा एम्प्लिट्यूड से Pushwoosh को भेजा जाता है। एम्प्लिट्यूड में सेट किए गए कॉन्फ़िगरेशन और मैपिंग के अनुसार Pushwoosh में इवेंट्स और टैग्स बनाए या अपडेट किए जाते हैं।

• सेगमेंट्स: Pushwoosh में सेगमेंट्स तब बनाए जाते हैं जब एम्प्लिट्यूड एक अनुरोध करता है। Pushwoosh प्रत्येक सेगमेंट के लिए एक अद्वितीय पहचानकर्ता उत्पन्न करता है, जिसका उपयोग एम्प्लिट्यूड उपयोगकर्ताओं को जोड़कर या हटाकर सेगमेंट में हेरफेर करने के लिए करता है।

अनुरोध

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

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

इवेंट ट्रैकिंग

एम्प्लिट्यूड से उपयोगकर्ता कार्यों और इंटरैक्शन को ट्रैक करें और इन घटनाओं को सूचनाओं या अपडेट को ट्रिगर करने के लिए Pushwoosh को भेजें।

उपयोगकर्ता टैगिंग

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

सेगमेंट प्रबंधन

एम्प्लिट्यूड में कॉन्फ़िगर किए गए डेटा और सेगमेंट के आधार पर Pushwoosh में उपयोगकर्ता सेगमेंट बनाएं और प्रबंधित करें। यह व्यक्तिगत संदेशों के साथ उपयोगकर्ताओं के विशिष्ट समूहों को लक्षित करने में मदद करता है।

स्वचालित उपयोगकर्ता प्रबंधन

एम्प्लिट्यूड में उनके कार्यों या विशेषताओं के आधार पर उपयोगकर्ताओं को स्वचालित रूप से सेगमेंट से जोड़ें या हटाएं, Pushwoosh में अप-टू-डेट विभाजन सुनिश्चित करें।

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

कोहोर्ट सिंक

Pushwoosh सेटअप

1. Pushwoosh में, Settings > API Access में एक API एक्सेस टोकन बनाएँ या कॉपी करें।
2. उस ऐप का एप्लिकेशन कोड कॉपी करें जिसमें आप कोहोर्ट सिंक करना चाहते हैं।

एम्प्लिट्यूड सेटअप

इंटीग्रेशन के लिए एम्प्लिट्यूड को कॉन्फ़िगर करने के लिए, इन चरणों का पालन करें:

1. अपने एम्प्लिट्यूड Data में, Catalog पर जाएं और Destinations चुनें।
2. कोहोर्ट सेक्शन के तहत, Pushwoosh का पता लगाएं और क्लिक करें।

3. Add another destination पर क्लिक करें।

4. एक नाम प्रदान करें और Pushwoosh से कॉपी की गई API एक्सेस टोकन पेस्ट करें।

5. एम्प्लिट्यूड यूजर आईडी फ़ील्ड को Pushwoosh यूजर आईडी फ़ील्ड में मैप करें। Pushwoosh कोहोर्ट सदस्यों का मिलान User ID से करता है, इसलिए आपके द्वारा चुने गए एम्प्लिट्यूड फ़ील्ड में वही वैल्यू होनी चाहिए जो आपका ऐप Pushwoosh में User ID के रूप में सेट करता है। एम्प्लिट्यूड के सेटअप पेज के अनुसार इस फ़ील्ड में ईमेल पता होना चाहिए। अगर आपका ऐप Pushwoosh User ID के रूप में कोई अलग वैल्यू सेट करता है, तो कोहोर्ट सदस्यों का मिलान नहीं होता। ऐसे में, Pushwoosh SDK में यूजर के ईमेल को User ID के रूप में सेट करें, या Pushwoosh सपोर्ट से संपर्क करें।
6. जब आप पूरा कर लें तो अपनी सेटिंग्स सहेजें।

एक कोहोर्ट भेजना

अपने पहले कोहोर्ट को सिंक्रनाइज़ करने के लिए, निम्नलिखित चरणों को पूरा करें:

1. एम्प्लिट्यूड में, उस कोहोर्ट को खोलें जिसे आप सिंक्रनाइज़ करना चाहते हैं, फिर Sync पर क्लिक करें।

2. Pushwoosh चुनें और उस खाते का चयन करें जिसके साथ आप सिंक्रनाइज़ करना चाहते हैं। फिर, Next पर क्लिक करें।

3. सिंक्रनाइज़ेशन ताल पर निर्णय लें और अपने कॉन्फ़िगरेशन को सहेजें।

इवेंट स्ट्रीमिंग

Pushwoosh सेटअप

1. Settings > API Access में एक API एक्सेस टोकन बनाएँ या कॉपी करें।

2. अपने ऐप का एप्लिकेशन कोड कॉपी करें।

एम्प्लिट्यूड सेटअप

1. एम्प्लिट्यूड में, Data Destinations पर जाएं और Pushwoosh - Event Stream खोजें।

2. एक सिंक नाम दर्ज करें और फिर Create Sync पर क्लिक करें।

3. स्थिति को Disabled से Enabled में बदलें और अपना Pushwoosh API एक्सेस टोकन और एप्लिकेशन कोड पेस्ट करें।

4. बाएं ड्रॉपडाउन से, एम्प्लिट्यूड उपयोगकर्ता संपत्ति का चयन करें जो आपके Pushwoosh UserID से मेल खाती है।
5. (वैकल्पिक) यदि आप उपयोगकर्ताओं और उनकी संपत्तियों को वास्तविक समय में भेजना चाहते हैं, जब भी एम्प्लिट्यूड उपयोगकर्ता संपत्ति बनाता है या अपडेट करता है, तो Create & Update users टॉगल को सक्षम करें।

6. यदि आप Pushwoosh पर ईवेंट स्ट्रीम करना चाहते हैं तो Send Events (“Events are sent to Pushwoosh”) को सक्षम करें। यह स्वचालित रूप से ईवेंट को Pushwoosh पर अग्रेषित करेगा क्योंकि वे एम्प्लिट्यूड में शामिल होते हैं। इस इंटीग्रेशन का उपयोग करके ईवेंट शेड्यूल पर या मांग पर नहीं भेजे जाते हैं।

8. फिर, चुनें कि आप Select and Filter Events सेक्शन में कौन से इवेंट भेजना चाहते हैं। केवल उन इवेंट्स का चयन करें जिनकी आपको Pushwoosh में आवश्यकता है; रूपांतरित इवेंट्स समर्थित नहीं हैं।
9. एक बार हो जाने पर, गंतव्य को सक्षम करें और Save पर क्लिक करें।

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

यह सत्यापित करने के लिए कि एम्प्लिट्यूड और Pushwoosh इंटीग्रेशन सही ढंग से काम कर रहा है, आप निम्नलिखित तरीकों का उपयोग कर सकते हैं:

Pushwoosh डैशबोर्ड की निगरानी करें

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

API प्रतिक्रियाओं की जाँच करें

• सफल प्रतिक्रियाएं: सुनिश्चित करें कि आपको Pushwoosh API एंडपॉइंट्स से 200 OK प्रतिक्रियाएं प्राप्त हों। यद्यपि हमेशा एक प्रतिक्रिया निकाय नहीं हो सकता है, 200 OK स्थिति इंगित करती है कि अनुरोध सफलतापूर्वक प्राप्त हो गया था।
• त्रुटि प्रतिक्रियाएं: यदि कुछ काम नहीं कर रहा है, तो सुराग के लिए 200 OK के अलावा अन्य स्टेटस कोड की समीक्षा करें:
  • 400 Bad Request: अनुरोध बॉडी मान्य JSON नहीं है, या यूजर आईडी मौजूद नहीं है।
  • 401 Unauthorized: API टोकन या एप्लिकेशन कोड मौजूद नहीं है या अमान्य है, या टोकन किसी दूसरे खाते का है।
  • 503 Service Unavailable: Pushwoosh अस्थायी रूप से इवेंट को प्रोसेस नहीं कर पा रहा है। अनुरोध दोबारा भेजा जा सकता है।
  • अन्य 5xx कोड: API टोकन की जाँच, टैग्स सहेजने, सेगमेंट बनाने या कोहोर्ट सदस्यता अपडेट करने के दौरान आंतरिक त्रुटि। बाद में अनुरोध दोबारा भेजें।
• जिन इवेंट्स को Pushwoosh उनकी सामग्री के कारण अस्वीकार करता है, उन्हें भी 200 OK मिलता है और वे प्रोसेस नहीं होते, इसलिए केवल 200 OK से यह पुष्टि नहीं होती कि इवेंट रिकॉर्ड हुआ है।

अनुरोधों और प्रतिक्रियाओं को लॉग करें

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

नमूना डेटा के साथ परीक्षण करें

• परीक्षण इवेंट्स/टैग्स भेजें: एम्प्लिट्यूड से Pushwoosh पर परीक्षण इवेंट्स और टैग्स बनाएं और भेजें। सत्यापित करें कि ये परीक्षण प्रविष्टियाँ Pushwoosh में सही ढंग से दिखाई देती हैं और अपेक्षित व्यवहारों को ट्रिगर करती हैं।
• उपयोगकर्ता क्रियाओं का अनुकरण करें: एम्प्लिट्यूड में ऐसी क्रियाएं करें जो Pushwoosh में विशिष्ट घटनाओं या अपडेट को ट्रिगर करें। जांचें कि क्या इन क्रियाओं के परिणामस्वरूप Pushwoosh में अपेक्षित परिवर्तन होते हैं।

निगरानी उपकरणों का उपयोग करें

• इंटीग्रेशन निगरानी: निगरानी उपकरण या सेवाओं का उपयोग करें जो इंटीग्रेशन के स्वास्थ्य और प्रदर्शन को ट्रैक कर सकते हैं। ये उपकरण आपको वास्तविक समय में समस्याओं या विफलताओं के प्रति सचेत कर सकते हैं।
• एनालिटिक्स और रिपोर्टिंग: डेटा प्रवाह और इंटीग्रेशन प्रदर्शन की समीक्षा के लिए एम्प्लिट्यूड और Pushwoosh दोनों में एनालिटिक्स सुविधाओं का उपयोग करें।

इंटीग्रेशन दस्तावेज़ीकरण की समीक्षा करें

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

सहायता से संपर्क करें

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

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

इंटीग्रेशन संबंधी समस्याएं

• Pushwoosh में इवेंट दिखाई नहीं दे रहा है: सुनिश्चित करें कि इवेंट सही ढंग से मैप किया गया है, और सत्यापित करें कि Pushwoosh एप्लिकेशन कोड और API टोकन ठीक से कॉन्फ़िगर किए गए हैं।

• टैग सिंक नहीं हो रहे हैं: पुष्टि करें कि टैग सही ढंग से स्वरूपित हैं और अनुरोध में सभी आवश्यक प्रमाणीकरण विवरण शामिल हैं।

सेगमेंट की समस्याएं

• सेगमेंट नहीं बनाया गया: जांचें कि सेगमेंट बनाने का अनुरोध सही ढंग से स्वरूपित है और Pushwoosh API टोकन मान्य है।

• उपयोगकर्ता जोड़े/हटाए नहीं गए: सत्यापित करें कि उपयोगकर्ता आईडी सही ढंग से निर्दिष्ट हैं और सेगमेंट आईडी मान्य है। सुनिश्चित करें कि अनुरोध पेलोड ठीक से स्वरूपित है।

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

• कोई प्रतिक्रिया निकाय नहीं: 200 OK प्रतिक्रिया में कोई बॉडी नहीं होती। इससे यह पुष्टि नहीं होती कि इवेंट रिकॉर्ड हुआ है, क्योंकि सामग्री के कारण अस्वीकार किए गए इवेंट्स को भी 200 OK मिलता है (API प्रतिक्रियाओं की जाँच करें देखें)। Pushwoosh डैशबोर्ड की निगरानी करें में बताए अनुसार Pushwoosh में इवेंट की जाँच करें।

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

अगर मुझे 400 Bad Request त्रुटि मिलती है तो मुझे क्या करना चाहिए?

जब अनुरोध बॉडी मान्य JSON नहीं होती या यूजर आईडी (external_id) मौजूद नहीं होती, तो Pushwoosh 400 लौटाता है। जाँचें कि एम्प्लिट्यूड में यूजर आईडी मैपिंग ऐसी प्रॉपर्टी की ओर इशारा करती है जो हर यूजर के लिए भरी हुई है।

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

आने वाली घटनाओं, टैग और सेगमेंट अपडेट के लिए Pushwoosh डैशबोर्ड देखें। आप सफल डेटा ट्रांसफर के लिए API एंडपॉइंट से लॉग या प्रतिक्रियाओं की निगरानी भी कर सकते हैं।

क्या मैं Pushwoosh को भेजे गए इवेंट्स या टैग्स को कस्टमाइज़ कर सकता हूँ?

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

एम्प्लिट्यूड और Pushwoosh के बीच डेटा कितनी बार सिंक होता है?

एम्प्लिट्यूड से किए गए अनुरोधों के आधार पर डेटा रीयल-टाइम या लगभग रीयल-टाइम में सिंक होता है। सुनिश्चित करें कि आपका कॉन्फ़िगरेशन वांछित अपडेट आवृत्ति का समर्थन करता है।

मैं इस इंटीग्रेशन के लिए और जानकारी या सहायता कहाँ से प्राप्त कर सकता हूँ?

एम्प्लिट्यूड और Pushwoosh के आधिकारिक दस्तावेज़ देखें। अधिक सहायता के लिए, संबंधित सहायता टीमों से संपर्क करें।