प्रोडक्ट एनालिटिक्स: Mixpanel, Amplitude और Segment

CRM से प्रोडक्ट इवेंट (जैसे "डील जीती गई", "लीड बनाई गई") अपने Mixpanel, Amplitude या Segment को भेजें और कॉन्टैक्ट पर एक्टिविटी के रूप में इवेंट वापस पाएं (BYO मॉडल, यानी अकाउंट आपका अपना है)।

प्रोडक्ट एनालिटिक्स इंटीग्रेशन आपके अपने Mixpanel, Amplitude या Segment अकाउंट का उपयोग करता है (BYO मॉडल: आप अपना अकाउंट खुद लाते हैं)। CRM आपके एनालिटिक्स को प्रोडक्ट इवेंट भेजता है (जैसे जब कोई डील जीती जाती है या लीड बनाई जाती है) और इवेंट वापस भी प्राप्त करता है, जो संबंधित कॉन्टैक्ट पर एक्टिविटी बन जाते हैं। हमारी तरफ से कोई लागत, मार्जिन या मध्यस्थता नहीं है: इवेंट सीधे आपके अकाउंट को जाते हैं और वहीं से वापस आते हैं।

इंटीग्रेशन निष्क्रिय अवस्था में शुरू होता है: जब तक आप क्रेडेंशियल भरकर इसे सक्रिय नहीं करते, तब तक कुछ नहीं होता। सभी सीक्रेट (project token, API key, write key) CRM में एन्क्रिप्टेड रूप में सहेजे जाते हैं और कभी वापस नहीं दिखाए जाते। हर प्लेटफ़ॉर्म का Settings → Integrations में अपना कार्ड है; वेबहुक URL यूनीक होता है (/api/inbound/analytics/…) और CRM URL टोकन से पहचानता है कि यह कौन सा प्लेटफ़ॉर्म है।

पूर्वापेक्षाएँ

• एक Mixpanel, Amplitude या Segment अकाउंट जिसमें इनजेशन क्रेडेंशियल देखने की पहुँच हो।
• Mixpanel: Project Token (Settings → Project Settings)। Amplitude: प्रोजेक्ट API Key (Settings → Projects)। Segment: HTTP API सोर्स का Write Key (Connections → Sources)।
• इवेंट वापस पाने के लिए, किसी प्रोवाइडर एक्सपोर्ट/वेबहुक को किसी URL पर पॉइंट करने की क्षमता।
• Sellio में, क्रेडेंशियल सहेजने और Settings → Integrations में इंटीग्रेशन सक्रिय करने के लिए एडमिनिस्ट्रेटर एक्सेस।

यह कैसे काम करता है

• आउटबाउंड (CRM → प्रोवाइडर): हर इवेंट एक व्यक्ति पहचानकर्ता (distinct id / user id, डिफ़ॉल्ट रूप से रिकॉर्ड का ईमेल) और प्रॉपर्टीज़ के साथ भेजा जाता है। भेजना प्रोवाइडर की dedup key से idempotent होता है: Mixpanel $insert_id उपयोग करता है, Amplitude insert_id और Segment messageId, इसलिए वही इवेंट फिर से भेजने पर डुप्लिकेट नहीं बनता।
• इनबाउंड (प्रोवाइडर → CRM): जब प्रोवाइडर वेबहुक URL पर एक इवेंट POST करता है, तो CRM एक एक्टिविटी लॉग करता है और उसे संबंधित ईमेल वाले कॉन्टैक्ट से लिंक करता है। यदि वह ईमेल CRM में मौजूद नहीं है, तो एक्टिविटी अनलिंक्ड रहती है (कुछ भी खोता नहीं)।
• इवेंट भेजने का अनुशंसित तरीका ऑटोमेशन एक्शन "इवेंट भेजें (analytics)" है (नीचे देखें)। कार्ड पर "टेस्ट इवेंट भेजें" बटन कॉन्फ़िगरेशन को एंड टू एंड वैलिडेट करता है।

"इवेंट भेजें (analytics)" ऑटोमेशन एक्शन

Settings → Automations में, एक नियम बनाएं या संपादित करें और "इवेंट भेजें (analytics)" एक्शन जोड़ें। प्रोवाइडर चुनें (Mixpanel/Amplitude/Segment), इवेंट का नाम (उदाहरण के लिए, "Deal won"; आप रिकॉर्ड डेटा इंटरपोलेट करने के लिए {{field}} का उपयोग कर सकते हैं) और वैकल्पिक रूप से व्यक्ति पहचानकर्ता (distinct id, जो डिफ़ॉल्ट रूप से {{email}} होता है)। जब नियम ट्रिगर होता है, इवेंट पोस्ट-कमिट, best-effort तरीके से भेजा जाता है। यदि इंटीग्रेशन सक्रिय नहीं है, तो एक्शन बस कुछ नहीं करता (gated)।

Mixpanel

