Thiết lập thuộc tính người dùng trong Flutter SDK

Bạn có thể thiết lập các thuộc tính tùy chọn như email, số điện thoại, v.v. cho người dùng ứng dụng. Sau đó, bạn có thể dùng các thuộc tính này để tạo phân khúc người dùng hoặc chỉ đơn giản là xem chúng trong CRM.

Cài đặt thuộc tính người dùng

Để cài đặt thuộc tính người dùng, gọi phương thức .updateProfile():

final builder = AdaptyProfileParametersBuilder()
  ..setEmail("email@email.com")
  ..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) {
}

Xin lưu ý rằng các thuộc tính bạn đã đặt trước đó bằng phương thức updateProfile sẽ không bị xóa.

Muốn xem ví dụ thực tế về cách tích hợp Adapty SDK vào ứng dụng di động? Hãy xem ứng dụng mẫu của chúng tôi, nơi minh họa toàn bộ quá trình thiết lập, bao gồm hiển thị paywall, thực hiện mua hàng và các chức năng cơ bản khác.

Danh sách các key được phép

Các key <Key> được phép của AdaptyProfileParameters.Builder và các giá trị <Value> tương ứng được liệt kê bên dưới:

Key Value

Key	Value
email phoneNumber firstName lastName	String
gender	Enum, các giá trị cho phép: `female`, `male`, `other`
birthday	Date

phoneNumber

firstName

lastName

String

gender Enum, các giá trị cho phép: female, male, other

birthday Date

Thuộc tính người dùng tùy chỉnh

Bạn có thể tự thiết lập các thuộc tính tùy chỉnh cho người dùng. Những thuộc tính này thường liên quan đến cách người dùng sử dụng ứng dụng của bạn. Ví dụ, với ứng dụng thể dục, đó có thể là số buổi tập mỗi tuần; với ứng dụng học ngoại ngữ, đó có thể là trình độ kiến thức của người dùng, v.v. Bạn có thể dùng chúng trong các phân khúc để tạo paywall và ưu đãi nhắm mục tiêu, đồng thời cũng có thể dùng trong analytics để xác định những chỉ số sản phẩm nào ảnh hưởng nhiều nhất đến doanh thu.

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) {
}

Để xóa key hiện có, sử dụng phương thức .withRemoved(customAttributeForKey:):

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

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

Đôi khi bạn cần biết những thuộc tính tùy chỉnh nào đã được cài đặt trước đó. Để làm điều này, hãy sử dụng trường customAttributes của đối tượng AdaptyProfile.

Lưu ý rằng giá trị của customAttributes có thể không còn cập nhật, vì các thuộc tính người dùng có thể được gửi từ nhiều thiết bị khác nhau vào bất kỳ lúc nào, do đó các thuộc tính trên server có thể đã thay đổi sau lần đồng bộ cuối cùng.

Giới hạn

Tối đa 30 thuộc tính tùy chỉnh mỗi người dùng
Tên key tối đa 30 ký tự. Tên key có thể bao gồm các ký tự chữ và số, cùng với các ký tự sau: _ - .
Giá trị có thể là chuỗi hoặc số thực (float) với tối đa 50 ký tự.