Intro to Custom Events

Unity Analytics allows you to track specific custom events, so you can see how users are interacting with your game. You can use this to identify usage patterns by analyzing a player segment that triggers a specific event. Or to better understand where your players are dropping off.

A custom event is any event that you want to track that isn’t already handled by the Unity Analytics SDK. Unity Analytics captures default metrics such as: device platform, new users, sessions, etc.

• Custom events can be any specific in-game action your player takes.
• Parameters describe attributes or details of an Event or the player performing it.

Here are some examples of custom events and their associated parameters


Analysis Points
How many custom events can I implement? Currently, Unity Analytics testers have 1,000 total Analysis Points to spend on custom events and parameters. We look at the number of event names and also the types (i.e., numeric or non-numeric) of parameters to calculate how many Analysis Points a custom event costs. For more information on how to get the most out of your points check out this forum post.

Custom Event Reporting
Data (including parameters) are aggregated at the segment level in Data Explorer. Currently there’s not a way to analyze individual user level data via the dashboard. To view your data:

1. In Data Explorer → Add Custom Event
This allows you to select a Custom Event and segment whose data you wish to analyze.

2. In Data Explorer → Add Custom Event → Click View Parameters
This drills down to a specific custom event, allowing you to examine each event parameter.

• For numerical parameters: Count, sums and averages
• For non-numeric parameters (strings and booleans): Count and categorical breakdown

FAQs
1. Where are good places to put custom events?
A few suggestions are when a user passes an important milestone, levels up, or makes an in-app purchase made.

2. How do I review the events that I’ve set up?
There are a couple of methods to view this:

• You can review your events in the event validator (up to the last 50 events). We do have a limit of 10,000 events per project that can be logged in the validator. If for any reason you stop seeing events captured, you've probably hit your cap. Please contact us to reset this.
  
  
• Within Data Explorer, there is an option to "Add Custom Event.” You can view your events in the dropdown menu.

3. Why are my events not showing up in Data Explorer?
If your events show up in the validator, you may need to wait 4-6 hours for the data to process (the validator is instantaneous). Check back to see if your dashboard populates with data.

4. What data can I export using CSV option?
The CSV export option gives (at the segment level) the count, average, and sum of your numeric parameters, and the count for string and boolean parameters.

5. What about export of raw event level data?
Currently this is not available, but it is a feature we’re looking at.

 

Please refer to http://unity3d.com/learn-topic/analytics for additional information.