PostHog, Mixpanel & Amplitude ब्रिज

आपका उत्पाद विश्लेषण टूल बताता है क्या हुआ। MousePlayer दिखाता है क्यों। यह ब्रिज दोनों दिशाओं में जोड़ता है, ताकि फ़नल छोड़ने के कारण की रिकॉर्डिंग एक क्लिक दूर हो।

1. समस्या: चेहरों के बिना आँकड़े

उत्पाद विश्लेषण फ़नल देता है: 1,000 उपयोगकर्ता चेकआउट पहुँचे, 620 ने छोड़ा। समस्या का सटीक मापन, पर अभी दिखती नहीं। उन 620 रिकॉर्डिंग में कुछ देखने से अक्सर मिनटों में जवाब मिलता है — लेकिन तभी जब चार्ट से सही सत्र पर ID एक्सपोर्ट और हाथ से खोजे बिना जा सकें।

यह उत्पाद विश्लेषण ब्रिज कमी दूर करता है। यह इसके भीतर चलता है: mp.js और दोनों सिस्टम अपने आप जोड़ता है:

  • बाहर भेजना: विश्लेषण टूल के हर रिकॉर्ड इवेंट में यह प्रॉपर्टी आती है: mouseplayer_session_url । कोई इवेंट खोलें, लिंक क्लिक करें, सत्र देखें।
  • अंदर पढ़ना: आगंतुक का distinct_id वापस पढ़कर MousePlayer सत्र में सहेजता है, ताकि PostHog, Mixpanel या Amplitude की उसी पहचान से रिकॉर्डिंग खोज सकें।

कोड की ज़रूरत नहीं। ब्रिज विश्लेषण SDK खुद पहचानता है। MousePlayer फ़ंक्शन कॉल या इवेंट ट्रैकिंग बदलने की ज़रूरत नहीं।

2. सक्रिय करना

तरीका A: डैशबोर्ड (बिना कोड)

  1. प्रोजेक्ट खोलकर इंटीग्रेशन टैब पर जाएँ।
  2. यह स्विच बदलें: PostHog, Mixpanel & Amplitude ब्रिज इस स्थिति में: ON।
  3. उपयोग वाला प्लेटफ़ॉर्म चुनें। बदलाव अपने आप सहेजते हैं।

वेबसाइट के अगले पृष्ठ लोड पर सेटिंग लागू है। मौजूदा सत्रों पर पीछे से असर नहीं होता।

तरीका B: मैनुअल स्क्रिप्ट कॉन्फ़िगरेशन

कोड में तय करना चाहें तो इसके भीतर दो मान सेट करें: window.mp_config:

