Custom Event Fields
Custom event fields allow you to enrich events with additional data points beyond the standard schemas. These fields are especially useful when you need to send highly granular, dynamic or numeric information that isn’t suitable for Custom Dimensions.
Common use cases:
- Sending numeric values like player score, XP gained or currency earned
- Capturing specific item names, types or IDs beyond the event schema fields
- Tracking in-game choices or user settings (e.g. audio levels, difficulty modes)
- Recording detailed metadata from custom game systems
info
Custom event fields are not displayed in the AnalyticsIQ web-tool. Instead, you can access and analyze them exclusively through PipelineIQ’s Data Warehouse and Data Export features.
| Platform / Feature | Appearance | Notes |
|---|---|---|
| Data export | Appears as a field in the exported raw files (JSON or Parquet), attached to sent events. E.g: A Progression event that includes Custom Event Fields will display them attached to the event: Custom_fields{red,blue,yellow etc…} | Full access to all fields |
| Data Warehouse | Part of every event table, with the field name custom_fields. | Queryable via SQL |
| Metrics API | Not available to query | |
| Analytics IQ UI | Not visible in standard filter | Only Event Dimensions (defined through the event schemas) and Custom Dimensions can be used for filtering and grouping in the GameAnalytics UI |
How to send Custom Event Fields
Custom event fields are sent in dictionary format, as key-value pairs, and each event can include up to 50 of these pairs.
info
Refer to the SDK Documentation for code examples specific to your platform (Unity, Unreal, Roblox, iOS, Android, etc.).