Definir atributos de usuario en el SDK de iOS

Puedes añadir atributos opcionales como el email, número de teléfono, etc., al usuario de tu app. Luego puedes usar esos atributos para crear segmentos de usuarios o simplemente consultarlos en el CRM.

Definir atributos de usuario

Para definir atributos de usuario, llama al método .updateProfile():

let builder = AdaptyProfileParameters.Builder()
    .with(email: "[email protected]")
    .with(phoneNumber: "+18888888888")
    .with(firstName: "John")
    .with(lastName: "Appleseed")
    .with(gender: .other)
    .with(birthday: Date())
    
do {
    try await Adapty.updateProfile(params: builder.build())
} catch {
    // handle the error
}

let builder = AdaptyProfileParameters.Builder()
    .with(email: "[email protected]")
    .with(phoneNumber: "+18888888888")
    .with(firstName: "John")
    .with(lastName: "Appleseed")
    .with(gender: .other)
    .with(birthday: Date())
    
Adapty.updateProfile(params: builder.build()) { error in
    if error != nil {
        // handle the error                        
    }
}

Ten en cuenta que los atributos que hayas definido previamente con el método updateProfile no se restablecerán.

¿Quieres ver un ejemplo real de cómo se integra el SDK de Adapty en una app móvil? Echa un vistazo a nuestras apps de ejemplo, que muestran la configuración completa, incluyendo la visualización de paywalls, la realización de compras y otras funcionalidades básicas.

Lista de claves permitidas

Las claves <Key> permitidas de AdaptyProfileParameters.Builder y sus valores <Value> correspondientes son:

Clave Valor

Clave	Valor
email phoneNumber firstName lastName	String
gender	Enum, los valores permitidos son: `female`, `male`, `other`
birthday	Date

phoneNumber

firstName

lastName

String

gender Enum, los valores permitidos son: female, male, other

birthday Date

Atributos de usuario personalizados

Puedes definir tus propios atributos personalizados, que normalmente están relacionados con el uso de tu app. Por ejemplo, en apps de fitness pueden ser el número de entrenamientos por semana; en apps de aprendizaje de idiomas, el nivel de conocimiento del usuario, etc. Puedes usarlos en segmentos para crear paywalls y ofertas dirigidas, y también en analíticas para identificar qué métricas de producto influyen más en los ingresos.

do {
     builder = try builder.with(customAttribute: "value1", forKey: "key1")
} catch {
     // handle key/value validation error
}

Para eliminar una clave existente, usa el método .withRemoved(customAttributeForKey:):

do {
     builder = try builder.withRemoved(customAttributeForKey: "key2")
} catch {
     // handle error
}

A veces necesitas saber qué atributos personalizados ya están definidos. Para ello, usa el campo customAttributes del objeto AdaptyProfile.

Ten en cuenta que el valor de customAttributes puede estar desactualizado, ya que los atributos de usuario pueden enviarse desde distintos dispositivos en cualquier momento, por lo que los atributos en el servidor podrían haber cambiado desde la última sincronización.

Límites

Hasta 30 atributos personalizados por usuario.
Los nombres de clave tienen hasta 30 caracteres. El nombre de la clave puede incluir caracteres alfanuméricos y cualquiera de los siguientes: _ - .
El valor puede ser una cadena de texto o un número decimal con un máximo de 50 caracteres.