PostHog, Mixpanel & Amplitude ব্রিজ

আপনার পণ্য বিশ্লেষণের সরঞ্জাম বলে দেয় কী ঘটেছে। MousePlayer দেখায় কেন। এই ব্রিজ দুই দিকেই দুটিকে যুক্ত করে, তাই ফানেলে ঝরে পড়ার ঘটনা থেকে তার কারণ বোঝানো রেকর্ডিং মাত্র এক ক্লিক দূরে।

1. সমস্যা: মানুষের চেহারা ছাড়া সংখ্যা

পণ্য বিশ্লেষণে একটি ফানেল পান: 1,000 জন ব্যবহারকারী চেকআউটে পৌঁছেছেন, 620 জন ছেড়ে গেছেন। এটি এমন সমস্যার নিখুঁত পরিমাপ যা এখনও দেখতে পাচ্ছেন না। ওই 620টি রেকর্ডিংয়ের কয়েকটি দেখলেই সাধারণত কয়েক মিনিটে উত্তর মেলে — তবে চার্ট থেকে ID এক্সপোর্ট ও হাতে না খুঁজে সঠিক সেশনে যেতে পারলেই।

এই পণ্য বিশ্লেষণের ব্রিজ সেই ব্যবধান সরায়। এটি চলে এর মধ্যে: mp.js এবং স্বয়ংক্রিয়ভাবে দুটি সিস্টেম যুক্ত করে:

  • বাইরে পাঠানো: আপনার বিশ্লেষণ সরঞ্জামের রেকর্ড করা প্রতিটি ইভেন্টে থাকে একটি mouseplayer_session_url প্রপার্টি। যেকোনো ইভেন্ট খুলুন, লিংকে ক্লিক করুন, সেশন দেখুন।
  • ভেতরে আনা: দর্শকের distinct_id পড়ে MousePlayer সেশনে রাখা হয়, ফলে PostHog, Mixpanel বা Amplitude-এ ইতিমধ্যেই ব্যবহার করা একই পরিচয় দিয়ে রেকর্ডিং খোঁজা যায়।

কোডের প্রয়োজন নেই। ব্রিজ নিজেই অ্যানালিটিক্স SDK শনাক্ত করে। কোনো MousePlayer ফাংশন কল করতে বা ইভেন্ট ট্র্যাক করার পদ্ধতি বদলাতে হবে না।

2. চালু করা

পদ্ধতি A: ড্যাশবোর্ড (কোড ছাড়া)

  1. আপনার প্রকল্প খুলে যান ইন্টিগ্রেশন ট্যাবে।
  2. এই সুইচটি বদলান: PostHog, Mixpanel & Amplitude ব্রিজ এবং সেট করুন এই মানে: ON।
  3. যে প্ল্যাটফর্ম ব্যবহার করেন বেছে নিন। পরিবর্তন স্বয়ংক্রিয়ভাবে সংরক্ষিত হয়।

আপনার ওয়েবসাইটের পৃষ্ঠা পরের বার লোড হলে সেটিং কার্যকর হয়। আগের সেশনে পরে প্রভাব পড়ে না।

পদ্ধতি B: হাতে স্ক্রিপ্ট কনফিগারেশন

সরাসরি কোডে দিতে চাইলে দুটি মান সেট করুন এর মধ্যে: window.mp_config:

