Appearance
Metrics Library Documentation
Overview
Welcome to our comprehensive Metrics Library. This library provides a standardized approach to tracking, measuring, and analyzing user behavior, business performance, and technical metrics across different types of applications and platforms.
Purpose
The Metrics Library serves several key purposes:
- Establish consistent definitions for common metrics
- Provide standardized calculation methods
- Enable cross-platform and cross-product analysis
- Support data-driven decision making
- Ensure metric reliability and accuracy
Library Structure
1. Core Components
Events
Events are the fundamental building blocks of our metrics system. Each event represents a specific user action or system occurrence that we want to track.
yaml
table_name: analytics.event_name
tags: [event_type1, event_type2]
columns:
_id:
data_type: STRING
_user:
data_type: STRING
tags: [entity_id_column]
_time:
data_type: DATETIME
tags: [event_timestamp_column]
# Additional columns...
Properties
Properties are derived values calculated from events. They can be:
- Event Properties (direct measurements)
- Computed Properties (calculated values)
- Sliding Window Properties (rolling calculations)
- Lifetime Properties (cumulative values)
KPIs
Key Performance Indicators (KPIs) are high-level user metrics that provide insights into business performance and user behavior.
2. Categories
Our library includes metrics for:
- Standard Activity
- Monetization
- User Acquisition
- Engagement
- Performance
- Custom Business Metrics
The following industries are covered with more depth:
- e-Commerce
- Mobile Gaming
- iGaming
Usage Guidelines
1. Selecting Metrics
When choosing metrics:
- Start with standard metrics
- Add core metrics for your domain
- Add specific metrics for your use case
2. Best Practices
Naming Conventions
- Use snake_case for property names
- Use descriptive, consistent names
- Include units in metric names when applicable
- Add clear labels for visualization
Calculations
- Use
SAFE_DIVIDE
for division operations - Include default values for properties
- Consider data latency in window calculations
- Document complex calculations
Start exploring our metrics library by selecting your relevant domain and use case from the categories above.