CoreStone.SDK.Dotnet.Analytics 1.5.0

CoreStone.SDK.Dotnet.Analytics

Fire-and-forget analytics event tracking for CoreStone. Events are buffered in-memory and automatically flushed in batches — your UI thread is never blocked.

Installation

dotnet add package CoreStone.SDK.Dotnet.Configuration
dotnet add package CoreStone.SDK.Dotnet.Analytics

Note: Authentication is not required for analytics. Only X-Project-Key is needed (set via AddCoreStoneConfiguration).

Setup

builder.Services
    .AddCoreStoneConfiguration(o => {
        o.BaseUrl    = "https://api.yourapp.com";
        o.ProjectKey = "prj-xxxxxxxxxxxxxxxx";
    })
    .AddCoreStoneAnalytics(o => {
        o.MaxBatchSize         = 20;   // Flush when 20 events accumulate
        o.FlushIntervalSeconds = 30;   // Or every 30 seconds, whichever comes first
    });

Usage

Fluent Builder (Recommended)

public class HomeViewModel(IAnalyticsClient analytics)
{
    public void OnAppeared()
    {
        analytics.Track(
            CoreStoneEvent.ScreenView("HomeScreen")
                .WithSession(sessionId)
                .WithPlatform("web")
                .WithAppVersion("2.1.0"));
    }
}

All Event Types

// Session lifecycle
analytics.Track(CoreStoneEvent.SessionStart(sessionId, platform: "web"));
analytics.Track(CoreStoneEvent.SessionEnd(sessionId, durationSeconds: 300));

// Authentication
analytics.Track(CoreStoneEvent.Login(sessionId, platform: "web", method: "email"));
analytics.Track(CoreStoneEvent.Logout(sessionId));
analytics.Track(CoreStoneEvent.Register(sessionId, platform: "web", method: "email"));

// Navigation
analytics.Track(CoreStoneEvent.ScreenView("CheckoutPage", sessionId, referrer: "CartPage"));

// Feature usage
analytics.Track(CoreStoneEvent.FeatureInteraction("HomeScreen", "share_button",
    sessionId, action: "tap"));

// Support
analytics.Track(CoreStoneEvent.SupportOpen(sessionId, screen: "ProfilePage"));
analytics.Track(CoreStoneEvent.SupportMessage(sessionId, ticketId: "TKT-001"));

// Version check-in
analytics.Track(CoreStoneEvent.VersionCheckin(appVersion: "2.1.0", platform: "android"));

// Crash reporting — automatically captures exception type, message, and stack trace
analytics.Track(CoreStoneEvent.Crash(exception, screen: "CheckoutPage", sessionId));
analytics.Track(CoreStoneEvent.Crash("NullPointerException", "Null ref in payment flow"));

// Custom events
analytics.Track(CoreStoneEvent.Custom("promo_banner_clicked", sessionId)
    .WithProperty("campaignId", "SUMMER2026")
    .WithProperty("bannerId", "banner-42"));

Raw Event Object

analytics.Track(new AnalyticsEvent
{
    EventType  = KnownEventTypes.ScreenView,
    SessionId  = sessionId,
    Platform   = "android",
    AppVersion = "2.1.0",
    Properties = new() { ["screen"] = "HomeScreen" }
});

Force Flush (e.g. before app shutdown)

// In App.OnStop() or similar lifecycle hook
await analytics.FlushAsync();

Global Crash Handler (ASP.NET)

// Program.cs
app.Use(async (context, next) =>
{
    try { await next(); }
    catch (Exception ex)
    {
        analytics.Track(CoreStoneEvent.Crash(ex, screen: context.Request.Path));
        await analytics.FlushAsync();
        throw;
    }
});

Supported Event Types

Links

• NuGet Gallery
• GitHub Repository