trackUserActivity

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

الوصف

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

UserActivity.trackUserActivity(

body*

);

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

المخطط

body(required): ITrackActivity
جسم حدث النشاط
مثال:

{ type: "product_view", productId: 12345 }

body.type(required): TUserActivityType
نوع حدث النشاط.
مثال: "product_view"

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

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

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

body.query: string
استعلام البحث (لـ type=search).
مثال: "iphone case"

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

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

Details

المخطط: boolean

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

---