সার্ভারভিত্তিক CAPI ও ইভেন্ট ট্র্যাকিং

নিজের ফার্স্ট-পার্টি সার্ভারভিত্তিক GTM কনটেইনার দিয়ে MousePlayer ট্রাফিক পাঠিয়ে অ্যাডব্লকার ও ITP-এর সীমা এড়ান এবং গভীর ই-কমার্স বিশ্লেষণ ট্র্যাক করুন।

1. ট্র্যাকিং মোডের সারসংক্ষেপ

MousePlayer V2-তে আছে শক্তিশালী Event Router , যা ব্যবহারকারীর ব্রাউজার থেকে সার্ভারে ডেটা প্রবাহ নিয়ন্ত্রণ করতে দেয়। তিনটি আলাদা মোড বেছে নিতে পারেন:

  • শুধু ওয়েব (ডিফল্ট): WebSockets দিয়ে সব ডেটা সরাসরি MousePlayer-এ পাঠায়। রিয়েল-টাইম লাইভ ভিউর জন্য সেরা, তবে কঠোর অ্যাডব্লকারে বাধা পেতে পারে।
  • Hybrid মোড: দুদিকের সেরা সুবিধা। মসৃণ লাইভ ভিউর জন্য WebSockets দিয়ে হালকা মাউস/স্ক্রলের স্থানাঙ্ক পাঠায়; ভারী DOM পরিবর্তন ও কাস্টম ইভেন্ট ব্যাচ করে HTTP POST-এ নিজের সার্ভারভিত্তিক GTM দিয়ে নিরাপদে পাঠায়।
  • Pure CAPI: 100% HTTP POST ব্যাচ। সর্বোচ্চ গোপনীয়তা, WebSockets নেই, পুরোপুরি ফার্স্ট-পার্টি। নোট: এই মোডে লাইভ ভিউ বন্ধ।

2. Google Tag Manager সেটআপ (প্রস্তাবিত)

Hybrid বা Pure CAPI চালুর সহজতম উপায় আমাদের অফিসিয়াল GTM কমিউনিটি টেমপ্লেট ব্যবহার করা। নিচের .tpl ফাইল ডাউনলোড করে GTM ওয়ার্কস্পেসে ইমপোর্ট করুন।

টেমপ্লেট ডাউনলোড করুন:

↓ Web GTM: MousePlayer SDK ট্যাগ

↓ Server GTM: MousePlayer Ingest ক্লায়েন্ট

↓ Server GTM: MousePlayer সংযোগ ট্যাগ

ধাপ 1: সার্ভারভিত্তিক ক্লায়েন্ট ও ট্যাগ কনফিগার করুন

সার্ভারভিত্তিক GTM কনটেইনারে ইমপোর্ট করুন Ingest Client টেমপ্লেট। কাস্টম পথে শোনার জন্য সেট করুন (যেমন, /mp_capi)। তারপর ইমপোর্ট করুন Connector Tag, এই ইভেন্টে চালানোর জন্য কনফিগার করুন: mouseplayer_batch , এবং কনটেইনার চালু করুন।

ধাপ 2: Web GTM ট্যাগ কনফিগার করুন

Web GTM কনটেইনারে ইমপোর্ট করুন SDK Tag। Tag Type হিসেবে “Configuration & Initialization” বেছে নিয়ে দিন আপনার Channel ID, বেছে নিন Hybrid মোডএবং 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), যেমন সরাসরি ইমেইল ঠিকানা, প্রকৃত নাম বা পাসওয়ার্ড, ইভেন্ট প্যারামিটার হিসেবে।