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 của mình. 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 đơn giản là xem chúng trong CRM.

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

Để thiết lập thuộc tính người dùng, gọi phương thức .updateProfile():

// Only for TypeScript validation

const params: AdaptyProfileParameters = {
    email: '[email protected]',
    phoneNumber: '+18888888888',
    firstName: 'John',
    lastName: 'Appleseed',
    gender: 'other',
    birthday: new Date().toISOString(),
};

try {
    await adapty.updateProfile(params);
} catch (error) {
    // handle `AdaptyError`
}

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

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
email phoneNumber firstName lastName	String
gender	Enum, các giá trị cho phép là: female, male, other
birthday	Date

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

Bạn có thể thiết lập các thuộc tính tùy chỉnh của riêng mình. Những thuộc tính này thường liên quan đến cách sử dụng ứng dụng. Ví dụ, với ứng dụng thể dục, chúng có thể là số buổi tập mỗi tuần; với ứng dụng học ngôn ngữ, chú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 có mục tiêu, đồng thời dùng trong analytics để tìm ra chỉ số sản phẩm nào ảnh hưởng nhiều nhất đến doanh thu.

try {
  await adapty.updateProfile({
    codableCustomAttributes: {
      key_1: 'value_1',
      key_2: 2,
    },
  });
} catch (error) {
    // handle `AdaptyError`
}

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

try {
  // to remove a key, pass null as its value
  await adapty.updateProfile({
    codableCustomAttributes: {
      key_1: null,
      key_2: null,
    },
  });
} catch (error) {
    // handle `AdaptyError`
}

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

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 dài 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 bất kỳ ký tự nào sau đây: _ - .
• Giá trị có thể là chuỗi hoặc số thực (float) với tối đa 50 ký tự.