Clickstream Publisher आपको अपनी वेबसाइट या मोबाइल ऐप से रीयल-टाइम व्यवहारिक इवेंट्स — पेज व्यू, बटन टैप, स्क्रीन ट्रांज़िशन, और कस्टम इवेंट्स — कैप्चर करने और उन्हें सीधे किसी SurveyAnalytica वर्कफ़्लो में भेजने की सुविधा देता है। प्रत्येक इवेंट स्ट्रक्चर्ड डेटा के रूप में आता है जिस पर वर्कफ़्लो कंडीशन और एक्शन तुरंत कार्रवाई कर सकते हैं।

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

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

प्रत्येक सोर्स (वेबसाइट, iOS ऐप, Android ऐप) को अपना खुद का वर्कफ़्लो, अपनी API कुंजी और एंडपॉइंट URL मिलता है, ताकि आप डेटा रूटिंग और एक्सेस को स्वतंत्र रूप से नियंत्रित कर सकें।

चरण 1 — एक Clickstream वर्कफ़्लो बनाएं

1. Flows पर जाएं और Create workflow पर क्लिक करें।
2. वर्कफ़्लो को नाम दें (उदाहरण के लिए, Website Clickstream या iOS App Events)।
3. Trigger चरण पर क्लिक करें और ट्रिगर प्रकार सूची से Clickstream चुनें।

चरण 2 — अपनी API Key और Endpoint URL कॉपी करें

Clickstream ट्रिगर चुनने के बाद, ट्रिगर ड्रॉअर में यह दिखाई देता है:

• KEY — आपकी API कुंजी। प्रमाणीकरण के लिए SDK इसे हर रिक्वेस्ट के साथ भेजता है।
• URL — वह एंडपॉइंट जिस पर आपका SDK इवेंट्स पोस्ट करता है। यह इस तरह दिखता है https://<your-domain>/api/v1/clickstream/<workflow-id>।

प्रत्येक वैल्यू के बगल में दिए गए कॉपी आइकन का उपयोग करें। SDK को इनिशियलाइज़ करते समय आपको दोनों की आवश्यकता होगी।

API कुंजी को कभी भी रोटेट करने के लिए KEY के नीचे Generate New पर क्लिक करें। रोटेट करने के बाद, अपने SDK कॉन्फ़िगरेशन में कुंजी अपडेट करें — पुरानी कुंजी तुरंत काम करना बंद कर देती है।

चरण 3 — SDK इंस्टॉल करें

अपने प्लेटफ़ॉर्म के लिए गाइड चुनें:

• Web SDK — Vanilla JS, Next.js, या React से बनी वेबसाइटों के लिए।
• Mobile SDKs — React Native, Flutter, iOS (Swift), और Android (Kotlin) के लिए।

चरण 4 — वर्कफ़्लो एक्शन कॉन्फ़िगर करें

ट्रिगर सक्रिय होने पर, आने वाले इवेंट्स को हैंडल करने के लिए एक्शन जोड़ें। एक सामान्य Clickstream वर्कफ़्लो में शामिल होता है:

• एक Condition ब्लॉक जो इवेंट प्रकार की जांच करता है (उदाहरण के लिए, eventType equals uid_transition) ताकि पहचान-समाधान (identity-resolution) इवेंट्स को नियमित इवेंट्स से अलग किया जा सके।
• एक Data एक्शन जो प्रत्येक इवेंट को किसी डेटा टेबल में नई पंक्ति के रूप में लिखता है — Clickstream वर्कफ़्लो के अंदर नई टेबल बनाते समय अपने आप दिखाई देने वाले क्लिकस्ट्रीम फ़ील्ड मैपिंग टेम्पलेट का उपयोग करें।
• uid_transition ब्रांच पर एक Contact एक्शन जो कॉन्टैक्ट की एनोनिमस ID सूची को अपडेट करता है, जिससे लॉगिन-पूर्व इवेंट्स को ज्ञात कॉन्टैक्ट से लिंक किया जा सके।

इवेंट प्रकार

इवेंट प्रकार	यह कब फ़ायर होता है
event	कोई भी नामित इवेंट जिसे आप मैन्युअल रूप से ट्रैक करते हैं, जिसमें स्वचालित पेज व्यू (eventName: page_view) भी शामिल हैं।
uid_transition	जब कोई उपयोगकर्ता लॉगिन करता है और SDK उनके एनोनिमस सेशन को उनके ज्ञात कॉन्टैक्ट ID से लिंक करता है।
consent_rejected	जब आपका ऐप setConsent(false) कॉल करता है। ट्रैकिंग बंद हो जाती है और पूर्व एनोनिमस IDs साफ़ कर दी जाती हैं।

वर्कफ़्लो को सक्रिय करना

वर्कफ़्लो बिल्डर में Activate पर क्लिक करें। एंडपॉइंट तुरंत लाइव हो जाता है। वर्कफ़्लो सक्रिय होने से पहले SDK द्वारा भेजे गए इवेंट्स प्राप्त नहीं होते — अपने उपयोगकर्ताओं के लिए SDK डिप्लॉय करने से पहले सक्रिय करें।