Setting Custom Data

Set custom user data, attributes, tags, and app variant in KMP.

User data (free-form string)

Attach a custom string to reports (e.g. JSON or key-value text):

Kotlin

LuciqKmp.setUserData("{\"plan\":\"premium\",\"region\":\"EU\"}")

User attributes

Set key-value attributes that appear in the dashboard and on reports:

Kotlin

LuciqKmp.setUserAttribute("plan", "premium")
LuciqKmp.setUserAttribute("role", "admin")
val value = LuciqKmp.getUserAttribute("plan")           // suspend
val all = LuciqKmp.getAllUserAttributes()             // suspend
LuciqKmp.removeUserAttribute("role")
LuciqKmp.clearAllUserAttributes()

User events

Log custom events (e.g. for analytics or filtering):

Kotlin

LuciqKmp.logUserEvent("purchase_completed")

Tags

Append tags to bug reports for filtering and segmentation:

Kotlin

LuciqKmp.appendTags(listOf("beta", "v2"))
val tags = LuciqKmp.getTags()  // suspend
LuciqKmp.resetTags()

App variant

Set the app variant (e.g. "beta", "production") for filtering in the dashboard. You can also set it in LuciqConfiguration at init:

Kotlin

LuciqKmp.setAppVariant("staging")

Note: On some platforms this may be primarily set at init; check behavior per platform.

File attachments

Add file attachments to bug reports (e.g. logs or exports). You can add by file path or from in-memory data, and clear the list when needed:

Kotlin

LuciqKmp.addFileAttachment(path = "/path/to/log.txt", name = "log.txt")
LuciqKmp.addFileAttachmentWithData(data = bytes, fileName = "export.json")
LuciqKmp.clearFileAttachments()

Attachments added this way are included in the next report the user submits.

Feature flags

Add or remove feature flags (for A/B or segment filtering):

Kotlin

LuciqKmp.addFeatureFlag(FeatureFlag(name = "new_checkout", variant = "on"))
LuciqKmp.addFeatureFlags(listOf(FeatureFlag("flag_a", "control"), FeatureFlag("flag_b", "test")))
LuciqKmp.removeFeatureFlag("new_checkout")
LuciqKmp.removeFeatureFlags(listOf("flag_a", "flag_b"))
LuciqKmp.removeAllFeatureFlags()