Установка атрибутов пользователя в Kotlin Multiplatform SDK

Вы можете задавать пользователям приложения необязательные атрибуты: email, номер телефона и т.д. Атрибуты можно использовать для создания сегментов пользователей или просматривать их в CRM.

Установка атрибутов пользователя

Чтобы установить атрибуты пользователя, вызовите метод .updateProfile():


val builder = AdaptyProfileParameters.Builder()
    .withEmail("[email protected]")
    .withPhoneNumber("+18888888888")
    .withFirstName("John")
    .withLastName("Appleseed")
    .withGender(AdaptyProfile.Gender.FEMALE)
    .withBirthday(AdaptyProfile.Date(1970, 1, 3))
  
Adapty.updateProfile(builder.build())
    .onSuccess {
        // profile updated successfully
    }
    .onError { error ->
        // handle the error
    }

Обратите внимание: атрибуты, ранее установленные с помощью метода updateProfile, не сбрасываются.

Хотите увидеть реальный пример интеграции Adapty SDK в мобильное приложение? Посмотрите наши примеры приложений — они демонстрируют полную настройку: отображение пейволов, совершение покупок и другие базовые функции.

Список допустимых ключей

Допустимые ключи <Key> для AdaptyProfileParameters.Builder и соответствующие значения <Value> перечислены ниже:

КлючЗначение

email

phoneNumber

firstName

lastName

String
genderEnum, допустимые значения: AdaptyProfile.Gender.FEMALE, AdaptyProfile.Gender.MALE, AdaptyProfile.Gender.OTHER
birthdayDate

Пользовательские атрибуты

Вы можете задавать собственные пользовательские атрибуты — как правило, они связаны с использованием приложения. Например, для фитнес-приложений это может быть количество тренировок в неделю, для приложений для изучения языков — уровень знаний пользователя и т.д. Их можно использовать в сегментах для создания целевых пейволов и предложений, а также в аналитике для выявления продуктовых метрик, которые сильнее всего влияют на выручку.


val builder = AdaptyProfileParameters.Builder()
builder.withCustomAttribute("key1", "value1")

Чтобы удалить существующий ключ, используйте метод .withRemovedCustomAttribute():


val builder = AdaptyProfileParameters.Builder()
builder.withRemovedCustomAttribute("key2")

Иногда нужно узнать, какие пользовательские атрибуты уже установлены. Для этого используйте поле customAttributes объекта AdaptyProfile.

Имейте в виду, что значение customAttributes может быть устаревшим: атрибуты пользователя могут отправляться с разных устройств в любое время, поэтому данные на сервере могут измениться после последней синхронизации.

Ограничения

  • До 30 пользовательских атрибутов на пользователя
  • Длина имени ключа — до 30 символов. Имя ключа может содержать буквенно-цифровые символы, а также: _ - .
  • Значение может быть строкой или числом с плавающей точкой длиной не более 50 символов.