RudderStack इंटीग्रेशन
RudderStack एक कस्टमर डेटा प्लेटफ़ॉर्म है जो आपके ऐप्स, वेबसाइटों, सर्वरों और डेटा वेयरहाउस से इवेंट एकत्र करता है और उन्हें दूसरे टूल्स तक भेजता है। RudderStack में Pushwoosh destination के साथ, जो डेटा आप वहाँ पहले से एकत्र करते हैं, वह आपके ऐप में अतिरिक्त कोड के बिना Pushwoosh तक पहुँचता है:
- Track इवेंट Pushwoosh इवेंट बन जाते हैं। इनका उपयोग सेगमेंट बनाने और Customer Journey शुरू करने या उनमें ब्रांच बनाने के लिए करें।
- Identify ट्रेट्स यूज़र-स्पेसिफिक टैग बन जाते हैं। इनका उपयोग पुश नोटिफिकेशन, इन-ऐप संदेशों और ईमेल को टारगेट और पर्सनलाइज़ करने के लिए करें।
शुरू करने से पहले
Anchor link todestination सभी डेटा का मिलान User ID से करता है, इसलिए पहले इन पूर्वापेक्षाओं की जाँच करें:
- आपके ऐप में Pushwoosh SDK इंटीग्रेट है।
- आपका ऐप
setUserIdको उसी मान के साथ कॉल करता है जिसे RudderStackuserIdके रूप में भेजता है। Pushwoosh इसी मान से आने वाले इवेंट और ट्रेट्स को उपयोगकर्ताओं से जोड़ता है। - RudderStack द्वारा किसी उपयोगकर्ता के लिए
identifyकॉल भेजने से पहले, उस उपयोगकर्ता का डिवाइस इस User ID के साथ रजिस्टर्ड है। जिस User ID को Pushwoosh अभी नहीं जानता, उसके ट्रेट्स हटा दिए जाते हैं। - API टोकन बनाने के लिए आपके पास Pushwoosh में Settings → API Access का एक्सेस है।
- आपके पास कम से कम एक ऐसे सोर्स वाला RudderStack workspace है जो
trackयाidentifyकॉल भेजता है।
RudderStack में Pushwoosh destination सेट अप करें
Anchor link toसेटअप के दो भाग हैं: आप Pushwoosh में दो मान प्राप्त करते हैं, और फिर RudderStack में destination बनाते हैं।
एप्लिकेशन कोड और Device API token प्राप्त करें
Anchor link toआपके एप्लिकेशन को डेटा भेजने के लिए RudderStack को दो मानों की ज़रूरत होती है: उसका एप्लिकेशन कोड और एक Device API token।
- Pushwoosh में, वह एप्लिकेशन खोलें जिसे आप डेटा भेजना चाहते हैं।
- एप्लिकेशन कोड कॉपी करें। यह ऊपरी बाएँ कोने में एप्लिकेशन के नाम के नीचे दिखाई देता है और
XXXXX-XXXXXजैसा दिखता है। - Settings → API Access पर जाएँ और Generate New Token पर क्लिक करें।
- Token type में,
deviceचुनें। - Name में, टोकन के लिए एक नाम दर्ज करें, उदाहरण के लिए
RudderStack। - Generate पर क्लिक करें।
- टोकन सूची में, नए टोकन के बगल में तीन-बिंदु वाले मेनू पर क्लिक करें और Edit token… चुनें।
- Applications में, चरण 1 वाला एप्लिकेशन चुनें और Save पर क्लिक करें।
- टोकन सूची से टोकन का मान कॉपी करें।
destination के लिए Device API token पर्याप्त है। आपको Server API token की ज़रूरत नहीं है।
RudderStack में destination जोड़ें
Anchor link toPushwoosh destination आपके RudderStack सोर्स को आपके Pushwoosh एप्लिकेशन से जोड़ता है।
- RudderStack डैशबोर्ड में, Collect → Destinations पर जाएँ।
- New destination पर क्लिक करें।
- सूची से Pushwoosh चुनें।
- destination के लिए एक नाम दर्ज करें और Continue पर क्लिक करें।
- वे सोर्स चुनें जिन्हें आप Pushwoosh पर भेजना चाहते हैं।
- Application Code में, एप्लिकेशन कोड पेस्ट करें।
- API Token में, Device API token पेस्ट करें।
- destination सहेजने के लिए सेटअप पूरा करें।
RudderStack अपने स्वयं के सर्वरों से Pushwoosh को डेटा भेजता है (cloud mode), हर उस सोर्स प्रकार के लिए जिसे destination सपोर्ट करता है।
सेटअप के RudderStack वाले हिस्से के लिए, RudderStack दस्तावेज़ में Pushwoosh destination गाइड देखें।
RudderStack, Pushwoosh को कौन-सा डेटा भेजता है
Anchor link todestination दो कॉल प्रकारों, track और identify, को सपोर्ट करता है। इस destination के लिए RudderStack किसी भी अन्य कॉल प्रकार, जैसे page, screen, group, या alias, को अस्वीकार कर देता है।
हर कॉल में userId होना चाहिए। RudderStack इसके बिना कॉल नहीं भेजता, क्योंकि Pushwoosh किसी अनाम कॉल को किसी उपयोगकर्ता से नहीं जोड़ सकता।
Track कॉल Pushwoosh इवेंट बन जाते हैं
Anchor link toहर track कॉल RudderStack इवेंट के समान नाम वाला Pushwoosh इवेंट बन जाता है:
| RudderStack फ़ील्ड | Pushwoosh |
|---|---|
event | इवेंट का नाम |
properties | इवेंट एट्रिब्यूट |
userId | User ID |
timestamp (या originalTimestamp) | इवेंट का समय |
context.device.id | Device ID, यदि मौजूद हो |
context.device.type या context.os.name | प्लेटफ़ॉर्म: android; iOS, iPadOS, watchOS और tvOS के लिए ios; किसी अन्य मान या कोई मान न होने पर web |
अगर इवेंट या कोई एट्रिब्यूट एप्लिकेशन में अभी मौजूद नहीं है, तो Pushwoosh उसे अपने आप बना देता है।
इन मामलों में Pushwoosh पूरा इवेंट हटा देता है। यह कोई त्रुटि नहीं लौटाता, इसलिए RudderStack इवेंट को डिलीवर हुआ बताता है:
- कॉल में 100 से अधिक प्रॉपर्टी हैं।
- किसी प्रॉपर्टी का मान 10 KB से लंबा है।
- इवेंट का नाम 255 वर्णों से लंबा है।
- इवेंट नया है, और उसका नाम 128 वर्णों से लंबा है या उसमें कंट्रोल कैरेक्टर हैं।
एक इवेंट अधिकतम 100 एट्रिब्यूट रखता है। जब किसी इवेंट के 100 ज्ञात एट्रिब्यूट हो जाते हैं, तो Pushwoosh नए कॉल रिकॉर्ड करता रहता है, लेकिन नए प्रॉपर्टी नाम एट्रिब्यूट के रूप में नहीं जोड़े जाते।
properties में नेस्टेड ऑब्जेक्ट JSON स्ट्रिंग के रूप में आते हैं, और null मान वाली प्रॉपर्टी हटा दी जाती हैं।
Identify कॉल यूज़र-स्पेसिफिक टैग बन जाते हैं
Anchor link toहर identify कॉल अपने ट्रेट्स को दिए गए userId वाले उपयोगकर्ता पर टैग के रूप में सेट करता है। ट्रेट्स traits से आते हैं, या traits खाली होने पर context.traits से।
- केवल यूज़र-स्पेसिफिक टैग लिखे जाते हैं। अगर आपके खाते के लिए टैग ऑटो-क्रिएशन चालू है, तो नए नाम वाला ट्रेट एक यूज़र-स्पेसिफिक टैग बनाता है। अगर उसी नाम का General टैग पहले से मौजूद है, तो Pushwoosh बिना किसी त्रुटि के उस ट्रेट को छोड़ देता है।
- मान टैग के प्रकार से मेल खाना चाहिए। अगर कोई टैग पहले से मौजूद है और ट्रेट का मान उसके प्रकार में फिट नहीं होता, जैसे Integer टैग के लिए टेक्स्ट, तो Pushwoosh बिना किसी त्रुटि के उस ट्रेट को छोड़ देता है।
- उपयोगकर्ता Pushwoosh में पहले से मौजूद होना चाहिए। टैग तभी लागू होते हैं जब Pushwoosh SDK ने ऐसा डिवाइस रजिस्टर किया हो जिसमें
setUserIdउसीuserIdपर सेट हो। अज्ञात उपयोगकर्ता के ट्रेट्स बिना किसी त्रुटि के हटा दिए जाते हैं। - पहचान और संपर्क ट्रेट्स टैग में कॉपी नहीं किए जाते।
email,phone,firstName,lastName,name,address,id,userId, औरanonymousIdकभी भी टैग के रूप में नहीं भेजे जाते। जिसidentifyकॉल में केवल ये ट्रेट्स हों, वहNo traits left to send as Pushwoosh tagsके साथ विफल हो जाता है। - खाली मान टैग को साफ़ कर देता है। खाली स्ट्रिंग या खाली सूची वाला ट्रेट उस टैग के लिए उपयोगकर्ता का वर्तमान मान हटा देता है।
- नेस्टेड ऑब्जेक्ट JSON स्ट्रिंग के रूप में आते हैं।
nullमान वाले ट्रेट्स हटा दिए जाते हैं।
destination क्या नहीं करता
Anchor link todestination केवल track और identify डेटा भेजता है। ये काम इसके दायरे से बाहर हैं:
- यह डिवाइस या ईमेल पते रजिस्टर नहीं करता। डिवाइस Pushwoosh SDK से आते हैं।
- यह उपयोगकर्ताओं को डिलीट नहीं करता। इस destination के लिए RudderStack के उपयोगकर्ता डिलीट करने के अनुरोध सपोर्टेड नहीं हैं।
जाँचें कि इंटीग्रेशन काम कर रहा है
Anchor link todestination सहेजने के बाद, ऐसे userId वाले सोर्स से एक टेस्ट track और identify कॉल भेजें जिसका Pushwoosh में पहले से डिवाइस है।
- इवेंट: Pushwoosh में, Audience → Events पर जाएँ, इवेंट खोलें, और जाँचें कि वह गिना गया है।
- टैग: Audience → User Explorer पर जाएँ, User ID से उपयोगकर्ता को खोजें, और टैग मान जाँचें।
हर कॉल की डिलीवरी त्रुटियाँ RudderStack में destination के Live Events व्यू में दिखाई जाती हैं।
समस्या निवारण
Anchor link toकारण और समाधान जानने के लिए, Live Events में destination के लिए RudderStack द्वारा दिखाया गया त्रुटि संदेश खोजें।
Track कॉल unauthorized के साथ विफल होते हैं
Anchor link toAPI टोकन एप्लिकेशन कोड से मेल नहीं खाता। जाँचें कि टोकन उसी Pushwoosh खाते का है जिसका एप्लिकेशन है।
identify कॉल टोकन की जाँच नहीं करते, इसलिए वे गलत टोकन के साथ भी सफल होते रहते हैं। टोकन को टेस्ट करने के लिए track कॉल का उपयोग करें।
कॉल application not found या application code is not valid के साथ विफल होते हैं
Anchor link toएप्लिकेशन कोड गलत है, या खाता app.pushwoosh.com पर होस्ट नहीं है। track कॉल application not found के साथ विफल होते हैं, और identify कॉल application code is not valid के साथ। Pushwoosh Control Panel में कोड जाँचें। अगर कोड सही है, तो अपने Customer Success Manager या सपोर्ट से संपर्क करें।
कॉल Missing required value from userId के साथ विफल होते हैं
Anchor link toकॉल में userId नहीं है। अनाम कॉल Pushwoosh को नहीं भेजे जाते। उपयोगकर्ता के साइन इन करने के बाद अपने RudderStack सोर्स में identify कॉल करें, ताकि बाद के कॉल में userId शामिल हो।
कॉल Invalid enum value के साथ विफल होते हैं
Anchor link toकॉल प्रकार track या identify नहीं है। Pushwoosh केवल इन दो प्रकारों को स्वीकार करता है। या तो ऐसे सोर्स कनेक्ट न करें जो केवल page, screen, group, या alias कॉल भेजते हैं, या इन त्रुटियों को अनदेखा करें।
Identify कॉल No traits left to send as Pushwoosh tags के साथ विफल होते हैं
Anchor link toकॉल के सभी ट्रेट्स पहचान या संपर्क ट्रेट्स हैं, जैसे email या phone, जो कभी टैग में कॉपी नहीं किए जाते। कम से कम एक अन्य ट्रेट जोड़ें या कॉल को छोड़ दें।
Identify कॉल सफल होते हैं लेकिन टैग दिखाई नहीं देते
Anchor link toइन्हें क्रम से जाँचें:
- इस User ID वाला डिवाइस Pushwoosh में रजिस्टर्ड है। Audience → User Explorer में उपयोगकर्ता को खोजें।
- ऐप
setUserIdको ठीक उसी मान के साथ कॉल करता है जिसे RudderStackuserIdके रूप में भेजता है। - इस नाम का टैग User-specific है। किसी मौजूदा General टैग के लिए ट्रेट छोड़ दिया जाता है। टैग का स्कोप बदलें या ट्रेट का नाम बदलें।
- ट्रेट का मान मौजूदा टैग के प्रकार से मेल खाता है।
- ट्रेट उन पहचान या संपर्क ट्रेट्स में से नहीं है जो कभी कॉपी नहीं किए जाते, जैसे
emailयाphone।