جسر تحليلات المنتج

1. المشكلة: أرقام بلا وجوه

تمنحك تحليلات المنتج مسارًا: بلغ 1,000 مستخدم إتمام الشراء وغادره 620. قياس دقيق لمشكلة لا تزال لا تراها. مشاهدة بعض تسجيلات هؤلاء الـ 620 تجيب عادة خلال دقائق — لكن فقط إن انتقلت من الرسم للجلسات الصحيحة دون تصدير معرّفات وبحث يدوي.

يزيل جسر تحليلات المنتج هذه الفجوة. يعمل داخل mp.js ويربط النظامين تلقائيًا:

صادر: يحمل كل حدث تسجّله أداة التحليل خاصية mouseplayer_session_url . افتح أي حدث وانقر الرابط وشاهد الجلسة.
وارد: يُقرأ معرّف الزائر distinct_id ويُحفظ في جلسة MousePlayer، فتصبح التسجيلات قابلة للبحث بالهوية نفسها التي تستخدمها في PostHog أو Mixpanel أو Amplitude.

دون كود مطلوب. يكتشف الجسر SDK التحليلات تلقائيًا. لا تستدعي أي دالة MousePlayer، ولا تحتاج لتغيير طريقة تتبع الأحداث.

2. التفعيل

الطريقة أ: لوحة المعلومات (دون كود)

افتح مشروعك وانتقل إلى تبويب التكاملات .
غيّر إعداد جسر PostHog وMixpanel & Amplitude إلى ON.
اختر المنصة التي تستخدمها. تُحفظ التغييرات تلقائيًا.

يسري الإعداد عند التحميل التالي لصفحة موقعك. لا تتأثر الجلسات الحالية بأثر رجعي.

الطريقة ب: إعداد البرنامج النصي يدويًا

إن فضّلت تثبيته في الكود، اضبط القيمتين داخل window.mp_config:

<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. التحقق من العمل

افتح موقعك في علامة تبويب عادية وتفاعل قليلًا.
افتح أحدث حدث في أداة التحليل وابحث عن خاصية mouseplayer_session_url . يجب أن يفتح رابطها التسجيل مباشرة.
في MousePlayer افتح مستكشف المستخدمين. تعرض الجلسات ذات الهوية تلك الهوية بدل لقب الزائر المولّد.

إذا لم يظهر شيء

الخاصية مفقودة في كل الأحداث: تحقق من تحميل SDK التحليلات فعلًا ومن اختيار المنصة الصحيحة. اختيار PostHog لن يقرأ Mixpanel.
تظهر الخاصية في الأحداث اللاحقة فقط: هذا متوقع، انظر ملاحظة القسم 3.
URL موجود لكن الهوية غائبة: لم يعيّن SDK لديك distinct_id بعد، وهذا طبيعي قبل تعريف المستخدم. سيُلتقط في تحميل لاحق للصفحة.
تختبر كمسؤول مسجّل الدخول: تستبعد بعض الإعدادات الزيارات الداخلية. جرّب نافذة خاصة.

كيف يمكننا المساعدة؟