सर्वर CAPI & इवेंट ट्रैकिंग

अपने फ़र्स्ट-पार्टी सर्वर GTM कंटेनर से ट्रैफ़िक भेजकर विज्ञापन अवरोधक और ITP पाबंदी पार करें तथा गहरा ई-कॉमर्स विश्लेषण करें।

1. ट्रैकिंग मोड अवलोकन

MousePlayer V2 में शक्तिशाली Event Router है, जो उपयोगकर्ता ब्राउज़र से सर्वर तक डेटा प्रवाह नियंत्रित करता है। तीन मोड:

  • केवल वेब (डिफ़ॉल्ट): WebSockets से सारा डेटा सीधे MousePlayer। रीयल-टाइम लाइव दृश्य के लिए श्रेष्ठ, लेकिन कड़े विज्ञापन अवरोधक रोक सकते हैं।
  • हाइब्रिड मोड: दोनों के लाभ। हल्के माउस/स्क्रॉल निर्देशांक WebSockets से सहज लाइव दृश्य के लिए, भारी DOM बदलाव और कस्टम इवेंट बैच बनाकर सर्वर GTM से सुरक्षित HTTP POST में।
  • केवल CAPI: 100% HTTP POST बैचिंग। अधिकतम गोपनीयता, WebSockets शून्य, पूरा फ़र्स्ट-पार्टी। नोट: इस मोड में लाइव दृश्य बंद।

2. Google Tag Manager सेटअप (सुझाया गया)

हाइब्रिड या केवल CAPI का आसान रास्ता आधिकारिक GTM कम्युनिटी टेम्पलेट हैं। नीचे की फ़ाइलें डाउनलोड करें: .tpl और GTM वर्कस्पेस में इम्पोर्ट करें।

टेम्पलेट डाउनलोड:

↓ Web GTM: MousePlayer SDK टैग

↓ Server GTM: MousePlayer Ingest क्लाइंट

↓ Server GTM: MousePlayer Connector टैग

चरण 1: सर्वर क्लाइंट & टैग सेट करें

सर्वर GTM कंटेनर में यह टेम्पलेट इम्पोर्ट करें: Ingest Client । कस्टम पथ सुनना सेट करें (जैसे /mp_capi)। फिर इम्पोर्ट करें: Connector Tag, इसे इस इवेंट पर चलाएँ: mouseplayer_batch और कंटेनर डिप्लॉय करें।

चरण 2: Web GTM टैग सेट करें

Web GTM कंटेनर में इम्पोर्ट करें: SDK Tag। टैग प्रकार "कॉन्फ़िगरेशन & शुरुआत" चुनें, अपना मान दें: Channel ID, चुनें हाइब्रिड मोड और ssGTM एंडपॉइंट URL चिपकाएँ (जैसे https://metrics.yourdomain.com/mp_capi)।

3. मैनुअल इंस्टॉलेशन (GTM बिना)

स्क्रिप्ट कोड में सेट करें तो ट्रैकिंग स्निपेट से पहले यह ऑब्जेक्ट दें: window.mp_config ।

<!-- MousePlayer Config & SDK --> <script> window.mp_config = { channel: 'YOUR_UNIQUE_ID_HERE', mode: 'hybrid', // 'web_only', 'hybrid', or 'pure_capi' capi_endpoint: 'https://metrics.yourdomain.com/mp_capi' }; window.mp = window.mp || function() { (window.mp.q = window.mp.q || []).push(arguments); }; (function(w, d, s) { var f = d.getElementsByTagName(s)[0], j = d.createElement(s); j.async = true; j.src = 'https://www.mouseplayer.com/mp.js'; f.parentNode.insertBefore(j, f); })(window, document, 'script'); </script>

4. ई-कॉमर्स फ़नल ट्रैकिंग

पूरी ग्राहक यात्रा ट्रैक करें। मानक नामों से MousePlayer वर्कस्पेस में अपने आप उपयोगी फ़नल रिपोर्ट बनाता है। सभी इवेंट CAPI और केवल वेब से पूरी संगत।

1. view_item

उपयोगकर्ता खास उत्पाद पृष्ठ देखे तो चलाएँ।

mp('event', 'view_item', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', item_category: 'Electronics', price: 299.99 });

2. add_to_cart

उपयोगकर्ता कार्ट में वस्तु जोड़े तो चलाएँ।

mp('event', 'add_to_cart', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', price: 299.99, quantity: 1 });

3. begin_checkout

चेकआउट स्क्रीन पर जाए तो चलाएँ।

mp('event', 'begin_checkout', { cart_value: 299.99, currency: 'USD', total_items: 1 });

4. purchase

सफल भुगतान या ऑर्डर पुष्टि पर चलाएँ।

mp('event', 'purchase', { transaction_id: 'T_1002938', value: 299.99, tax: 24.00, shipping: 0.00, currency: 'USD', coupon_used: 'FREESHIP' });

5. कस्टम इवेंट & लीड बनाना

केवल ई-कॉमर्स नहीं। फ़ॉर्म सबमिट, न्यूज़लेटर पंजीकरण या ऐप के खास इंटरैक्शन ट्रैक करें।

लीड बनाना (फ़ॉर्म सबमिट)

संपर्क फ़ॉर्म सफल भेजने या मूल्य प्रस्ताव माँगने पर चलाएँ।

mp('event', 'generate_lead', { form_name: 'B2B Contact Form', industry: 'Software Development', company_size: '50-200' });

कस्टम UI इंटरैक्शन

कैलकुलेटर, संवाद या टैब बदलने जैसे जटिल एलिमेंट का उपयोग समझें।

mp('event', 'calculator_used', { loan_amount: 50000, duration_months: 48, interest_rate: 7.5 });

6. पैरामीटर सीमाएँ & निर्देश

डेटा प्रकार: MousePlayer प्रकार खुद पहचानता है। संख्या पूर्णांक या दशमलव में भेजें (जैसे 150.00, यह नहीं: "150.00"), ताकि डैशबोर्ड में संख्यात्मक फ़िल्टर (जैसे "मूल्य > 100") चलें।

नियम विवरण
इवेंट नाम लंबाई अधिकतम 128 अक्षर। पढ़ने में आसान snake_case लें (जैसे user_signup)।
पैरामीटर कुंजी लंबाई प्रति कुंजी अधिकतम 64 अक्षर (जैसे transaction_id)।
स्ट्रिंग मान बेहतर डेटाबेस प्रदर्शन के लिए पाठ पैरामीटर 255 अक्षर तक काटते हैं।
डेटा गोपनीयता ऐसा न करें: मूल ईमेल, वास्तविक नाम या पासवर्ड जैसे व्यक्तिगत पहचान डेटा (PII) इवेंट पैरामीटर में न भेजें।