FireEvent
Deprecated
This function has been deprecated in favor of more descriptive methods, including:
AnalyticsService/FireCustomEventAnalyticsService/FireInGameEconomyEventAnalyticsService/FireLogEventAnalyticsService/FirePlayerProgressionEvent
Unsafe
For thread safety, this property is not safe to read in an unsynchronized thread.
FireEvent reports a custom event to PlayFab. The event is reported using a category and value, where the category is a string and the value can be a string or table. In order to use PlayFab, you must have a valid AnalyticsService/ApiKey|ApiKey set.
Possible Errors
- “AnalyticsService can only be executed by game server.” – Tracking can only be done on the server through a
ScriptorModuleScriptrequired by a script. SeeRunService/IsServer. - “The ApiKey is invalid.” – The
AnalyticsService/ApiKey|ApiKeyhas been set, but it’s invalid. Check that it is set to the correct value. - “AnalyticsService can only accept valid UTF-8 characters.” – Thrown when the value can’t be serialized as UTF-8 characters. This can happen if you pass a value which has unicode characters, like emojis.
- “AnalyticsService failed in parse event value. Error: …” – Thrown when there is an issue when serializing the provided value into a string.
- “AnalyticsService: , " and \r\n are not allowed in category.” – The comma
,, the double quote", and newline characters\r\ncannot be used in the category parameter. - “AnalyticsService: The event value you fired is too long.” – Thrown if the value parameter was too long after serialization. The length limit is 1 KB, or 1024 bytes.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
|
|
The category of event to report. Cannot contain the following characters: comma |
||
|
|
A value to be serialized and reported. Serialized length must not exceed 1 KB, or 1024 bytes |
Returns
| Return Type | Summary |
|---|---|
|
No return |