सर्भरतर्फको CAPI र घटना ट्र्याकिङ

आफ्नै प्रथम-पक्षीय सर्भरतर्फको GTM कन्टेनरबाट MousePlayer ट्राफिक पठाएर विज्ञापन रोकावट र ITP सीमा पार गर्नुहोस् तथा विस्तृत ई-कमर्स विश्लेषण लिनुहोस्।

1. ट्र्याकिङ मोडको सारांश

MousePlayer V2 ले शक्तिशाली Event Router दिन्छ, जसले ब्राउजरबाट सर्भरसम्मको डेटा मार्ग नियन्त्रण गर्न दिन्छ। तीन मोड छन्:

  • वेब मात्र (पूर्वनिर्धारित): सबै डेटा WebSocket बाट सीधै MousePlayer मा पठाउँछ। प्रत्यक्ष दृश्यका लागि उत्कृष्ट, तर कडा विज्ञापन रोकावटबाट प्रभावित हुन सक्छ।
  • हाइब्रिड मोड: दुवैको फाइदा। सहज प्रत्यक्ष दृश्यका लागि हल्का माउस/स्क्रोल निर्देशाङ्क WebSocket बाट र ठूला DOM परिवर्तन तथा अनुकूलित घटना HTTP POST ब्याचमा आफ्नै सर्भर GTM बाट पठाउँछ।
  • शुद्ध CAPI: 100% HTTP POST ब्याचिङ। अधिकतम गोपनीयता, WebSocket छैन, पूर्ण प्रथम-पक्षीय। नोट: यो मोडमा प्रत्यक्ष दृश्य बन्द हुन्छ।

2. Google Tag Manager सेटअप (सिफारिस गरिएको)

हाइब्रिड वा शुद्ध CAPI लागू गर्ने सजिलो उपाय आधिकारिक GTM सामुदायिक टेम्प्लेट हुन्। तलका यी .tpl फाइल डाउनलोड गरेर GTM कार्यस्थानमा आयात गर्नुहोस्।

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

↓ वेब GTM: MousePlayer SDK ट्याग

↓ सर्भर GTM: MousePlayer Ingest Client

↓ सर्भर GTM: MousePlayer Connector ट्याग

चरण 1: सर्भरतर्फको क्लाइन्ट र ट्याग

सर्भरतर्फको GTM कन्टेनरमा यो Ingest Client टेम्प्लेट आयात गरी अनुकूलित मार्ग सुन्ने बनाउनुहोस् (जस्तै /mp_capi)। त्यसपछि यो Connector ट्याग आयात गरी यो घटनामा चल्ने राख्नुहोस्: mouseplayer_batch र कन्टेनर प्रकाशित गर्नुहोस्।

चरण 2: वेब GTM ट्याग

वेब GTM कन्टेनरमा यो SDK ट्याग आयात गर्नुहोस्। ट्याग प्रकारमा “कन्फिगरेसन र सुरुआत” छानेर आफ्नो यो मान दिनुहोस्: 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. ई-कमर्स फनेल ट्र्याकिङ

ग्राहकको पूरा भ्रमण मार्ग ट्र्याक गर्नुहोस्। मानक घटना नामले कार्यस्थानमा ई-कमर्स फनेल प्रतिवेदन स्वतः बनाउँछन्। सबै घटना 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 ले प्रकार स्वतः चिन्छ। सङ्ख्या integer वा float मा पठाउनुहोस् (जस्तै 150.00, यो होइन: "150.00") ताकि ड्यासबोर्डमा उन्नत सङ्ख्यात्मक फिल्टरिङ चलोस् (जस्तै “मूल्य > 100”)।

नियम विवरण
घटना नामको लम्बाइ बढीमा 128 अक्षर। पढ्न सहज snake_case प्रयोग गर्नुहोस् (जस्तै user_signup)।
प्यारामिटर कुञ्जीको लम्बाइ प्रति नाम बढीमा 64 अक्षर (जस्तै transaction_id)।
स्ट्रिङ मान डेटाबेस छरितो राख्न पाठ प्यारामिटर 255 अक्षरमा काटिन्छन्।
डेटा गोपनीयता व्यक्तिगत पहिचानयोग्य जानकारी (PII) घटना प्यारामिटरमा नपठाउनुहोस् , जस्तै कच्चा इमेल, वास्तविक नाम वा पासवर्ड।