#docs #basics #setup #basics #analytics

Analytics Overview

TelemetryDeck's dashboard is organized into intuitive sections that help you understand how users interact with your app. This guide walks you through each part of the interface.

Dashboard navigation

After integrating the TelemetryDeck SDK into your app, your data will start appearing in the TelemetryDeck dashboard. The main navigation tabs help you find different types of insights:

TelemetryDeck Main Navigation

Let’s explore what you’ll find in each section:

Overview

The Overview tab provides a high-level summary of your app’s performance, showing key metrics like daily active users, total users, user retention, app version distribution, and system version distribution:

Overview Dashboard

This view gives you immediate answers to: “How is my app performing right now?” and “Are my users upgrading to new versions?”

Customers (User Analytics)

The Customers section organizes your user data according to the journey users take with your app, from discovery to monetization:

Acquisition Dashboard

Each tab focuses on a different stage of the user journey:

Acquisition tracks how users find and install your app, with metrics for new user counts, device distribution, geographic insights, and typical discovery patterns.

Activation (Coming Soon) monitors initial engagement with metrics like active user counts, session length distribution, and usage patterns by time of day and day of week.

Retention (Coming Soon) measures how effectively your app keeps users coming back, tracking distinct days used, engaged user metrics, and power user identification.

Referral (Coming Soon) helps understand how users share your app with others.

Revenue (Coming Soon) tracks your app’s financial performance metrics.

Acquisition Analytics

Learn how to interpret and act on acquisition metrics to optimize how users discover your app.

Understanding Pirate Metrics Framework

Learn about the AARRR framework that organizes analytics by acquisition, activation, retention, referral, and revenue.

TelemetryDeck also provides built-in presets for tracking purchases and revenue that require minimal additional configuration in your app:

Purchase Tracking with Built-in Presets

Learn how to track in-app purchases with TelemetryDeck's built-in purchase tracking system and dashboards.

Metrics (Technical Analytics)

The Metrics section provides essential technical insights about your app across different devices and platforms:

Metrics Dashboard - Devices

Key metrics include:

  • Devices: Hardware models, screen resolutions, and platform distributions
  • Versions: App and SDK version adoption rates
  • Errors: Issue monitoring by frequency and type
  • Localization: Language and regional settings insights
  • Accessibility: Usage of accessibility features

Complete Metrics Analytics Guide

Explore our comprehensive guide to technical analytics, including detailed information on device types, app versions, error tracking, localization insights, and accessibility usage.

Explore (Signal Analytics)

The Explore section gives you direct access to your raw event data through multiple views:

Explore Dashboard - Signal Types

Here you can examine all signal types your app has sent, explore parameters attached to your events, view recent events chronologically, and use the query playground to experiment with data analysis. This section is particularly useful for debugging, understanding user behavior sequences, and diving deeper into specific user actions.

Event Naming Best Practices

Learn how to name your signal types effectively for better organization and analysis.

Dashboards (Custom Insights)

The Dashboards section allows you to create and organize custom visualizations:

Custom Dashboards

You can build insights using either the visual editor (for simple queries) or TelemetryDeck Query Language (TQL) for more complex analysis. Common dashboard setups include:

  • Feature usage dashboards that track adoption of specific features
  • Conversion funnels showing how users progress through multi-step processes
  • User segment comparisons between different types of users
  • Error monitoring dashboards focused on app stability

Each insight can be organized into groups (displayed in the sidebar) to keep related metrics together, such as “Onboarding Experience”, “Premium Features”, or “App Performance”.

Understanding Insights

Learn what insights are and how they help you understand your app's performance data.

Creating Custom Dashboards

Learn how to organize your insights into custom dashboard groups for better organization.

Setting Up Filters

Learn how to use the filter editor to refine your insights and focus on specific data.

Creating Funnel Charts

Learn how to track user conversion through multi-step processes with funnel charts.

Common Dashboard tasks

Filtering data

At the top of most dashboard pages, you’ll find time filters that let you focus on specific periods:

Filtering Data

  • Last 30 Days (default) – Shows data from the past month
  • Test Mode – Toggle to see data from development builds (when your app is run directly from your IDE)

Using Test Mode

Understand how to use Test Mode to separate development events from production data.

Exploring details

Many visualizations have interactive elements:

Exploring Details

  • Hover over chart elements to see detailed values
  • Click on segments in pie/donut charts to filter by that value
  • Use the “…” menu in the top right of cards for additional options

Collaboration

Inviting Team Members

Learn how to invite colleagues to your TelemetryDeck organization and collaborate on analytics.

Advanced features

Using TQL for Advanced Queries

Learn about TelemetryDeck Query Language for creating complex custom insights.

Website Traffic Source Analysis

For web apps, learn how to track where your users are coming from before visiting your site.

Integrations

RevenueCat Integration

Learn how to integrate TelemetryDeck with RevenueCat to combine usage data with purchase data.

Superwall Integration

Learn how to integrate TelemetryDeck with Superwall to get insights into your paywalls.

Privacy & Security

How User Data Anonymization Works

Learn how TelemetryDeck protects user privacy while still providing valuable analytics.

Privacy FAQ

Find answers to common questions about TelemetryDeck's privacy features and policies.