پل PostHog، Mixpanel & Amplitude

ابزار تحلیل محصولتان می‌گوید چه اتفاقی افتاد. MousePlayer نشان می‌دهد چرا. این پل هر دو را در دو جهت متصل می‌کند تا از ریزش قیف تا ضبطی که آن را توضیح می‌دهد تنها یک کلیک فاصله باشد.

1. مسئله: عدد بدون چهره

تحلیل محصول قیف می‌دهد: 1,000 کاربر به پرداخت رسیدند و 620 نفر رها کردند. این اندازه‌گیری دقیق مشکلی است که هنوز نمی‌بینید. تماشای چند ضبط از آن 620 معمولاً ظرف چند دقیقه پاسخ می‌دهد — اما فقط اگر از نمودار به نشست درست برسید و نیازی به صدور شناسه و جستجوی دستی نباشد.

این پل تحلیل محصول فاصله را برمی‌دارد. درون 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 متفاوتی دارد؛ پل فراخوان مناسب هرکدام را به کار می‌برد. پیکربندی لازم نیست — از انتخاب ارائه‌دهنده پیروی می‌کند.

پلتفرمخروجی (نشانی بازپخش)ورودی (هویت)
PostHog posthog.register() — به‌صورت ویژگی سراسری ثبت می‌شود و به هر رویداد بعدی افزوده می‌شود posthog.get_distinct_id()
Mixpanel mixpanel.register() — همان رفتار ویژگی سراسری mixpanel.get_distinct_id()
Amplitude setUserProperties() — به‌صورت ویژگی کاربر تنظیم می‌شود getDeviceId()، با جایگزین getInstance().options.deviceId در SDK قدیمی

ویژگی سراسری در برابر ویژگی کاربر: در PostHog و Mixpanel نشانی بازپخش به رویدادهای آینده افزوده می‌شود؛ پس در هر رویداد پس از راه‌اندازی پل هست — در رویدادی که پیش‌تر در بارگذاری صفحه فرستاده شده نیست.

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 ثانیه، حداکثر ده بار تلاش می‌کند و به‌محض تکمیل هر دو جهت متوقف می‌شود.
  • هر جهت مستقل تکمیل می‌شود تا نشانی بازپخش هنگام انتظار برای هویت دوباره فرستاده نشود.
  • اگر SDK هرگز ظاهر نشود، پل پس از حدود 15 ثانیه بی‌صدا کنار می‌رود. در کنسول چیزی نوشته نمی‌شود و ضبط نشست بی‌تغییر ادامه دارد.
  • شناسهٔ بیش از 128 نویسه نادیده گرفته می‌شود و بریده نمی‌شود تا نیمهٔ شناسه‌ای که هرگز منطبق نخواهد شد ذخیره نشود.

6. بررسی کارکرد

  1. سایت را در برگهٔ معمولی مرورگر باز کنید و کمی با آن کار کنید.
  2. در ابزار تحلیل تازه‌ترین رویداد را باز کنید و ویژگی mouseplayer_session_url را بیابید. باز کردنش باید مستقیم به ضبط برود.
  3. در MousePlayer این بخش را باز کنید: User Explorer. نشست دارای هویت آن را به‌جای نام مستعار تولیدشدهٔ بازدیدکننده نشان می‌دهد.

اگر چیزی دیده نمی‌شود

  • ویژگی در همهٔ رویدادها نیست: بارگذاری واقعی SDK تحلیل در صفحه و انتخاب پلتفرم درست را بررسی کنید. انتخاب PostHog دادهٔ Mixpanel را نمی‌خواند.
  • ویژگی فقط در رویدادهای بعدی هست: انتظار همین است؛ یادداشت بخش 3 را ببینید.
  • نشانی هست، اما هویت نیست: SDK شما هنوز شناسهٔ distinct_id را تخصیص نداده است که پیش از شناسایی کاربر طبیعی است. در بارگذاری بعدی صفحه گرفته می‌شود.
  • با حساب مدیر واردشده آزمایش می‌کنید: برخی تنظیم‌ها ترافیک داخلی را کنار می‌گذارند. پنجرهٔ خصوصی را امتحان کنید.

همهٔ علائم تجاری نام‌برده متعلق به مالکانشان‌اند. MousePlayer با این ارائه‌دهندگان رابطهٔ تجاری ندارد.