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

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

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

स्रोत: कॉन्फ़िगर किए गए इवेंट ट्रिगर्स के आधार पर Pushwoosh से आपके सिस्टम में HTTP या gRPC के माध्यम से डेटा भेजा जाता है।

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

Pushwoosh संचार इवेंट डेटा (जैसे, पुश/ईमेल गतिविधि) को क्लाइंट-परिभाषित एंडपॉइंट पर भेजता है। डेटा निर्धारित अंतराल पर या न्यूनतम बैच आकार तक पहुंचने पर बैच स्ट्रीम में भेजा जाता है।

डेटा केवल तभी भेजा जाता है जब यह चयनित इवेंट्स, प्लेटफ़ॉर्म और वैकल्पिक फ़िल्टर (अभियान/संदेश कोड, लाइव गतिविधि) से मेल खाता है। क्लाइंट एंडपॉइंट को स्थिति के साथ प्राप्त करने और वैकल्पिक रूप से प्रतिक्रिया देने के लिए तैयार होना चाहिए।

शब्दावली

एंडपॉइंट URL: सर्वर-साइड एंडपॉइंट जो अनुरोध प्राप्त करने की अनुमति देता है। क्लाइंट यदि आवश्यक हो तो एक पोर्ट निर्दिष्ट कर सकता है।

उदाहरण:

https://clientdomainname.com/webhook_endpoint
https://clientdomainname.com:8081/webhook_endpoint

सिंक्रनाइज़ की गई संस्थाओं की सूची

संचार सांख्यिकी इवेंट (जैसे, Push Sent, Email Delivered)

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

वास्तविक समय में जुड़ाव ट्रैकिंग

उपयोगकर्ता की बातचीत जैसे पुश भेजा गया, ईमेल खोला गया, या संदेश डिलीवर हुआ, की निगरानी करें, जिससे अभियान के प्रदर्शन में तत्काल दृश्यता सक्षम हो।

बाहरी एनालिटिक्स इंटीग्रेशन

केंद्रीकृत रिपोर्टिंग और विश्लेषण के लिए तृतीय-पक्ष एनालिटिक्स प्लेटफ़ॉर्म पर इवेंट स्ट्रीम करें।

स्वचालित उपयोगकर्ता वर्कफ़्लो

उपयोगकर्ता के व्यवहार के आधार पर बाहरी सिस्टम (जैसे CRM या मार्केटिंग ऑटोमेशन टूल) में क्रियाएं ट्रिगर करें, जैसे, जब कोई उपयोगकर्ता ईमेल खोलता है तो एक अनुवर्ती संदेश भेजें।

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

इंटीग्रेशन सेट अप करने के लिए:

अपने Pushwoosh खाते में, Settings > 3rd party Integrations पर जाएं, Event streaming integration ढूंढें, और Configure पर क्लिक करें।

Event streaming integration कॉन्फ़िगर करें

खुलने वाली विंडो में, आवश्यक फ़ील्ड भरें।

आवश्यक फ़ील्ड भरें

एंडपॉइंट URL दर्ज करें

Endpoint URL फ़ील्ड में, वह पूरा URL दर्ज करें जहां इवेंट भेजे जाएंगे, जिसमें प्रोटोकॉल और पोर्ट भी शामिल है, यदि लागू हो।

उदाहरण

https://clientdomainname.com/webhook_endpoint
https://clientdomainname.com:8081/webhook\_endpoint

इवेंट चुनें

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

प्राधिकरण क्रेडेंशियल प्रदान करें

यदि आपके सर्वर द्वारा आवश्यक हो, तो Authorization फ़ील्ड में Authorization हेडर के लिए पूरा मान दर्ज करें।

उदाहरण:

Bearer your_token_here
Basic base64encoded_credentials

ट्रांसपोर्ट प्रकार चुनें

Transport type ड्रॉपडाउन से, इवेंट ट्रांसमिशन के लिए डिलीवरी प्रोटोकॉल चुनें: HTTP या gRPC। प्रत्येक का विशिष्ट व्यवहार और कॉन्फ़िगरेशन होता है।

HTTP

HTTP ट्रांसपोर्ट प्रकार के साथ, Pushwoosh निम्नलिखित में से किसी एक शर्त के आधार पर बैच में डेटा भेजता है:

कम से कम 100 इवेंट भेजे जाने के लिए तैयार हैं, या
पिछले ट्रांसमिशन से एक घंटा बीत चुका है।

डेटा भेजने के बाद, एक सफल प्रतिक्रिया प्राप्त होने पर कनेक्शन बंद हो जाता है।

यदि सर्वर 5xx त्रुटि के साथ प्रतिक्रिया देता है, तो Pushwoosh परिभाषित पुनः प्रयास नीति के अनुसार अनुरोध को फिर से प्रयास करेगा।

पुनः प्रयास तंत्र