<!-- MousePlayer SDK with the Product Analytics Bridge enabled --> <script> window.mp_config = { channel: 'YOUR_CHANNEL_ID', analytics_bridge_active: true, analytics_provider: 'posthog' // 'posthog', 'mixpanel' or 'amplitude' }; </script>

3. প্রতিটি প্ল্যাটফর্মে কী ঘটে

প্রতিটি প্ল্যাটফর্মের API আলাদা, তাই ব্রিজ প্রতিটির উপযুক্ত কল ব্যবহার করে। এটি কনফিগার করতে হবে না — আপনার সেবাদাতা নির্বাচন অনুযায়ী চলে।

প্ল্যাটফর্মবাইরে পাঠানো (রিপ্লে URL)ভেতরে আনা (পরিচয়)
PostHog posthog.register() — সুপার প্রপার্টি হিসেবে নিবন্ধিত, তাই পরের প্রতিটি ইভেন্টে যুক্ত হয় posthog.get_distinct_id()
Mixpanel mixpanel.register() — একই সুপার প্রপার্টির আচরণ mixpanel.get_distinct_id()
Amplitude setUserProperties() — ব্যবহারকারীর প্রপার্টি হিসেবে সেট হয় getDeviceId(), বিকল্প হিসেবে getInstance().options.deviceId পুরোনো SDK-তে

সুপার প্রপার্টি বনাম ব্যবহারকারীর প্রপার্টি: PostHog ও Mixpanel-এ পরবর্তী ইভেন্টগুলোয় রিপ্লে URL যুক্ত হয়, তাই ব্রিজ শুরু হওয়ার পরে পাঠানো প্রতিটি ইভেন্টে পাবেন — পৃষ্ঠা লোডের শুরুর দিকে আগে পাঠানো ইভেন্টে নয়।

4. পরিচয়: distinct_id থেকে পরিচয়যুক্ত সেশন

ভেতরে তথ্য আনার অংশটি বেশির ভাগ দল কম গুরুত্ব দেয়। এটি ছাড়া MousePlayer সেশন বেনামি: দেখতে পারবেন, কিন্তু এই অনুরোধের উত্তর দিতে পারবেন না: “গত সপ্তাহে আর ফিরে না আসা অ্যাকাউন্টের রেকর্ডিং দেখান।”

ব্রিজ চালু হলে আপনার বিশ্লেষণ সরঞ্জামের distinct_id লেখা হয় সেশনের এই ঘরে: custom_user_id — হাতে SDK কল করলেও একই ঘরে লেখা হয়:

// The manual equivalent - you do NOT need this when the bridge is active mp('set', { user_id: 'your-internal-id' });

আপনি ইতিমধ্যে নিজে কল করলে mp('set') তা চালিয়ে যান। নিজে স্পষ্টভাবে দেওয়া পরিচয় বেশি নির্ভরযোগ্য, কারণ সেটি আপনার নিজস্ব প্রাইমারি কী, ব্রাউজারভিত্তিক অ্যানালিটিক্স পরিচয়চিহ্ন নয়।

গোপনীয়তা সংক্রান্ত নোট: আপনার বিশ্লেষণ সরঞ্জাম ইতিমধ্যে যে পরিচয়চিহ্ন দিয়েছে শুধু সেটিই স্থানান্তরিত হয়। SDK থেকে ইমেইল ঠিকানা, নাম বা অন্য ব্যক্তিগত ঘর পড়া হয় না। আপনার নিজের গোপনীয়তা নীতিতে এই প্রক্রিয়াকরণ অন্তর্ভুক্ত আছে নিশ্চিত করুন, এবং সম্মতি আইনি ভিত্তি হলে সম্মতির সরঞ্জামের পেছনে ট্র্যাকিং স্ক্রিপ্ট আটকে রাখুন।

5. প্রযুক্তিগত আচরণ

অ্যানালিটিক্স SDK সাধারণত অ্যাসিঙ্ক্রোনাসভাবে লোড হয়, প্রায়ই তার আগেই mp.js চলছে। তাই শুরুর সময় একবার চেষ্টা করলে বেশির ভাগ বাস্তব ওয়েবসাইটে ব্যর্থ হবে।

  • ব্রিজ আবার চেষ্টা করে প্রতি 1.5 সেকেন্ডে, সর্বোচ্চ দশবার, এবং দুই দিকের কাজ সম্পূর্ণ হলেই থামে।
  • প্রতিটি দিক আলাদাভাবে শেষ হয়, তাই পরিচয়ের অপেক্ষায় থাকতে রিপ্লে URL কখনো দুবার পাঠানো হয় না।
  • SDK না এলে ব্রিজ প্রায় 15 সেকেন্ড পরে নীরবে থামে। কনসোলে কিছু লেখা হয় না এবং সেশন রেকর্ডিং অপরিবর্তিতভাবে চলে।
  • 128 অক্ষরের বেশি পরিচয়চিহ্ন কেটে ছোট না করে উপেক্ষা করা হয়, যাতে কোনো কিছুর সঙ্গে মিলবে না এমন অর্ধেক পরিচয়চিহ্ন রাখা না হয়।

6. কাজ করছে কি না যাচাই

  1. সাধারণ ব্রাউজার ট্যাবে আপনার ওয়েবসাইট খুলে কিছুক্ষণ ব্যবহার করুন।
  2. আপনার বিশ্লেষণ সরঞ্জামে নতুন ইভেন্ট খুলে খুঁজুন এই mouseplayer_session_url প্রপার্টি। এটি খুললে সরাসরি রেকর্ডিংয়ে যাওয়ার কথা।
  3. MousePlayer-এ খুলুন ব্যবহারকারী অনুসন্ধান। পরিচয় থাকা সেশনে তৈরি করা দর্শকের ডাকনামের বদলে সেটি দেখায়।

কিছু না দেখালে

  • কোনো ইভেন্টেই প্রপার্টি নেই: অ্যানালিটিক্স SDK সত্যিই পৃষ্ঠায় লোড হচ্ছে কি না এবং মিল থাকা প্ল্যাটফর্ম বেছে নিয়েছেন কি না দেখুন। PostHog নির্বাচন করে Mixpanel পড়া যাবে না।
  • প্রপার্টি শুধু পরের ইভেন্টে দেখায়: এটিই প্রত্যাশিত, ধারা 3-এর নোট দেখুন।
  • URL আছে কিন্তু পরিচয় নেই: আপনার SDK এখনও দেয়নি কোনো distinct_id , ব্যবহারকারী শনাক্ত হওয়ার আগে যা স্বাভাবিক। পরের বার পৃষ্ঠা লোড হলে নেওয়া হবে।
  • প্রবেশ করা অ্যাডমিন হিসেবে পরীক্ষা করছেন: কিছু সেটআপ অভ্যন্তরীণ ট্রাফিক বাদ দেয়। ব্যক্তিগত উইন্ডোতে চেষ্টা করুন।

এখানে উল্লিখিত সব ট্রেডমার্ক নিজ নিজ মালিকের। এই সেবাদাতাদের সঙ্গে MousePlayer-এর ব্যবসায়িক সম্পর্ক নেই।