Skip to content

Latest commit

 

History

History
117 lines (96 loc) · 4.9 KB

event-types.md

File metadata and controls

117 lines (96 loc) · 4.9 KB
Raw
title description
Event Types
Overview of using event types to track user sources, sinks and milestones in your experience.
<iframe width="880" height="495" src="https://www.youtube-nocookie.com/embed/NFLP-FVv834" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

Event types help you identify opportunities to grow and monetize your experience. They allow you to integrate event tracking in your experience and visualize your in-experience economy and player usage patterns on the Analytics dashboard

Once you begin tracking these events from your experience using the Class.AnalyticsService, you'll unlock new Economy, Funnel, and Custom dashboards under Analytics on the Creator Dashboard. You can use these dashboards to identify growth opportunities and segment users by age, gender, platform, OS and custom fields. All of these features are free to use.

Economy and Funnels dashboard pages populated with data.

Event Types

Roblox provides three sets of analytic dashboards you can use to track different aspects of your experience:

  1. Economy events let you track your in-experience economy, such as:

    • Top sinks — What do users spend in-experience resources on?
    • Top sources — Where do users earn resources?
    • Average wallet balance — How much resources are users holding?

2. **Funnel events** let you track your user's progress through key stages of your experience, such as: 

  - **Onboarding** — Where do users drop off when getting started with your experience?
  - **Progression** — Where do users stop advancing through your experience?
  - **Shop** — Where do users abandon purchases?

3. **Custom events (limited beta)** let you track metrics specific to your experience, such as: 

  - **Adoption** — How many users click on a specific UI component?
  - **User Behavior** — What is the most frequently used ability on each map?
  - **Core Loop** — How do kill/death ratios compare across different weapons?

For more information on setting up these dashboards, see Economy Events, Funnel Events and Custom Events.

Validating Your Event Tracking

Once you add Economy, Funnel, or Custom events to your experience, charts on the respective pages typically take 24 hours to appear. In the meantime, you can check if events are set up correctly using the View Events tool:

  1. Navigate to the Economy, Funnel, or Custom pages of your Analytics dashboard for your experience.
  2. Click the View Events button at the top of each page. A near real-time list of the most recent events displays.
  3. Refresh the page to update the list.

View events report displaying multiple event entries sortable by event type, user ID and keyword.

You can also visit your experience's error report to see if there are any errors with your event tracking.

Event Tracking Limitations

The following limitations apply when tracking your events with Class.AnalyticsService:


**Limitation** **Maximum Value** **Examples**
Economy, Funnel, and Custom events `Class.AnalyticsService` requests per minute 120 + (20 * CCU)
Number of [custom fields](./custom-fields.md) 3 Class, Level, Weapon
Unique values per [custom field](./custom-fields.md) Unlimited — After 8,000 combined values across all custom fields, values will be grouped as "Other" Warrior, Mage, Archer
Economy only Resource types 10 Coins, Gold, Credits
transactionTypes Unlimited — After 20, values will be grouped as "Other" IAP, Gameplay
itemSkus Unlimited — After 100, values will be grouped as "Other"
Funnel only Number of funnels 10 Onboarding, Shop
Steps per funnel 100 Step 1, Step 2, Step 3
Custom only eventNames 100 MonsterDefeated, KillDeathRatio, PetAdoption