Custom events
In the Custom events tab, you can track what activities your customers perform online. The custom events you create here will be used in your other features.
If you want to get started quickly with common scenarios, see Template events.
In the Custom events tab, you can:
- Search for events - Use the search bar to find specific events by name
- Create events - Select Create event to define new custom events
- View event details - See the event table with the following information:
- Event name - The display name of the event
- Event ID - The unique identifier used for tracking
- Event properties - Additional data associated with the event
Create a custom event
To create a custom event:
- Go to Customer Profiles → Events → Custom events tab.
- Select Create event.
- Enter the event name and event ID.
- Define event properties if needed.
- Select Create.
Event properties should start with a lowercase letter. Event properties provide additional context about the event, such as itemName, price, or category.
Event property data types
Each event property must have a data type. Select the appropriate type when you define the property.
| Data type | Description | Specifications |
|---|---|---|
| Text | Text format properties (for example, productName, productDescription). | Max 1,500 characters. |
| True/False | Boolean properties — True or False values. | — |
| Date | Date values. | ISO-8601 format. |
| Number | Numeric format — decimal or integer (for example, productPrice). | — |
| List | Add a list as a property. Use to pass structured data such as shopping cart items with fields like item name, ID, quantity, and price. | Max 1 List property per event. Max 128 fields per List. |
Property naming rules
Event property names have the following requirements:
- Must be alphanumeric.
- Must start with a lowercase letter.
- Max 128 characters.
Mobile SDK does not support tracking list properties in events.
For more information about event naming and best practices, see Events best practices. To track events on your website, see Web SDK.