Send Events and Properties
You can send events and events' properties to UXCam to gather more insights about your users' behavior. It will help you to:
- Create more granular funnels thanks to the combination of Events and Screens.
- Follow your user journey closely by analyzing all the relevant steps.
- Easily identify errors in your user journey or conversion process.
- Track each step of your registration process to easily identify drop-offs.
- Measure and analyze the adoption of new features.
E.g You have an app to book movie tickets. You’re sending the Event ‘ticket_booked,’ you can then attach several properties to the event to provide more context to that event, such as: ‘Movie_Category’, ‘Movie_Name’, ‘Movie_Time’, ‘Quantity’, ‘Price’, etc.
Need some inspiration? Check this article to find some Events ideas →
All the events will be attached to the respective sessions and users; therefore, you can easily use filters to find sessions or users that triggered a specific event. What’s more, you can analyze your events with Event Analytics or use them to build funnels.
Note: UXCam automatically detects UI Freezes and Rage taps and logs them as an event; for example, Rage taps are registered as "Rage Tap" events.
Log Events
Log an event into the timeline along with custom properties
logEvent(_ eventName: String)
logEvent(_ eventName: String, withProperties properties: [String: Any]?)
//Example
UXCam.logEvent("purchased")
UXCam.logEvent("purchased",withProperties: [
"size": 7,
"brand": "Nike"
])
logEvent(String eventName)
logEvent(String eventName, Map properties)
logEvent(String eventName, JSONObject properties)
//Example
UXCam.logEvent("purchased");
//With properties
final Map<String, String> properties = new HashMap<String!, Any!>();
properties.put("size", "7");
properties.put("brand", "Nike");
UXCam.logEvent("purchased", properties);
RNUxcam.logEvent: (eventName: string, properties?: any) => void
//Example
RNUxcam.logEvent("purchased");
RNUxcam.logEvent("purchased", {
"size": 7,
"brand": "Nike"
});
logEvent(String eventName)
logEventWithProperties(String eventName, Map<String, dynamic> properties)
//Example
FlutterUxcam.logEvent("purchased");
FlutterUxcam.logEventWithProperties("purchased", {
"size": 7,
"brand": "Nike"
});
void UXCam.LogEvent(string eventName)
void UXCam.LogEvent(string eventName, JSONObject properties) //Android
void UXCam.LogEvent(string eventName, NSObject properties) //iOS
UXCam.logEvent: (eventName: string) => void
UXCam.logEventWithProperties: (eventName: string, properties: any) => void
//Example
UXCam.logEvent("purchased")
UXCam.logEventWithProperties("purchased", {
"size": 7,
"brand": "Nike"
});
The API parameters are:
eventName: A tag to attach to the session recording at the current time
properties: (Optional) A Dictionary of properties to associate with this event. Only number and string property types are supported.
Tips on Sending Dates as Event Properties:
In terms of the date formats, there are many options that will work, but generally we would recommend to use the UTC time format (‘YYYY-MM-DDTHH:MM:SSZ’) or either of the following options:
‘YYYY-MM-DD HH-MM-SS’
‘YYYY/MM/DD HH-MM-SS’
‘YYYY-MM-DD’
‘YYYY/MM/DD’
‘YYYY’.
The separators you use don’t matter as long as they are consistent. For instance if you compare ‘YYYY/MM’ to ‘YYYY-MM’ you will get sensible results.
Alternatively, you can just attach the Unix time (seconds since 1970), and then use simple integer comparison https://www.utctime.net/utc-timestamp which will work already.
Updated about 1 month ago