1. Settings → Integrations खोलें और "प्रोडक्ट एनालिटिक्स (Mixpanel)" कार्ड खोजें।
2. Project Token पेस्ट करें (Mixpanel → Settings → Project Settings → Project Token) और रीजन चुनें (केवल तभी EU चुनें जब आपका प्रोजेक्ट यूरोपीय डेटा रेजिडेंसी उपयोग करता हो)। "एनालिटिक्स सेव करें" पर क्लिक करें।
3. "Activate" पर क्लिक करें। पुष्टि के लिए किसी भी distinct id के साथ "टेस्ट इवेंट भेजें" का उपयोग करें।
4. इवेंट पाने के लिए, किसी Mixpanel वेबहुक/एक्सपोर्ट को "वेबहुक URL" पर पॉइंट करें। Mixpanel एक्सपोर्ट वेबहुक साइन नहीं करता: सुरक्षा अप्रत्याशित URL टोकन पर निर्भर है, इसलिए इसे सीक्रेट मानें।

Amplitude

1. CRM में, "प्रोडक्ट एनालिटिक्स (Amplitude)" कार्ड खोजें।
2. API Key पेस्ट करें (Amplitude → Settings → Projects → API Key) और रीजन चुनें। "एनालिटिक्स सेव करें" पर क्लिक करें और फिर "Activate" पर।
3. आउटबाउंड इवेंट /2/httpapi को जाते हैं। इवेंट पाने के लिए, किसी Amplitude एक्सपोर्ट/वेबहुक को "वेबहुक URL" पर पॉइंट करें (Amplitude साइन नहीं करता: URL टोकन ही सुरक्षा है)।

Segment

1. CRM में, "प्रोडक्ट एनालिटिक्स (Segment)" कार्ड खोजें।
2. Segment में एक HTTP API सोर्स बनाएं (Connections → Sources) और Write Key पेस्ट करें। वैकल्पिक रूप से, एक वेबहुक सीक्रेट सेट करें (इनबाउंड पर सिग्नेचर अनिवार्य करने के लिए)। "एनालिटिक्स सेव करें" और "Activate" पर क्लिक करें।
3. आउटबाउंड: इवेंट write key के Basic auth से प्रमाणित होकर /v1/track को जाते हैं। इनबाउंड: Segment में एक Webhook Destination (या फ़ंक्शन) बनाएं जो "वेबहुक URL" पर पॉइंट करे। डिफ़ॉल्ट रूप से Segment साइन नहीं करता; यदि आप सीक्रेट सेट करते हैं, तो CRM x-signature हेडर (HMAC-SHA1) सत्यापित करता है; अन्यथा, URL टोकन ही सुरक्षा है।

वेबहुक URL और क्रेडेंशियल को सीक्रेट मानें। यदि आप आवश्यक क्रेडेंशियल के बिना सक्रिय करने की कोशिश करते हैं, तो इंटीग्रेशन निष्क्रिय रहता है, और जब तक सब कुछ सेट नहीं हो जाता तब तक कुछ भी भेजा या प्राप्त नहीं होता।

कैसे टेस्ट करें

1. आउटबाउंड: कार्ड पर किसी भी distinct id के साथ "टेस्ट इवेंट भेजें" पर क्लिक करें और पुष्टि करें कि इवेंट आपके Mixpanel/Amplitude/Segment में आया है (Live View / Debugger)।
2. ऑटोमेशन: "इवेंट भेजें (analytics)" एक्शन के साथ एक नियम बनाएं और उसे ट्रिगर करें; प्रोवाइडर पर इवेंट जांचें।
3. इनबाउंड: प्रोवाइडर से "वेबहुक URL" पर किसी ऐसे ईमेल के लिए इवेंट भेजवाएं जो कॉन्टैक्ट के रूप में मौजूद हो और कॉन्टैक्ट पर एक्टिविटी जांचें।

समस्या-समाधान

• एरर 401/इवेंट दिखाई नहीं देता: गलत क्रेडेंशियल। Mixpanel → Project Token; Amplitude → API Key; Segment → Write Key (Basic auth से प्रमाणित)। सही क्रेडेंशियल फिर से पेस्ट करें।
• गलत रीजन: यदि आपका प्रोजेक्ट EU डेटा रेजिडेंसी उपयोग करता है, तो EU रीजन चुनें। अन्यथा इवेंट गलत एंडपॉइंट पर जाते हैं और दिखाई नहीं देते।
• ऑटोमेशन नहीं भेजता: "इवेंट भेजें (analytics)" एक्शन gated है: यदि इंटीग्रेशन सक्रिय नहीं है, तो यह कुछ नहीं करता। इंटीग्रेशन सक्रिय करें और एक्शन में चुने गए प्रोवाइडर की पुष्टि करें।
• इनबाउंड एक्टिविटी नहीं बनता: यदि इवेंट का ईमेल CRM में मौजूद नहीं है, तो एक्टिविटी अनलिंक्ड रहती है (कुछ भी खोता नहीं)। Segment: यदि आपने सीक्रेट सेट किया है, तो x-signature हेडर (HMAC-SHA1) वैलिडेट करें।
• वेबहुक URL पर 404: इंटीग्रेशन निष्क्रिय है या टोकन बदल गया है। फिर से सक्रिय करें और URL दोबारा कॉपी करें।

Open this article inside the system →