सामग्री पर जाएं
डेवलपर दस्तावेज़ीकरण कैसे करें गाइड सहायता डेमो अनुरोध करें साइन इन करें
Pushwoosh.com

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

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

Anchor link to

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

Anchor link to

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

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

Anchor link to

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

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

शब्दावली

Anchor link to

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

उदाहरण:

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

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

Anchor link to
  • संचार सांख्यिकी इवेंट (जैसे, Push Sent, Email Delivered)
  • पोस्ट इवेंट्स: वे इवेंट्स जो आपका ऐप postEvent के माध्यम से Pushwoosh को भेजता है, जो संचार सांख्यिकी इवेंट्स से अलग स्ट्रीम किए जाते हैं

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

Anchor link to
  • रीयल-टाइम एंगेजमेंट ट्रैकिंग

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

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

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

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

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

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

Anchor link to

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

  1. अपने Pushwoosh खाते में, सेटिंग्स > तृतीय-पक्ष इंटीग्रेशन पर जाएं, इवेंट स्ट्रीमिंग इंटीग्रेशन ढूंढें, और कॉन्फ़िगर करें पर क्लिक करें।

इवेंट स्ट्रीमिंग इंटीग्रेशन कॉन्फ़िगर करें

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

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

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

Anchor link to

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

उदाहरण

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

इवेंट्स चुनें

Anchor link to

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

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

Anchor link to

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

उदाहरण:

  • Bearer your_token_here

  • Basic base64encoded_credentials

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

Anchor link to

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

HTTP
Anchor link to

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

  • कम से कम 100 इवेंट भेजे जाने के लिए तैयार हैं, या

  • अंतिम प्रसारण के बाद एक घंटा बीत चुका है।

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

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

रिट्राई तंत्र

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

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

टाइमआउट

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

उदाहरण देखें
gRPC
Anchor link to

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

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

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

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

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

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

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

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

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

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

पोस्ट इवेंट्स सक्षम करें

Anchor link to

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

दिखाई देने वाले पोस्ट इवेंट्स फ़ील्ड से, चुनें कि आपके खाते के कौन से इवेंट स्ट्रीम करने हैं। टॉगल चालू होने पर कम से-कम एक इवेंट आवश्यक है। यदि आपके खाते ने अभी तक कोई इवेंट नहीं भेजा है, तो यह सूची तब तक खाली रहती है जब तक आप कम से कम एक बार postEvent को कॉल नहीं करते।

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

Anchor link to

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

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

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

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

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

Anchor link to

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

  • लाइव गतिविधि इवेंट्स: लाइव गतिविधि इवेंट्स प्राप्त करने के लिए सक्षम करें। इन इवेंट्स में केवल live_activity_id सहित मेटाडेटा होता है।

  • अभियान फ़िल्टर: अभियान कोड द्वारा फ़िल्टर करें। केवल इन अभियानों से जुड़े इवेंट ही डिलीवर किए जाएंगे।

  • संदेश फ़िल्टर: संदेश कोड द्वारा फ़िल्टर करें। केवल इन संदेशों से जुड़े इवेंट ही डिलीवर किए जाएंगे।

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

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

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

Anchor link to
एंडपॉइंट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": "XXXXX-XXXXX",
  "hwid": "user@example.com",
  "user_id": "USER_ID",
  "timestamp": 1723799271,
  "journey_title": "",
  "journey_point_title": "5_Welcome_ID_new",
  "attributes": null
}

एट्रिब्यूट्स

Anchor link to

संचार सांख्यिकी इवेंट्स में, attributes केवल पुश इवेंट्स के लिए पॉप्युलेट होता है, जिसमें उस प्लेटफ़ॉर्म के लिए चैनल-विशिष्ट सामग्री (Android, iOS, आदि) होती है जिस पर पुश भेजा गया था। ईमेल और SMS इवेंट्स में केवल शीर्ष-स्तरीय फ़ील्ड (event_name, platform, payload, आदि) होते हैं। उन इवेंट्स के लिए attributes null होता है। एक पॉप्युलेटेड attributes ऑब्जेक्ट के भीतर, इवेंट के अपने प्लेटफ़ॉर्म के बाहर के फ़ील्ड को खाली मान के रूप में भेजने के बजाय छोड़ दिया जाता है। पूरी फ़ील्ड सूची के लिए webhook.proto देखें।

एक पोस्ट इवेंट अपने एट्रिब्यूट कुंजी/मान जोड़े को attributes.event_attributes में ले जाता है। message_code और payload खाली रहते हैं, क्योंकि एक पोस्ट इवेंट किसी संदेश या अभियान से जुड़ा नहीं होता है।

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

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

Anchor link to

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