User Properties

Set custom user properties

User properties are attributes you can set on a user level. You can send user properties to third-party platforms and use them in Qonversion for customer segmentation and analytics.
Here is an example of user properties:


User Properties


There are two types of user properties: Qonversion-defined and custom user properties.

Defined User Properties

We defined some common case properties and provided API for adding them:

Qonversion.shared().setProperty(.email, value: "[email protected]")
[[Qonversion sharedInstance] setProperty:QONPropertyEmail value:@"[email protected]"];
Qonversion.getSharedInstance().setProperty(QUserProperty.Email, "[email protected]");
Qonversion.shared.setProperty(QUserProperty.Email, "[email protected]")
Qonversion.getSharedInstance().setProperty(, '[email protected]');
Qonversion.getSharedInstance().setProperty(UserProperty.EMAIL, '[email protected]');
Qonversion.GetSharedInstance().SetProperty(UserProperty.Email, "[email protected]");

The full list of the defined properties is provided below:

Email_q_emailUser Email. It can be used for cross-platform authorization and integrations with Qonversion.
Name_q_nameUser Name
KochavaDeviceId_q_kochava_device_idKochava Unique Device ID
AppsFlyerUserId_q_appsflyer_user_idCustomer user ID. It can be used to cross-reference your in-house data with AppsFlyer attribution data.
AdjustAdId_q_adjust_adidAdjust Advertising ID
CustomUserId_q_custom_user_idInternal User ID in your backend
FacebookAttribution_q_fb_attributionMobile Cookie from the user's device
FirebaseAppInstanceId_q_firebase_instance_idThe identifier for a Firebase app
AppSetId_q_app_set_idUnique user identifier for all the developer's applications on Android

Custom User Properties

Additionally, you can add custom user property. Qonversion can send them to third-party integrations as well. For example, you can add user details and use that data to send personalized emails or push notifications via Mailchimp and OneSignal integrations.

Qonversion.shared().setUserProperty("liked-app", value: "yes")
[[Qonversion sharedInstance] setUserProperty: @"liked-app" value: @"yes"];
Qonversion.getSharedInstance().setUserProperty("liked-app", "yes");
Qonversion.shared.setUserProperty("liked-app", "yes")
Qonversion.getSharedInstance().setUserProperty('liked-app', 'yes');
Qonversion.getSharedInstance().setUserProperty('liked-app', 'yes');
Qonversion.GetSharedInstance().SetUserProperty("liked-app", "yes");

You can use letters A-Za-z, numbers, and the following symbols _.:- as a property key.


Property setting order

To successfully set either Defined or Custom User Properties, launch Qonversion SDK first. Learn more.