ASP.NET Core — التحليلات والملاحظات

​

التحليلات

public class OrdersService(LerixClient lerix)
{
    public void Complete(Order order, User user)
    {
        // ...
        lerix.Track("checkout_completed", new Dictionary<string, object?>
        {
            ["items"] = 3,
            ["total"] = 49.90m,
            ["coupon"] = "EID",
        }, userId: user.Id);
    }
}

• لا يرمي Track أي استثناء ولا ينتظر الشبكة أبداً: يتحقق من الحدث ويضعه في ذاكرة مؤقتة.
• userId هو معرّفك للمستخدم الذي يخصّه الحدث، وهو نفسه الذي تمرّره تطبيقاتك إلى setUser() (بعد حذف المسافات الطرفية، حتى 255 حرفاً). يُرسل مع كل حدث، فتستطيع خدمة واحدة تتبّع مستخدمين كثيرين.
• الأسماء تبدأ بحرف، ثم حروف أو أرقام أو مسافات أو _ أو . أو : أو - (من 2 إلى 64 حرفاً). وأي اسم آخر يُسقط الحدث.
• الخصائص: حتى 25 مفتاحاً، يبدأ كل منها بحرف أو _، ثم حروف أو أرقام أو _ أو . أو -. والقيم نصوص (حتى 1024 حرفاً) أو أرقام منتهية (أي نوع رقمي أو decimal) أو bool أو null، ويصلح كذلك JsonElement من أحد هذه الأنواع. وأي شيء آخر (كائنات متداخلة، أو قوائم، أو تواريخ، أو NaN) يُسقط مفتاحاً مفتاحاً، ويُسجَّل حين يكون Debug مفعّلاً.

​

الإرسال

await lerix.Analytics.FlushAsync();   // also part of lerix.FlushAsync()
lerix.Analytics.SetEnabled(false);    // stop recording and clear the buffer (until restart)

{ "Lerix": { "Analytics": { "FlushInterval": "00:00:05", "FlushAt": 20 } } }

​

الملاحظات

var id = await lerix.Feedback.SubmitAsync(new LerixFeedback
{
    Message = "The export button does nothing",
    Email = "user@example.com",
    Labels = new[] { "bug" },
    UserId = user.Id,
    Custom = new Dictionary<string, object?> { ["plan"] = "pro" },
    Attachments = new[] { new LerixFeedbackAttachment(screenshotBytes) { Width = 1280, Height = 800 } },
});

• Message إلزامي (من 1 إلى 4000 حرف بعد حذف المسافات الطرفية). وLabels هي مفاتيح التصنيفات المُعدّة للمشروع، وتُهمل الواجهة غير المعروف منها.
• يقبل Custom حتى 50 مفتاحاً و16 كيلوبايت من JSON.
• Attachments: حتى 5 صور PNG أو JPEG أو WebP بحجم أقصاه 5 ميغابايت لكل منها. يُقرأ النوع من البايتات، ويُعدّ ContentType المخالف لها خطأً.
• الاستدعاء داخل طلب مُتتبَّع يحمل معرّف تتبّع ذلك الطلب، ويُحتفظ بالتتبّع.
• ترمي المدخلات غير الصالحة LerixApiException مع Code = "INVALID_FEEDBACK" قبل إرسال أي شيء. وتُعاد محاولة أخطاء الشبكة و5xx و429 مرتين بمعرّف العميل نفسه، فلا تُنشئ إعادة المحاولة بلاغاً ثانياً. ويُرمى آخر خطأ كـ LerixApiException.
• تُرجع معرّف الملاحظة، أو null حين تكون الحزمة معطّلة (Enabled = false).