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

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

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

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

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

AdaptyProfileParameters.Builder builder = new AdaptyProfileParameters.Builder()
    .withEmail("[email protected]")
    .withPhoneNumber("+18888888888")
    .withFirstName("John")
    .withLastName("Appleseed")
    .withGender(AdaptyProfile.Gender.OTHER)
    .withBirthday(new AdaptyProfile.Date(1970, 1, 3));

Adapty.updateProfile(builder.build(), error -> {
    if (error != null) {
        // handle the error
    }
});

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

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

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

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

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

Ключ	Значение
email phoneNumber firstName lastName	String
gender	Enum, допустимые значения: `female`, `male`, `other`
birthday	Date

phoneNumber

firstName

lastName

String

gender Enum, допустимые значения: female, male, other

birthday Date

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

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

builder.withCustomAttribute("key1", "value1")

builder.withCustomAttribute("key1", "value1");

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

builder.withRemovedCustomAttribute("key2")

builder.withRemovedCustomAttribute("key2");

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

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

Ограничения

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