Skip to main content

Lura Analytics

Lura Analytics automatically tracks playback metrics, viewer behavior, performance data, ad activity, device information, content information, and playback errors.

Quick Start​

To enable Lura Analytics, set the analytics configuration at the top level of your player configuration.

Enable Lura Analytics
import React, { useEffect, useRef } from "react";
import { View } from "react-native";
import { LuraPlayer, type Configuration, type UnifiedPlaylist } from "@akta-tech/lura-player-react-native";
import { LuraPlayerControls } from "@akta-tech/lura-player-react-native-ui";

export default function App() {
    const playerRef = useRef<UnifiedPlaylist>(null);
    const config: Configuration = {
        analytics: {
            enabled: true,
            host: "https://player-analytics.mp.lura.live",
            apiKey: "sample-api-key"
        }
    };

    useEffect(() => {
        playerRef.current?.setConfig(config);
    }, [playerRef]);

    return (
        <View>
            <LuraPlayer ref={playerRef} Controls={LuraPlayerControls} />
        </View>
    );
}

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.

Configuration Options​

Custom Period​

analytics: {
    enabled: true,
    host: "https://player-analytics.mp.lura.live",
    apiKey: "sample-api-key",
    period: 20
}

App Information​

analytics: {
    enabled: true,
    host: "https://player-analytics.mp.lura.live",
    apiKey: "sample-api-key",
    app: {
        id: "sample-app-id",
        name: "Sample App",
        version: "1.0.0"
    }
}

Custom Session Data​

analytics: {
    enabled: true,
    host: "https://player-analytics.mp.lura.live",
    apiKey: "sample-api-key",
    session: {
        data: "sample-session-data",
        userId: "sample-user-id"
    }
}