انتقل إلى المحتوى الرئيسي

المقدمة

سجل ما يفعله المستخدمون والضيوف لديك، وحوّله إلى تجارب مخصصة.

مزيد من المعلومات حول واجهة مستخدم الوحدة https://doc.oneentry.cloud/docs/category/useractivity

🎯 ماذا تفعل هذه الوحدة؟​

تتيح لك وحدة UserActivity تتبع أحداث النشاط للمستخدم الحالي أو الضيف - مشاهدات المنتجات، مشاهدات الصفحات، عمليات البحث، إجراءات السلة وقائمة الرغبات، المشتريات والتقييمات.

فكر في الأمر كإشارة التحليلات وراء التخصيص - الأحداث التي ترسلها تغذي محرك التوصيات في OneEntry، الذي يدعم الكتل مثل التوصيات الشخصية، المشاهدات الأخيرة، الشراء المتكرر و الرائجة.

📖 شرح بسيط​

في كل مرة يقوم فيها زائر بفعل شيء ذي معنى، تسجل حدثًا:

  • 👀 عرض المنتج - فتح الزائر لصفحة منتج
  • 📄 عرض الصفحة / الفئة - تصفح الزائر لصفحة أو فئة
  • 🔎 بحث - بحث الزائر عن شيء ما
  • 🛒 إجراءات السلة / قائمة الرغبات - العناصر المضافة أو المحذوفة
  • 💰 شراء - شراء الزائر لمنتج
  • ⭐ تقييم - تقييم الزائر لمنتج

تستخدم OneEntry هذا التدفق من الأحداث لفهم كل زائر وتخصيص ما يرونه.

✨ المفاهيم الأساسية​

يعمل مع المستخدمين والضيوف​

النشاط مرتبط بالسياق الحالي: مستخدم مخول (عبر وحدة AuthProvider) أو ضيف. بالنسبة للضيوف، ترسل SDK رأس x-guest-id حتى يتم نسب الأحداث إلى الزائر المجهول الصحيح. راجع وضع الضيف للحصول على التفاصيل.

أنواع الأحداث​

نوع الحدث type هو واحد من مجموعة ثابتة من القيم: product_view, page_view, category_view, search, product_add_to_cart, product_remove_from_cart, product_add_to_wishlist, product_remove_from_wishlist, product_purchase, product_rating.

📋 ما تحتاج إلى معرفته​

  • أرسل الحدث الذي يتطابق مع الإجراء: قم بتضمين productId لأحداث المنتجات، وpageId لمشاهدات الصفحات/الفئات، وquery للبحث.
  • يقبل حقل meta بيانات عشوائية (كتلة المصدر، متغير A/B، عمق التمرير) لتحليلاتك الخاصة.
  • trackUserActivity() تحل إلى true عند النجاح - إنها عملية غير متزامنة ولا ينبغي أن تعيق واجهة المستخدم.

📊 جدول مرجعي سريع​

الطريقةالوصف
trackUserActivity()سجل حدث نشاط مستخدم أو ضيف

❓ الأسئلة الشائعة (FAQ)​

هل أحتاج إلى تفويض المستخدم لتتبع النشاط؟​

لا. يتم تسجيل النشاط للسياق الحالي - مستخدم مخول أو ضيف. في المتصفح، تقوم SDK بإنشاء والحفاظ على معرف الضيف تلقائيًا؛ على الخادم، مرر guestId لكل زائر.

ما هو حقل meta؟​

meta هو كائن حر الشكل لأي معلومات إضافية تريد إرفاقها بحدث، مثل كتلة المصدر، متغير اختبار A/B، أو عمق التمرير.

🎓 أفضل الممارسات​

  • تتبع الأحداث كما تحدث، ولكن لا تعطل العرض أثناء استدعاء الشبكة.
  • أرسل productId / pageId / query الذي يتطابق مع نوع الحدث.
  • حافظ على استقرار معرفات الضيوف حتى يكون نشاط الضيف متسقًا عبر الطلبات.

تعريف وحدة UserActivity​


const { UserActivity } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 الوثائق ذات الصلة​