<!-- MousePlayer SDK with the Product Analytics Bridge enabled --> <script> window.mp_config = { channel: 'YOUR_CHANNEL_ID', analytics_bridge_active: true, analytics_provider: 'posthog' // 'posthog', 'mixpanel' or 'amplitude' }; </script>

3. हर प्लेटफ़ॉर्म पर क्या होता है

हर प्लेटफ़ॉर्म की API अलग है, इसलिए ब्रिज उसके सामान्य कॉल से मैप करता है। आपको कॉन्फ़िगर नहीं करना — प्रदाता चयन के अनुसार चलता है।

प्लेटफ़ॉर्मबाहर भेजना (रिकॉर्डिंग URL)अंदर पढ़ना (पहचान)
PostHog posthog.register() — सुपर प्रॉपर्टी के रूप में पंजीकृत, इसलिए हर बाद के इवेंट में जुड़ती है posthog.get_distinct_id()
Mixpanel mixpanel.register() — वही सुपर प्रॉपर्टी व्यवहार mixpanel.get_distinct_id()
Amplitude setUserProperties() — उपयोगकर्ता प्रॉपर्टी के रूप में सेट getDeviceId(), विकल्प के रूप में getInstance().options.deviceId पुराने SDK पर

सुपर प्रॉपर्टी बनाम उपयोगकर्ता प्रॉपर्टी: PostHog और Mixpanel में रिकॉर्डिंग URL आगे के इवेंट में जुड़ता है, इसलिए ब्रिज शुरू होने के बाद हर इवेंट में मिलेगा — पृष्ठ लोड में पहले भेजे इवेंट में नहीं।

4. पहचान: distinct_id से नाम वाले सत्र तक

अंदर पढ़ना वह हिस्सा है जिसे अधिकांश टीम कम आँकती हैं। इसके बिना MousePlayer सत्र गुमनाम हैं: देख सकते हैं, लेकिन यह सवाल नहीं हल कर सकते: "पिछले सप्ताह छोड़ने वाले खाते की रिकॉर्डिंग दिखाएँ।"

ब्रिज सक्रिय होते ही विश्लेषण टूल का distinct_id सत्र की इस फ़ील्ड में लिखा जाता है: custom_user_id — वही फ़ील्ड जहाँ मैनुअल SDK कॉल लिखता है:

// The manual equivalent - you do NOT need this when the bridge is active mp('set', { user_id: 'your-internal-id' });

यदि पहले से खुद कॉल करते हैं: mp('set') , जारी रखें। आपकी स्पष्ट दी पहचान अधिक विश्वसनीय है, क्योंकि वह प्रति ब्राउज़र विश्लेषण पहचानकर्ता के बजाय आपकी अपनी प्राथमिक कुंजी है।

गोपनीयता नोट: केवल विश्लेषण टूल का पहले से दिया पहचानकर्ता जाता है। SDK से ईमेल, नाम या अन्य निजी फ़ील्ड नहीं पढ़ते। अपनी गोपनीयता नीति में इस प्रोसेसिंग को शामिल करें और सहमति क़ानूनी आधार हो तो ट्रैकिंग स्क्रिप्ट सहमति टूल के पीछे रखें।

5. तकनीकी व्यवहार

विश्लेषण SDK आम तौर पर एसिंक्रोनस लोड होते हैं, अक्सर इसके चलने के बाद: mp.js । इसलिए केवल शुरुआत का एक प्रयास अधिकांश वास्तविक वेबसाइट पर विफल होगा।

  • ब्रिज हर 1.5 सेकंड पर, अधिकतम दस बार कोशिश करता है और दोनों दिशाएँ पूरी होते ही रुकता है।
  • हर दिशा अलग पूरी होती है, इसलिए पहचान आने की प्रतीक्षा में रिकॉर्डिंग URL दोबारा नहीं भेजा जाता।
  • SDK कभी न आए तो ब्रिज लगभग 15 सेकंड में चुपचाप रुक जाता है। कंसोल में कुछ नहीं लिखता और सत्र रिकॉर्डिंग अप्रभावित चलती है।
  • 128 अक्षर से लंबे पहचानकर्ता काटने के बजाय अनदेखे हैं, ताकि आधा पहचानकर्ता न सहेजें जो कभी मेल न खाए।

6. काम करना सत्यापित करें

  1. वेबसाइट सामान्य ब्राउज़र टैब में खोलकर थोड़ी गतिविधि करें।
  2. विश्लेषण टूल में नया इवेंट खोलकर यह प्रॉपर्टी देखें: mouseplayer_session_url । खोलने पर सीधे रिकॉर्डिंग मिलनी चाहिए।
  3. MousePlayer में खोलें: User Explorer। पहचान वाले सत्र बनाए आगंतुक उपनाम के बजाय उसे दिखाते हैं।

कुछ न दिखे तो

  • सभी इवेंट में प्रॉपर्टी नहीं: पृष्ठ पर SDK वास्तव में लोड होना और सही प्लेटफ़ॉर्म चुना होना जाँचें। PostHog चयन Mixpanel नहीं पढ़ेगा।
  • प्रॉपर्टी केवल बाद के इवेंट में है: अपेक्षित है, भाग 3 का नोट देखें।
  • URL है, पहचान नहीं: SDK ने अभी यह नहीं दिया: distinct_id , जो उपयोगकर्ता की पहचान होने से पहले सामान्य है। अगले पृष्ठ लोड पर लिया जाएगा।
  • लॉग इन व्यवस्थापक के रूप में परीक्षण: कुछ सेटअप आंतरिक ट्रैफ़िक बाहर रखते हैं। निजी विंडो आज़माएँ।

यहाँ बताए ट्रेडमार्क उनके संबंधित स्वामियों के हैं। MousePlayer का इन प्रदाताओं से व्यावसायिक संबंध नहीं है।