Skip to main content

Lura Analytics

info

As of 2023, Samsung states that Tizen TV's are not optimized for .NET applications. Samsung strongly recommends using JS/Web applications instead of C#/.NET applications for TVs. Please check the Lura Player Web SDK

Lura .NET SDK provides built-in Lura Analytics functionality for Tizen TV applications. Lura Analytics automatically tracks and collects comprehensive playback metrics, viewer behavior, and performance data, enabling you to gain insights into how users interact with your video content.

Quick Start​

To enable Lura Analytics, set the Lura Analytics configuration in your player configuration:

Enable Lura Analytics
var config = new Configuration
{
    Analytics = new AnalyticsConfiguration
    {
        Enabled = true,
        Host = "https://player-analytics.mp.lura.live",
        ApiKey = "sample-api-key"
    }
};

player.SetConfig(config);

What Gets Tracked​

When analytics is enabled, Lura automatically collects the following data:

  • Playback Metrics: Play attempts, play count, play time, buffering statistics
  • Performance Data: Bitrate information, buffering duration, seeking behavior
  • Ad Analytics: Ad impressions, ad quartiles, ad buffering, ad completion rates
  • Device Information: Device type, OS, browser details
  • Network Data: Connection type, bandwidth estimates, CDN information
  • Content Data: Content ID, type, duration
  • Error Tracking: Error occurrences and counts

Configuration Options​

Basic Configuration​

Enable analytics by providing the analytics endpoint and API key:

Analytics = new AnalyticsConfiguration
{
    Enabled = true,
    Host = "https://player-analytics.mp.lura.live",
    ApiKey = "sample-api-key"
}

Lura Analytics is enabled only when Enabled is true, Host is a valid HTTPS URL, and ApiKey is valid. Payloads are sent every Period seconds. When Period is not specified, the player uses 10 seconds.

Custom Session Data​

Add custom session metadata:

Analytics = new AnalyticsConfiguration
{
    Enabled = true,
    Host = "https://player-analytics.mp.lura.live",
    ApiKey = "sample-api-key",
    Session = new AnalyticsSessionConfiguration
    {
        UserId = "user-123",
        Data = "custom-data"
    }
}

App Information​

Set application information:

Analytics = new AnalyticsConfiguration
{
    Enabled = true,
    Host = "https://player-analytics.mp.lura.live",
    ApiKey = "sample-api-key",
    App = new AnalyticsAppConfiguration
    {
        Id = "app-id",
        Name = "My App",
        Version = "1.0.0"
    }
}