Définir les attributs utilisateur dans le SDK iOS

Vous pouvez définir des attributs optionnels comme l’e-mail, le numéro de téléphone, etc., pour les utilisateurs de votre application. Ces attributs peuvent ensuite être utilisés pour créer des segments d’utilisateurs ou simplement les consulter dans le CRM.

Définir les attributs utilisateur

Pour définir des attributs utilisateur, appelez la méthode .updateProfile() :

let builder = AdaptyProfileParameters.Builder()
    .with(email: "email@email.com")
    .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@email.com")
    .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                        
    }
}

Notez que les attributs définis précédemment via la méthode updateProfile ne seront pas réinitialisés.

Vous souhaitez voir un exemple concret d’intégration du SDK Adapty dans une application mobile ? Consultez nos exemples d’applications, qui illustrent la configuration complète, notamment l’affichage des paywalls, les achats et d’autres fonctionnalités de base.

Liste des clés autorisées

Les clés autorisées <Key> de AdaptyProfileParameters.Builder et les valeurs <Value> correspondantes sont listées ci-dessous :

Clé Valeur

Clé	Valeur
email phoneNumber firstName lastName	String
gender	Enum, valeurs autorisées : `female`, `male`, `other`
birthday	Date

phoneNumber

firstName

lastName

String

gender Enum, valeurs autorisées : female, male, other

birthday Date

Attributs utilisateur personnalisés

Vous pouvez définir vos propres attributs personnalisés, généralement liés à l’utilisation de votre application. Par exemple, pour une application de fitness, il peut s’agir du nombre d’exercices par semaine ; pour une application d’apprentissage des langues, du niveau de connaissance de l’utilisateur, etc. Vous pouvez les utiliser dans des segments pour créer des paywalls et des offres ciblées, et les exploiter dans vos analyses pour identifier quelles métriques produit influencent le plus les revenus.

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

Pour supprimer une clé existante, utilisez la méthode .withRemoved(customAttributeForKey:) :

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

Il peut arriver que vous ayez besoin de consulter les attributs personnalisés déjà définis. Pour cela, utilisez le champ customAttributes de l’objet AdaptyProfile.

Gardez à l’esprit que la valeur de customAttributes peut ne pas être à jour, car les attributs utilisateur peuvent être envoyés depuis différents appareils à tout moment — les attributs côté serveur ont donc pu changer depuis la dernière synchronisation.

Limites

Jusqu’à 30 attributs personnalisés par utilisateur
Les noms de clés peuvent comporter jusqu’à 30 caractères. Ils peuvent contenir des caractères alphanumériques ainsi que les caractères suivants : _ - .
La valeur peut être une chaîne de caractères ou un nombre décimal, avec 50 caractères maximum.