प्रयास	देरी
पहला	1 सेकंड
दूसरा	पहले प्रयास के 3 सेकंड बाद
तीसरा	दूसरे प्रयास के 8 सेकंड बाद

यदि सभी पुनः प्रयास विफल हो जाते हैं, तो अनुरोध को छोड़ दिया जाता है।

टाइमआउट

एक अनुरोध के लिए डिफ़ॉल्ट टाइमआउट 30 सेकंड है। इसे समर्थन के माध्यम से अनुरोध पर अनुकूलित किया जा सकता है।

उदाहरण देखें

gRPC

gRPC ट्रांसपोर्ट प्रकार डेटा ट्रांसमिशन के लिए द्विदिश स्ट्रीमिंग का उपयोग करता है। gRPC दस्तावेज़ीकरण में और जानें।

एक स्ट्रीम तब खोली जाती है जब निम्नलिखित में से कोई भी शर्त पूरी होती है:

डिलीवरी के लिए कम से कम 1,000 इवेंट तैयार हैं
पिछली स्ट्रीम खोले हुए एक घंटा बीत चुका है

इवेंट भेजे जाने के बाद स्ट्रीम बंद हो जाती है। यह सुनिश्चित करता है कि कम समय में प्रत्येक व्यक्तिगत इवेंट के लिए एक नई स्ट्रीम नहीं खोली जाती है।

प्रोटोबफ़ विनिर्देश देखें

पुनः प्रयास तंत्र
प्रत्येक इवेंट में एक अद्वितीय uuid शामिल होता है। यदि कोई इवेंट विफल होता है:

प्रतिक्रिया में एक status शामिल होना चाहिए जो "Success" के बराबर नहीं हो
अनुरोध से मूल uuid शामिल होना चाहिए

Pushwoosh इस प्रतिक्रिया के आधार पर डिलीवरी का पुनः प्रयास करेगा।

कनेक्शन सेटिंग्स

TLS, keep-alive, या retry policies जैसे उन्नत विकल्प समर्थन के माध्यम से मैन्युअल रूप से कॉन्फ़िगर किए जाते हैं और इसके लिए विकास भागीदारी की आवश्यकता हो सकती है।

प्लेटफ़ॉर्म चुनें

Platforms section में, इवेंट स्ट्रीमिंग को सक्रिय करने के लिए कम से कम एक प्लेटफ़ॉर्म चुनें।

कम से कम एक प्लेटफ़ॉर्म चुनें

समर्थित प्लेटफ़ॉर्म में शामिल हैं:

iOS, Android, macOS, Windows, Amazon, Safari
Chrome, Firefox, Internet Explorer, Baidu, Huawei
Email, SMS, Line, Xiaomi, WhatsApp

उन्नत फ़िल्टर कॉन्फ़िगर करें

Advanced filters अनुभाग में, फ़िल्टर का उपयोग करके इवेंट डिलीवरी मानदंडों को परिष्कृत करें:

Live activity events: लाइव गतिविधि इवेंट प्राप्त करने के लिए सक्षम करें। इन इवेंट में केवल मेटाडेटा होता है जिसमें live_activity_id शामिल है।
Campaign filters: अभियान कोड द्वारा फ़िल्टर करें। केवल इन अभियानों से जुड़े इवेंट ही डिलीवर किए जाएंगे।
Message filters: संदेश कोड द्वारा फ़िल्टर करें। केवल इन संदेशों से जुड़े इवेंट ही डिलीवर किए जाएंगे।

उन्नत फ़िल्टर सेट करें

सभी आवश्यक फ़ील्ड भरने के बाद, अपने इंटीग्रेशन को सहेजने और सक्रिय करने के लिए Apply बटन पर क्लिक करें।

अनुरोध विवरण और उदाहरण


एंडपॉइंट	`https://exampleclientendpoint.com/webhook_endpoint`
HTTP अनुरोध	`POST`
प्रमाणीकरण	नहीं
अनुरोध का प्रकार	स्रोत
अनुरोध का अर्थ	वेबहुक एंडपॉइंट पर अनुरोध भेजें
हेडर्स	`Content-Type: application/json`

अनुरोध बॉडी का उदाहरण

{
  "event_name": "Email Opened",
  "message_code": "E682-E6D92B9A-53E24868",
  "campaign_id": 961048,
  "platform": "Email",
  "payload": "Welcome to Headway! 👋",
  "application_code": "32E5A-9B411",
  "hwid": "irun4716@gmail.com",
  "user_id": "1894410",
  "timestamp": 1723799271,
  "journey_title": "",
  "journey_point_title": "5_Welcome_ID_new"
}

प्रतिक्रिया
फिलहाल, प्रतिक्रिया कोड और बॉडी को अनदेखा कर दिया जाता है।

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

आपको अपने कॉन्फ़िगर किए गए एंडपॉइंट पर Pushwoosh से अनुरोध प्राप्त होने लगेंगे।