Identifier les utilisateurs dans Flutter SDK

Adapty crée un ID de profil interne pour chaque utilisateur. Cependant, si vous disposez de votre propre système d’authentification, vous devez 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 server-side, qui sera transmis à 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() :

   try {
       await Adapty().activate(
           configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
             ..withCustomerUserId(YOUR_CUSTOMER_USER_ID)
       );
   } catch (e) {
       // handle the error
   }

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 d’usage les plus courants pour cette méthode sont après l’inscription ou la connexion, lorsque l’utilisateur passe du statut d’utilisateur anonyme à celui d’utilisateur authentifié.

try {
  await Adapty().identify(customerUserId);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

Paramètres de la requête :

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

Déconnexion et reconnexion

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

try {
  await Adapty().logout();
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle unknown error
}

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

Assigner l’appAccountToken (iOS)

appAccountToken est un UUID qui vous permet de relier 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 associé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.

// During configuration:
try {
   await Adapty().activate(
       configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
         ..withCustomerUserId(YOUR_CUSTOMER_USER_ID, iosAppAccountToken: "YOUR_APP_ACCOUNT_TOKEN")
   );
} catch (e) {
   // handle the error
}
// Or when identifying users
try {
    await Adapty().identify(customerUserId, iosAppAccountToken: "YOUR_APP_ACCOUNT_TOKEN");
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
}

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

Google Play exige des identifiants de compte obfusqués dans certains cas afin de renforcer la confidentialité et la sécurité des utilisateurs. Ces identifiants permettent à Google Play d’identifier les achats tout en préservant l’anonymat des informations utilisateur, ce qui est particulièrement important pour la prévention de la fraude et l’analyse.

Vous devrez peut-être définir ces identifiants si votre application gère des données utilisateur sensibles ou si vous êtes tenu de respecter des réglementations spécifiques en matière de confidentialité. Les identifiants obfusqués permettent à Google Play de suivre les achats sans exposer les véritables identifiants des utilisateurs.

// During configuration:
try {
   await Adapty().activate(
       configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
         ..withCustomerUserId(YOUR_CUSTOMER_USER_ID, androidObfuscatedAccountId: "OBFUSCATED_ACCOUNT_ID")
   );
} catch (e) {
   // handle the error
}
// Or when identifying users
try {
    await Adapty().identify(customerUserId, androidObfuscatedAccountId: "OBFUSCATED_ACCOUNT_ID");
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
}

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().