User Events

Configure user event tracking in your iOS app with Luciq. Log custom user actions and events to get richer context in bug reports and crash data.

You can log custom user events throughout your application. Custom events are automatically included with each report.

Swift

Luciq.logUserEvent(withName: "Skipped Walkthrough")

Objective-C

[Luciq logUserEventWithName:@"Skipped Walkthrough"];

Logging User Events with Parameters

Starting from SDK version 19.8.0, you can attach key-value parameters to a user event to capture additional context. Pass an array of UserEventParam instances alongside the event name.

Swift

Luciq.logUserEvent(withName: "Completed Purchase", parameters: [
    UserEventParam(key: "item", value: "Premium Plan"),
    UserEventParam(key: "currency", value: "USD")
])

Objective-C

[Luciq logUserEventWithName:@"Completed Purchase" parameters:@[
    [[LCQUserEventParam alloc] initWithKey:@"item" value:@"Premium Plan"],
    [[LCQUserEventParam alloc] initWithKey:@"currency" value:@"USD"]
]];

Scope and behavior

• Keys are limited to 50 characters and values to 200 characters. Entries that are empty, exceed these limits, or repeat a key already added are dropped with a console error.
• Up to 15 parameters can be attached to an event by default. Reach out to Luciq support if your account needs a higher limit.
• Logging additional parameters for the same event name merges them into the existing set using first-wins semantics — an earlier value for a key is kept and the new value is dropped — and the merged set is still capped at the configured limit.