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

المقدمة

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

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

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

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

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

🚀 البدء السريع​

قم بتهيئة الوحدة من defineOneEntry:


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

سجل حدث مشاهدة منتج (يعمل لمستخدم مخول أو ضيف):

// Track that the visitor opened a product page.
const ok = await UserActivity.trackUserActivity({
  type: "product_view",
  productId: 12345,
  meta: { sourceBlock: "catalog" },
});

console.log(ok); // true on success

trackUserActivity() تأخذ كائن جسم واحد وتنجح إلى true عند النجاح. إنها عملية غير متزامنة — لا تعطل العرض عليها.

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

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

النشاط مرتبط بالسياق الحالي: مستخدم مخول (عبر وحدة 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 الذي يتطابق مع نوع الحدث type.
  • حافظ على استقرار معرفات الضيوف حتى يكون نشاط الضيف متسقًا عبر الطلبات.

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