@lerix-dev/lerix-edge بالإصدار 0.2.0 أو أحدث. تستخدم الميزتان عميل
lerix الذي أعددته في التثبيت. ولمعرفة ما
تراه في لوحة التحكم، راجع التحليلات
والملاحظات.
التحليلات
- تصل الأحداث إلى مسارات التحويل وأعداد المستخدمين نفسها التي تغذّيها أحداث
تطبيقاتك. و
userIdهو معرّفك الخاص للمستخدم، وهو نفسه الذي تمرّره تطبيقاتك إلىsetUser(). - تبدأ الأسماء بحرف، ثم حروف أو أرقام أو مسافات أو
_أو.أو:أو-(من 2 إلى 64 حرفاً). حتى 25 خاصية، قيمها نصوص (حتى 1024 حرفاً) أو أرقام منتهية أو قيم منطقية أوnull. الاسم غير الصالح يُسقط الحدث، والخاصية غير الصالحة تُسقط وحدها. ولا يرميtrack()أي استثناء.
الإرسال
تُخزَّن الأحداث داخل الـ isolate (حتى 1000 حدث، ويُحذف الأقدم أولاً) وتُرسل على دفعات حتى 100 حدث بعد الرد عبرwaitUntil، أو فور تجمّع 50 حدثاً. ولا يوجد
مؤقّت، لأن الـ isolates تتجمّد بين الطلبات.
وخارج wrap()، في معالج مهام مجدولة أو مستهلك طوابير مثلاً، أرسل ما تبقى قبل
أن تعود:
البيئة وإيقاف التتبّع
تحمل الأحداثplatform: "edge"، وبيئة التشغيل بوصفها نظام التشغيل، وإصدار
تطبيقك ورقم البناء، والبيئة: خيار environment، أو NODE_ENV حيث يمكن قراءته،
فتُرسل production باسم prod وdevelopment باسم dev (وprod إن لم
تُضبط).
analytics: false في خيارات Lerix.init الدالة track() إلى عملية لا
تفعل شيئاً.
الملاحظات
- تُرفع المرفقات أولاً، ثم تُنشأ الملاحظة بمعرّفاتها.
- يُعاد إرسال الطلبات الفاشلة مرتين بمعرّف العميل نفسه، فلا تتكرر الملاحظة.
- ترفض
submit()بخطأLerixApiException(الرمزINVALID_FEEDBACKلمدخلات لا يمكن إرسالها، أو خطأ الواجهة)، وتُرجعnullمعenabled: false. - داخل طلب مُتتبَّع، ترتبط الملاحظة بالتتبّع.
يُخزَّن
userId الذي تمرّره على أنه مُبلَّغ عنه من خادمك. ولا تُرسل الردود
بالإشعارات إلا للمستخدمين المُتحقَّق منهم عبر setUser في حزم العميل.