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

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

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

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

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

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

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

डेस्टिनेशन: डेटा एम्प्लिट्यूड से पुशवूश में भेजा जाता है।

आवश्यक शर्तें

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

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

शब्दावली (यदि इकाई के नाम अलग हैं तो मैपिंग)

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

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

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

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

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

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

• इवेंट्स: एम्प्लिट्यूड इवेंट डेटा को पुशवूश में भेजता है। प्रत्येक इवेंट में एक उपयोगकर्ता आईडी (external_id), एक एप्लिकेशन कोड (app_id), एक टाइमस्टैम्प (created_at), और अतिरिक्त विशेषताएँ (attributes) होती हैं।

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

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

डेटा फ्लो

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

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

अनुरोध

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

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

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

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

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

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

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

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

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

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

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

कोहोर्ट सिंक

पुशवूश सेटअप

1. पुशवूश में, Settings > Integrations पर नेविगेट करें।

2. Add Integration पर क्लिक करें, फिर Amplitude खोजें और जोड़ें।

   

3. पुशवूश API Key और App Code को अपने क्लिपबोर्ड पर कॉपी करें।

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

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

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

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

4. एक नाम प्रदान करें और पुशवूश से कॉपी की गई API कुंजी पेस्ट करें।

5. एम्प्लिट्यूड उपयोगकर्ता आईडी फ़ील्ड को पुशवूश उपयोगकर्ता आईडी फ़ील्ड से मैप करें।
6. जब आप समाप्त कर लें तो अपनी सेटिंग्स सहेजें।

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

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

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

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

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

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

पुशवूश सेटअप

1. अपनी पुशवूश API कुंजी प्राप्त करें।

2. अपने पुशवूश खाते में ऐप कोड का पता लगाएँ।

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

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

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

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

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

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

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

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

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

पुशवूश डैशबोर्ड की निगरानी करें

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

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

• सफल प्रतिक्रियाएँ: सुनिश्चित करें कि आपको पुशवूश API एंडपॉइंट्स से 200 OK प्रतिक्रियाएँ प्राप्त होती हैं। यद्यपि हमेशा एक प्रतिक्रिया बॉडी नहीं हो सकती है, 200 OK स्थिति इंगित करती है कि अनुरोध सफलतापूर्वक प्राप्त हो गया था।
• त्रुटि प्रतिक्रियाएँ: यदि कुछ काम नहीं कर रहा है तो सुराग के लिए 200 OK के अलावा किसी भी त्रुटि प्रतिक्रिया या स्थिति कोड की समीक्षा करें। सामान्य त्रुटियों में 400 Bad Request, 401 Unauthorized, या 500 Internal Server Error शामिल हो सकते हैं।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

सेगमेंट समस्याएँ

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

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

प्रतिक्रिया समस्याएँ

• कोई प्रतिक्रिया बॉडी नहीं: यदि आपको 200 OK प्रतिक्रिया मिलती है लेकिन कोई प्रतिक्रिया बॉडी नहीं है, तो सत्यापित करें कि अनुरोध ठीक से स्वरूपित था और डेटा सही ढंग से भेजा गया था।

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

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

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

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

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

क्या मैं पुशवूश को भेजे गए इवेंट्स या टैग्स को अनुकूलित कर सकता हूं?

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

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

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

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

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