User Identity APIs in Mobile SDKs

This guide covers the user identity APIs that help you retrieve the following parameters persisted by the Kotlin and Swift SDKs:

• User ID
• Anonymous ID
• User traits

Fetch user ID

The Kotlin and Swift SDKs assign a unique userId when an identify event is triggered. This parameter uniquely identifies a user within the database after they log in or sign up.

The following sections highlight how to obtain the user’s userId in the Kotlin and Swift SDKs.

Kotlin

val userId = analytics.userId

String userId = analytics.getUserId();

Swift

let userId = analytics.userId

NSString* userId = self.analytics.userId;

The above snippets return the following information:

Fetch anonymous ID

anonymousId is a unique identifier automatically generated by the SDK to track unidentified users, for example, users before they log in or sign up. This ID persists across sessions and allows tracking user behavior before they are identified explicitly.

The following sections highlight how to obtain the user’s anonymousId in the Kotlin and Swift SDKs.

Kotlin

val anonymousId = analytics.anonymousId

String anonymousId = analytics.getAnonymousId();

Swift

let anonymousId = analytics.anonymousId

NSString* anonymousId = self.analytics.anonymousId;

The above snippets return the following information:

Fetch user traits

The Kotlin and Swift SDKs use the traits object to store any additional user attributes, for example, name, email, custom properties, etc. associated with an identify event. These traits allow for richer user profiling and segmentation.

The following sections highlight how to obtain the user traits in the Kotlin and Swift SDKs.

Kotlin

val traits = analytics.traits

Map<String, Object> traits = analytics.getTraits();

Swift

let traits = analytics.traits

NSDictionary *traits = self.analytics.traits;

The above snippets return the following information:

Questions? Contact us by email or on Slack