Identifier les utilisateurs dans le SDK iOS

La façon dont vous gérez les achats des utilisateurs dépend du modèle d’authentification de votre application :

• Si votre application n’utilise pas d’authentification backend et ne stocke pas de données utilisateur, consultez la section sur les utilisateurs anonymes.
• Si votre application dispose (ou disposera) d’une authentification backend, consultez la section sur les utilisateurs identifiés.

Concepts clés :

• Les profils sont les entités nécessaires au fonctionnement du SDK. Adapty les crée automatiquement.
• Ils peuvent être anonymes (sans customer user ID) ou identifiés (avec customer user ID).
• Vous fournissez le customer user ID pour faire le lien entre les profils Adapty et votre système d’authentification interne.

Voici les différences entre utilisateurs anonymes et identifiés :

Utilisateurs anonymes

Si vous n’avez pas d’authentification backend, vous n’avez pas besoin de gérer l’authentification dans le code de l’application :

1. Lors de l’activation du SDK au premier lancement de l’app, Adapty crée un nouveau profil pour l’utilisateur.
2. Lorsque l’utilisateur effectue un achat dans l’app, cet achat est associé à son profil Adapty et à son compte store.
3. Lorsque l’utilisateur réinstalle l’app ou l’installe sur un nouvel appareil, Adapty crée un nouveau profil anonyme lors de l’activation.
4. Si l’utilisateur a déjà effectué des achats dans votre application, ses achats sont automatiquement synchronisés depuis l’App Store lors de l’activation du SDK.

Ainsi, avec des utilisateurs anonymes, de nouveaux profils seront créés à chaque installation, mais ce n’est pas un problème car, dans les analyses Adapty, vous pouvez configurer ce qui sera considéré comme une nouvelle installation.

Pour les utilisateurs anonymes, vous devez compter les installations par ID d’appareil. Dans ce cas, chaque installation de l’application sur un appareil est comptée comme une installation, y compris les réinstallations.

Utilisateurs identifiés

Vous avez deux options pour identifier les utilisateurs dans l’application :

• Lors de la connexion/inscription : Si les utilisateurs se connectent après le démarrage de votre application, appelez identify() avec un customer user ID lorsqu’ils s’authentifient.

• Lors de l’activation du SDK : Si vous disposez déjà d’un customer user ID stocké au lancement de l’application, envoyez-le lors de l’appel à activate().

Lors de la connexion/inscription

Si vous identifiez les utilisateurs après le lancement de l’application (par exemple, après qu’ils se soient connectés ou inscrits), utilisez la méthode identify pour définir leur customer user ID.

• Si vous n’avez pas encore utilisé ce customer user ID, Adapty le liera automatiquement au profil actuel.
• Si vous avez déjà utilisé ce customer user ID pour identifier l’utilisateur, Adapty basculera vers le profil associé à ce customer user ID.

Attendez toujours que identify soit résolu (await) avant d’appeler d’autres méthodes du SDK. Les appels simultanés produisent l’erreur #3006 profileWasChanged ou atterrissent sur le profil anonyme. Voir Ordre des appels dans le SDK iOS.

do {
    try await Adapty.identify("YOUR_USER_ID") // Unique for each user
} catch {
    // handle the error
}

// User IDs must be unique for each user
Adapty.identify("YOUR_USER_ID") { error in
    if let error {
        // handle the error
    }
}

Lors de l’activation du SDK

Si vous connaissez déjà un customer user ID au moment d’activer le SDK, vous pouvez l’inclure dans la méthode activate plutôt que d’appeler identify séparément.

Si vous connaissez un customer user ID mais ne le définissez qu’après l’activation, cela signifie qu’à l’activation, Adapty créera un nouveau profil anonyme et ne basculera vers le profil existant qu’après votre appel à identify.

Vous pouvez passer un customer user ID existant (que vous avez déjà utilisé) ou un nouveau. Si vous en passez un nouveau, le profil créé lors de l’activation sera automatiquement lié à ce customer user ID.

// Place in the app main struct for SwiftUI or in AppDelegate for UIKit

let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "PUBLIC_SDK_KEY")
        .with(customerUserId: "YOUR_USER_ID") // Customer user IDs must be unique for each user. If you hardcode the parameter value, all users will be considered as one.

do {
  try await Adapty.activate(with: configurationBuilder.build())
} catch {
  // handle the error
}

// Place in the app main struct for SwiftUI or in AppDelegate for UIKit

let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "PUBLIC_SDK_KEY")
        .with(customerUserId: "YOUR_USER_ID") // Customer user IDs must be unique for each user. If you hardcode the parameter value, all users will be considered as one.

Adapty.activate(with: configurationBuilder.build()) { error in
  // handle the error
}

Déconnecter les utilisateurs

Si votre application dispose d’un bouton de déconnexion, utilisez la méthode logout.

do {
    try await Adapty.logout()
} catch {
    // handle the error
}

Adapty.logout { error in
    if error == nil {
        // successful logout
    }
}

Autoriser les achats sans connexion

Si vos utilisateurs peuvent effectuer des achats avant et après leur connexion à votre application, vous devez vous assurer qu’ils conserveront leur accès après la connexion :

1. Lorsqu’un utilisateur non connecté effectue un achat, Adapty le lie à son ID de profil anonyme.
2. Lorsque l’utilisateur se connecte à son compte, Adapty bascule vers son profil identifié.
   • S’il s’agit d’un nouveau customer user ID (par exemple, l’achat a été effectué avant l’inscription), Adapty attribue le customer user ID au profil actuel, de sorte que tout l’historique des achats est conservé.
   • S’il s’agit d’un customer user ID existant (déjà lié à un profil), vous devez récupérer le niveau d’accès réel après le changement de profil. Vous pouvez soit appeler getProfile juste après l’identification, soit écouter les mises à jour du profil pour que les données se synchronisent automatiquement.

Prochaines étapes

Félicitations ! Vous avez implémenté la logique de paiement intégré dans votre application ! Nous vous souhaitons tout le succès possible pour la monétisation de votre app !

Pour tirer encore plus parti d’Adapty, vous pouvez explorer ces sujets :

• Tests : Vérifiez que tout fonctionne comme prévu
• Onboardings : Engagez vos utilisateurs avec des onboardings et favorisez la rétention
• Intégrations : Intégrez des services d’attribution marketing et d’analyse en une seule ligne de code
• Définir des attributs de profil personnalisés : Ajoutez des attributs personnalisés aux profils utilisateur et créez des segments pour lancer des tests A/B ou afficher des paywalls différents selon les utilisateurs