Android 6.+ migration guide

Upgrading version

Increase the dependency version in your app build.gradle file to upgrade your Qonversion SDK to the latest version

dependencies {    
     implementation ''


In this major version, we have renamed several entities, public methods and changed some packages to make our namings and structure more clear. To make everything work just change all the occurrences from the left column of the table below to the new ones.

Before upgradeAfter upgrade

User properties changes

As mentioned above, we have renamed the QUserProperty enum to QUserPropertyKey. It was made to release the name QUserProperty for a class, containing both the property key and its value. This class will be used in the new Qonversion method userProperties, which will return all the properties set for the current user.

Qonversion.getSharedInstance().userProperties(new QonversionUserPropertiesCallback() {
    public void onSuccess(@NonNull QUserProperties userProperties) {
        for (QUserProperty property : userProperties.getProperties()) {
            Log.d("User property", "Key: " + property.getKey() +
                    ", value: " + property.getValue());

    public void onError(@NonNull QonversionError error) {
        // handle error here
Qonversion.shared.userProperties(object : QonversionUserPropertiesCallback {
  override fun onSuccess(userProperties: QUserProperties) { { 
      Log.d("User property", "key: ${it.key}, value: ${it.value}")

  override fun onError(error: QonversionError) {
    // handle error here

QUserProperties class returned as the successful result of userProperties contains several useful fields and methods to get all the types of properties you may want:

propertiesList of all user properties
definedPropertiesSubset of all user properties, which were set using Qonversion-defined keys
customPropertiesSubset of all user properties, which were set using custom keys
flatPropertiesMapA flattened version of all user properties as a key-value map
flatDefinedPropertiesMapA flattened version of defined user properties as a key-value map
flatCustomPropertiesMapA flattened version of custom user properties as a key-value map
getPropertykey - stringSearches for a property with the given property key in all properties list
getDefinedPropertykey - QUserPropertyKeySearches for a property with the given Qonversion-defined property key in the defined properties list.

The last change here is that we've enriched QUserPropertyKey enum with several values:

  • added a new property key AdvertisingID, which is used on iOS but can be received on Android due to cross-platform user management;
  • added a Custom key to represent all the custom properties.