Définir les attributs utilisateur dans le SDK Unity

Vous pouvez définir des attributs facultatifs tels que l’e-mail, le numéro de téléphone, etc., pour les utilisateurs de votre app. Vous pouvez ensuite utiliser ces attributs pour créer des segments d’utilisateurs ou simplement les consulter dans le CRM.

Définir les attributs utilisateur

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

var builder = new Adapty.ProfileParameters.Builder()
        .SetFirstName("John")
        .SetLastName("Appleseed")
        .SetBirthday(new DateTime(1970, 1, 3))
        .SetGender(ProfileGender.Female)
        .SetEmail("example@adapty.io");

Adapty.UpdateProfile(builder.Build(), (error) => {
    if(error != nil) {
        // handle the error                        
    }
});

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

Tip

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

La liste des clés autorisées

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

Clé Valeur

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

phoneNumber

firstName

lastName

String

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

birthday Date

Attributs utilisateur personnalisés

Vous pouvez définir vos propres attributs personnalisés. Ceux-ci sont généralement liés à l’utilisation de votre application. Par exemple, pour les applications 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és, et vous pouvez également les utiliser dans les analyses pour déterminer quelles métriques produit influencent le plus les revenus.

try {
    builder = builder.SetCustomStringAttribute("string_key", "string_value");
    builder = builder.SetCustomDoubleAttribute("double_key", 123.0f);
} catch (Exception e) {
    // handle the exception
}

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

try {
    builder = builder.RemoveCustomAttribute("key_to_remove");
} catch (Exception e) {
    // handle the exception
}

Parfois, vous avez besoin de savoir quels attributs personnalisés ont déjà été définis. Pour cela, utilisez le champ customAttributes de l’objet AdaptyProfile.

Warning

Gardez à l’esprit que la valeur de customAttributes peut être obsolète, car les attributs utilisateur peuvent être envoyés depuis différents appareils à tout moment — les attributs sur le serveur ont donc pu changer depuis la dernière synchronisation.

Limites

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