Identifier les utilisateurs dans le SDK Unity

Adapty crée un identifiant de profil interne pour chaque utilisateur. Cependant, si vous avez votre propre système d’authentification, vous devriez définir votre propre Customer User ID. Vous pouvez retrouver les utilisateurs par leur Customer User ID dans la section Profils et l’utiliser dans l’API côté serveur, qui sera envoyé à toutes les intégrations.

Définir l’identifiant utilisateur lors de la configuration

Si vous disposez d’un identifiant utilisateur au moment de la configuration, passez-le simplement comme paramètre customerUserId à la méthode .activate() :

using UnityEngine;
using AdaptySDK;

var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
    .SetCustomerUserId("YOUR_USER_ID");

Adapty.Activate(builder.Build(), (error) => {
    if (error != null) {
        // handle the error
        return;
    }
}); 

Définir l’identifiant utilisateur après la configuration

Si vous n’avez pas d’identifiant utilisateur lors de la configuration du SDK, vous pouvez le définir ultérieurement à tout moment avec la méthode .identify(). Les cas les plus courants pour utiliser cette méthode sont après l’inscription ou la connexion, lorsque l’utilisateur passe du statut d’utilisateur anonyme à celui d’utilisateur authentifié.

Adapty.Identify("YOUR_USER_ID", (error) => {
  if(error == null) {
    // successful identify
  }
});

Paramètres de la requête :

• Customer User ID (requis) : un identifiant utilisateur sous forme de chaîne de caractères.

Déconnexion et connexion

Vous pouvez déconnecter l’utilisateur à tout moment en appelant la méthode .logout() :

Adapty.Logout((error) => {
  if(error == null) {
    // successful logout
  }
});

Vous pouvez ensuite connecter l’utilisateur avec la méthode .identify().

Assigner appAccountToken (iOS)

appAccountToken est un UUID qui vous permet de lier les transactions App Store à l’identité interne de vos utilisateurs.
StoreKit associe ce token à chaque transaction, ce qui permet à votre backend de faire correspondre les données App Store à vos utilisateurs.

Utilisez un UUID stable généré par utilisateur et réutilisez-le pour le même compte sur tous les appareils. Cela garantit que les achats et les notifications App Store restent correctement liés.

Vous pouvez définir le token de deux façons : lors de l’activation du SDK ou lors de l’identification de l’utilisateur.

using UnityEngine;
using AdaptySDK;
using System;

// During configuration:
var appAccountToken = new Guid("YOUR_APP_ACCOUNT_TOKEN");
var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
    .SetCustomerUserId("YOUR_USER_ID", appAccountToken);

Adapty.Activate(builder.Build(), (error) => {
    if (error != null) {
        // handle the error
        return;
    }
}); 

// Or when identifying users
Adapty.Identify("YOUR_USER_ID", appAccountToken, (error) => {
    if (error == null) {
        // successful identify
    }
});

Définir des identifiants de compte obfusqués (Android)

Google Play exige des identifiants de compte obfusqués dans certains cas d’usage pour renforcer la confidentialité et la sécurité des utilisateurs. Ces identifiants permettent à Google Play d’associer les achats à un compte tout en maintenant l’anonymat des données utilisateur — ce qui est particulièrement important pour la prévention des fraudes et l’analyse.

Vous aurez peut-être besoin de définir ces identifiants si votre application traite des données utilisateur sensibles ou si vous devez vous conformer à des réglementations spécifiques en matière de confidentialité. Les identifiants obfusqués permettent à Google Play de suivre les achats sans exposer les identifiants réels des utilisateurs.

using UnityEngine;
using AdaptySDK;

// During configuration:
var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
    .SetCustomerUserId("YOUR_USER_ID", null, "YOUR_OBFUSCATED_ACCOUNT_ID");

Adapty.Activate(builder.Build(), (error) => {
    if (error != null) {
        // handle the error
        return;
    }
});

// Or when identifying users
Adapty.Identify("YOUR_USER_ID", null, "YOUR_OBFUSCATED_ACCOUNT_ID", (error) => {
    if (error == null) {
        // successful identify
    }
});

Détecter les utilisateurs sur plusieurs appareils

Lors de l’activation du SDK, il lit automatiquement les droits existants de l’utilisateur depuis StoreKit (iOS) ou Google Play Billing (Android) et les synchronise avec le backend Adapty. Un abonnement actif apparaît sur le profil Adapty sans que l’application n’appelle restorePurchases.

Ce qui ne se produit pas automatiquement, c’est la reconnaissance qu’un profil sur un nouvel appareil appartient au même utilisateur que le profil sur l’appareil d’origine. Adapty fait correspondre les profils par Customer User ID, donc la continuité d’identité dépend de ce que vous utilisez comme CUID.

Ce qu’Adapty peut détecter entre les appareils

Restaurer les achats sur un nouvel appareil

Proposez un bouton « Restaurer les achats » initié par l’utilisateur sur votre paywall. Les directives App Review d’Apple (règle 3.1.1) l’exigent, et il sert de solution de secours quand la synchronisation automatique rate un cas limite. Ce bouton doit appeler restorePurchases dans votre SDK.

Un appel programmatique à restorePurchases au premier lancement n’est pas nécessaire pour une utilisation normale — le SDK effectue déjà l’équivalent lors de l’appel activate(). Réservez les appels programmatiques pour forcer une vérification fraîche du reçu, par exemple lors du débogage d’un accès manquant après la fin de activate().