Задание атрибутов пользователя в Flutter SDK

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

Задание атрибутов пользователя

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

final builder = AdaptyProfileParametersBuilder()
  ..setEmail("[email protected]")
  ..setPhoneNumber("+18888888888")
  ..setFirstName('John')
  ..setLastName('Appleseed')
  ..setGender(AdaptyProfileGender.other)
  ..setBirthday(DateTime(1970, 1, 3));

try {
  await Adapty().updateProfile(builder.build());
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

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

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

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

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

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

email

phoneNumber

firstName

lastName

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

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

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

try {
  final builder = AdaptyProfileParametersBuilder()
      ..setCustomStringAttribute('value1', 'key1')
      ..setCustomDoubleAttribute(1.0, 'key2');

await Adapty().updateProfile(builder.build());
} on AdaptyError catch (adaptyError) {
// handle the error
} catch (e) {
}

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

try {
  final builder = AdaptyProfileParametersBuilder()
    ..removeCustomAttribute('key1')
    ..removeCustomAttribute('key2');

await Adapty().updateProfile(builder.build());
} on AdaptyError catch (adaptyError) {
// handle the error
} catch (e) {
}

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

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

Ограничения

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