Note: Gaming Services Analytics is now available as a preview packageA preview package is in development and not yet ready for production. A package in preview might be at any stage of development, from the initial stages to near completion.
See in Glossary. Gaming Services AnalyticsAbbreviation of Unity Analytics
See in Glossary is an improved offering that allows you to easily understand game performance and player behaviors so you can make strategic decisions. Check out the documentation.
To maintain an efficient and responsive service, Analytics imposes limits on the Standard and Custom Events a given instance of your game or application can send. These limits include:
All of the AnalyticsEvent functions that send events, return a value from the AnalyticsResult enumeration. If an application exceeds one of the limits, the AnalyticsResult
value identifies the specific error encountered:
AnalyticsResult |
Limit Exceeded |
---|---|
AnalyticsResult.TooManyRequests |
100 events per hour |
AnalyticsResult.TooManyItems |
10 parameters per event |
AnalyticsResult.SizeLimitReached |
500 bytes of data or 100 characters in the event name |
Note: The 100 events per instance limit is a default that suits the majority of Unity AnalyticsA data platform that provides analytics for your Unity game. More info
See in Glossary users. If you need a higher event limit for a game or application, contact the Analytics support team to work out a limit suitable to your requirements.
You can send up to 500 characters or bytes of data as part of a single Custom or Standard EventStandard events are application-specific events that you dispatch in response to important player actions or milestones. Standard events have standardized names and defined parameter lists. More info
See in Glossary. This limit counts the combined string lengths of all the parameter names and the following sizes for parameter values (depending on data type):
C# Data Type | Size |
---|---|
byte, ubyte | 1 |
short, ushort | 4 (converted to int) |
Int, uint | 4 |
long, ulong | 8 |
float | 8 (converted to double) |
double | 8 |
decimal | 8 (converted to double) |
string | String length |
object | String length after calling ToString()
|
For example, the following event uses 67 bytes/characters of the data length limit:
Dictionary<string, object> data = new Dictionary<string, object>();
data.Add("int_param", 32); // 9 characters + 4 bytes
data.Add("bool_param", true); // 10 characters + 1 byte
data.Add("float_param", 3.3f); // 11 characters + 8 bytes
data.Add("string_param", "String value"); // 12 characters + 12 characters
AnalyticsResult result = AnalyticsEvent.Custom("custom_event", data);
When you send a Standard Event that defines its own required or optional parameters, the lengths of names and values of the required parameters, and those of any optional parameters, are included in the 500 byte limit, along with any custom data.
The length of the name of an event itself cannot exceed 100 characters in length, but this length is not counted against the 500 byte limit for the event data.