Manage Segment Fields
Manage Segment Fields is found under Settings → CRM → Manage Segment Fields in the left-hand navigation. It is the central place where you can configure the data attributes available when building player segments in Fast Track CRM.
The page contains three tabs, this article will focus on Segment Fields but you can find more info about the other tabs here:
Segment Fields define what player data points — such as bonus amounts, rounds played, GGR, or deposit counts — are available as filter criteria in the Segment Builder.
Where do Segment Fields come from?
The logic behind segment fields is sourced from the analytics-config repository — specifically the patch and config files configured for each partner. The patch file a partner is using can be confirmed from the OCD analytics-config module. When adding or troubleshooting a field, always verify the field exists and is correctly defined in the relevant patch file before configuring it in the CRM.
Permissions & Access Control
Access to Manage Segment Fields is limited to Users with the following permissions:
| Permission | What it allows |
|---|---|
View | Browse and search the Segment Fields list |
Edit | Modify existing Segment Fields |
Create | Add new Segment Fields |
The Segment Fields List
The Segment Fields tab displays all configured fields in a sortable list with the following columns:
| Column | Description |
|---|---|
Status | A green dot indicates the field is active (Is Enabled). |
Name | The system-level identifier for the field (e.g. bonus_activity-bonus_amount_granted). This is used internally and in integrations. |
Label | The human-readable name shown in the Query Builder (e.g. Bonus Amount Granted). Some fields also show an Alias below the label. |
Description | A brief explanation of what the field represents (e.g. Total Bonus Amount Granted). |
Value Type | The data type of the field, such as double or integer. |
Segments Count | The number of segments currently using this field as a criterion. |
Searching and Sorting
- Use the Search bar (top-right of the list) to filter fields by name or label.
- Click the Name column header to sort the list alphabetically.
Exporting Segment Fields
To export the full list of segment fields, click the Export Segment Fields button in the top-right corner. This downloads the list for reference or auditing purposes.
Creating a New Segment Field
- Click the New Field button in the top-right corner.
- The Segment Field Details panel will open. Complete the fields across two sections: General Details and Query Builder Settings.
- Once all required fields are completed, click Add (top-right of the panel) to save.
General Details
| Field | Description |
|---|---|
Name | The system-level key for the field (uses underscores, no spaces). This is read-only once saved. Should follow the TableName-ColumnName format to ensure correct data mapping (e.g. bonus_activity-bonus_amount_granted). |
Label | The display name shown in the Query Builder (e.g. Bonus Amount Granted). |
Sample Value | An optional example value to help understand what data this field may contain. |
Description | A plain-language explanation of what this field represents (e.g. Total Bonus Amount Granted). |
Field Type | The data type. Select from the dropdown — see Field Types below. |
Is Sensitive Data? | Check this box if the field contains personally identifiable or sensitive player data. |
Is Enabled? | Toggle on to make the field active and available in the Query Builder. |
Tables you must never add fields from:
- Never add fields from the daily_player_activity table. Doing so will cause the database to crash.
- Never add fields from events tables. Doing so will cause the database to crash.
Field Types
When creating a field, the Field Type determines how the data is stored and how it can be filtered in the Query Builder.
| Field Type | Description | Example Use Cases |
|---|---|---|
double | A number with decimal precision | Bonus Amount Granted, GGR, NGR, Total Bets |
integer | A whole number | Bonuses Completed, Rounds Played, Deposit Count |
boolean | A true/false value | Has Made Deposit, Is VIP, Is Opted In |
string | Free text or a fixed text value | Country Code, Player Tag, Promo Code |
date | A calendar date | Registration Date, Last Login Date |
datetime | A date with timestamp | Last Transaction Time, Bonus Activation Time |
array | A list of multiple values | Preferred Game Categories, Opted-In Channels |
mediaurl | A URL pointing to a media asset | Player Avatar, Promotional Banner, Profile Image |
Tip: Use double for any monetary or ratio-based value. Use integer for counts. Choosing the wrong type can limit how the field can be filtered in the Query Builder.
Query Builder Settings
| Field | Description |
|---|---|
Input Type | Determines how the field is presented as a filter in the Query Builder (e.g. Number or ). |
Field Group (optional) | Groups the field under a category in the Query Builder for easier navigation (e.g. 1 - REALTIME FEED). |
Hint | A short tooltip shown to operators when they hover over the field in the Query Builder. |
More Information | A longer description displayed as a paragraph beneath the rule in the Query Builder — useful for providing context about how the field is calculated or sourced. |
Configuring Dropdown Options
When the Input Type in Query Builder Settings is set to Dropdown, an additional Dropdown Options table appears. This allows you to map the raw values sent by the integration to human-readable labels that operators can select when building segments — instead of having to know or type the underlying code.
For example, a language field receiving ISO codes from the integration (fr, es, en) can be mapped to display as French, Spanish, English in the segment builder.
Adding Dropdown Options
- Open the field and set Input Type to Dropdown in the Query Builder Settings section.
- The Dropdown Options table will appear. Click the + button (top-right of the table) to add a new row.
- For each option, complete the following:
| Column | Description |
|---|---|
Value | The raw value as it is sent by the integration (e.g. fr, es, en). This must exactly match what the platform sends. |
Text | The human-readable label displayed to operators in the segment builder (e.g. French, Spanish, English). |
Enabled | Check to make this option selectable. Uncheck to hide it from the segment builder without deleting it. |
Add to Favourites | Click the star icon to pin this option to the top of the dropdown list — useful for frequently used values. |
- Repeat for each value the integration can send.
- To remove an option, click the bin icon on that row.
- Click Update to save all changes.
Tip: The values in the Value column must exactly match what the integration sends. If a value arrives that has no matching dropdown option, it will not be selectable in the segment builder. When in doubt, check the raw values in the analytics-config patch file or confirm via the OCD analytics-config module.
Editing an Existing Segment Field
- In the Segment Fields list, click on the field you want to edit. The Segment Field Details panel will open.
- Review the Segments Count on the list before editing — fields with a count above 0 are in active use.
- Update the desired settings. Note that the Name (system key) is locked and cannot be changed after creation.
- Click Update to save your changes.
Note: Fields actively used in live segments have a Segments Count greater than 0. Modifying or disabling these fields may affect active campaign targeting. Always check the Segments Count before making changes.
Tip: Use the history icon (clock icon, top-right of the panel) to review previous versions of the field configuration.
Enabling or Disabling a Segment Field
- To disable a field without deleting it, open the field and uncheck the Is Enabled? toggle, then click Update. The green status dot will be removed from the list.
- To re-enable a field, toggle Is Enabled? back on and click Update.
Disabling a field removes it from the Query Builder for new segments but does not remove it from segments where it is already in use.