If you use an analytics tool, you likely track custom events to measure your users' in-app behavior. Use the Custom Events API to make these events accessible in LogRocket.
LROCustomEventBuilder *builder = [[LROCustomEventBuilder alloc] init:@"Registered"]; [LROSDK track:builder];
You can then search for sessions containing these events using a Custom Event filter in the LogRocket Dashboard:
You can optionally provide additional properties that will be associated with the event:
let builder = CustomEventBuilder("PurchaseComplete") builder.put("revenue", 24.99) builder.put("productCategory", "Clothing") builder.put("productSku", 488736929) builder.put("couponApplied", true) builder.put("customerSegments", ["aef34b", "97cb20"]) // Register multiple values with one call SDK.track(builder) // Capture the event
LROCustomEventBuilder *builder = [[LROCustomEventBuilder alloc] init:@"PurchaseComplete"]; [builder putDouble:@"revenue" value:24.99]; [builder putString:@"productCategory" value:@"Clothing"]; [builder putDouble:@"productSku" value:488736929]; [builder putBool:@"couponApplied" value:true]; [builder putStringArray:@"customerSegments" value:[NSArray arrayWithObjects:@"aef34b", @"97cb20",nil]]; [LROSDK track:builder];
Properties may be of type boolean, double, or string. Arrays of primitives (boolean, double, or string) are also supported.
There are a few limits to keep in mind when providing properties to Custom Events:
- Property names must be under 100 characters.
- A maximum of 500 properties may be uploaded per session. Properties over this limit will not be recorded.
The 'revenue' property is a special property that you can use to pass data into our funnels. For more information, see here.