trackUserActivity

سجل حدث نشاط مستخدم أو ضيف.

الوصف

تسجل هذه الطريقة حدث نشاط واحد للمستخدم المصرح به الحالي أو الضيف (على سبيل المثال، عرض منتج، بحث، أو إجراء على السلة). تعيد Promise التي تحل إلى true إذا تم تسجيل الحدث، أو كائن IError إذا كان هناك مشكلة.

UserActivity.trackUserActivity(

body*, body.type*, body.productId, body.pageId, body.categoryId, body.query, body.meta

);

مخطط المعلمات

المخطط

body(required): ITrackActivity
جسم حدث النشاط. مثال: { type: "product_view", productId: 12345 }

body.type(required): TUserActivityType
نوع حدث النشاط. واحد من: "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".
مثال: "product_view"

body.productId: number
معرف المنتج.
مثال: 12345

body.pageId: number
معرف الصفحة (لـ page_view، category_view).
مثال: 7

body.categoryId: number
معرف الفئة القديمة.
مثال: 67

body.query: string
استعلام البحث (لـ type=search).
مثال: "حافظة آيفون"

body.meta: Record<string, unknown>
معلومات ميتا عشوائية (كتلة المصدر، متغير A/B، عمق التمرير).

أمثلة

مثال بسيط

const response = await UserActivity.trackUserActivity({
  type: 'product_view',
  productId: 12345,
});

مثال مع السمات

const response = await UserActivity.trackUserActivity({
  type: 'search',
  query: 'iphone case',
  meta: { sourceBlock: 'header_search', variant: 'b' },
});

استجابة المثال

true

مخطط الاستجابة

المخطط: boolean

boolean: boolean
تعيد true إذا تم تسجيل الحدث.
مثال: true

---