Skip to content

Analytics Tracking Example

Monitoring analytics events with the Analytics module.

Step 1: Log Analytics Events

// Screen view
AnalyticsLogger.log(
    AnalyticsLog(
        tag = "home_screen_view",
        screenClass = "com.app.HomeScreen",
        timestamp = System.currentTimeMillis(),
        type = AnalyticsLogCategory.Screen.View
    )
)
// User action
AnalyticsLogger.log(
    AnalyticsLog(
        tag = "button_click",
        screenClass = "HomeScreen",
        timestamp = System.currentTimeMillis(),
        type = AnalyticsLogCategory.Action.Click
    )
)

Step 2: Register Analytics Module

val modules = rememberModules {
    module(Analytics()) // constructor params customize summary chip types
    // ...other modules...
}

Step 3: Use AnalyticsScreen in Your Composable

@Composable
fun MyApp() {
    // AnalyticsScreen is rendered automatically when Analytics() is registered in rememberModules.
    // To use it standalone:
    CompositionLocalProvider(LocalAnalytics provides AnalyticsLogger.logs) {
        AnalyticsScreen(
            highlightedAnalyticsLogTypes = persistentListOf(
                AnalyticsLogCategory.Action.Click,
                AnalyticsLogCategory.Performance.Error
            )
        )
    }
}

Step 4: Test Analytics Tracking

  • Open DevView and navigate to the Analytics module
  • Trigger events in your app and observe them in real time
  • Use filtering and search to inspect specific events

Troubleshooting

  • If events do not appear, check that you are using AnalyticsLogger.log() correctly
  • For UI issues, verify Compose state and log updates
  • For platform-specific issues, check Compose Multiplatform compatibility

Next Steps

If you encounter issues not covered here, consult the Troubleshooting & FAQ or open an issue on the DevView repository.