كل المستندات

واجهة الجلسات

تجميع الجلسات ونقاط نهاية الخط الزمني.

الجلسات

الجلسة مجموعة أحداث لزيارة مستخدم واحدة؛ نيزا لا تنشئها تلقائيًا بل تربطها بالقيمة التي ترسلها.

كيفية ربط الأحداث

  • metadata.sessionId يجمع الأحداث داخل مخطط الجلسة في لوحة التحكم.
  • sessionId في المستوى الأعلى يدخل في تقييم القواعد الخاصة بالجلسة عند الاستقبال.
  • أرسل القيمة نفسها في الموضعين حتى تعمل القواعد والعرض الزمني معًا.
الحدث الأول في الجلسة
POST /api/v1/events

{
  "eventName": "user.login",
  "eventCategory": "AUTHENTICATION",
  "customer": { "externalId": "user_123456" },
  "device": { "externalId": "device_abc123" },
  "sessionId": "session_xyz789",
  "metadata": {
    "sessionId": "session_xyz789",
    "auth_result": "success"
  }
}

ما يظهر في لوحة التحكم

تُرتب أحداث الجلسة زمنيًا. الأحداث بلا metadata.sessionId لا تُحذف؛ تظهر ضمن مجموعة «بلا جلسة».