Votre plan de migration comporte 5 étapes logiques et prend en moyenne 2 heures. 90 % des migrations prennent moins d’une journée de travail.

1. Découvrez les différences essentielles ; créez et configurez un compte Adapty (5 minutes) ;
2. Installez le SDK Adapty pour votre plateforme (iOS, Android, React Native, Flutter, Kotlin Multiplatform, Unity) à la place du SDK RevenueCat (1 heure) ;
3. Configurez les notifications serveur de l’Apple App Store vers Adapty et (optionnellement) le transfert des événements bruts (5 minutes) ;
4. Testez et publiez les mises à jour de votre application (30 minutes) ;
5. (Optionnel) Demandez à l’assistance RevenueCat les données historiques au format CSV (5 minutes) ;
6. (Optionnel) Importez les données historiques via l’assistance Adapty (30 minutes).

Avant de publier une nouvelle version de votre application avec le SDK Adapty, consultez notre checklist de publication.

Découvrez les différences essentielles ; créez et configurez un compte Adapty

Les SDK Adapty et RevenueCat sont conçus de façon similaire. La principale différence porte sur l’utilisation du réseau et la vitesse : le SDK Adapty est conçu pour vous fournir les informations à la demande aussi rapidement que possible. Par exemple, lors d’une requête de paywall, vous obtenez d’abord le Remote Config pour pré-construire votre onboarding ou votre paywall, puis vous demandez les produits dans une requête dédiée.

La terminologie diffère légèrement :

RevenueCat	Adapty
Package	Produit
Offering	Paywall
Paywall	Paywall Builder
Entitlement	Niveau d’accès

Adapty repose sur la notion de placement. Il s’agit d’un endroit logique dans votre application où l’utilisateur peut effectuer un achat. Dans la plupart des cas, vous avez un ou deux placements :

• Onboarding (car 80 % de tous les achats y ont lieu) ;
• Général (affiché dans les paramètres ou dans l’application après l’onboarding).

Installez le SDK Adapty et remplacez le SDK RevenueCat

Installez le SDK Adapty pour votre plateforme (iOS, Android, React Native, Flutter, Kotlin Multiplatform, Unity) dans votre application.

Vous devez remplacer quelques méthodes SDK côté application. Voici les fonctions les plus courantes et comment les remplacer par celles du SDK Adapty.

Activation du SDK

Remplacez Purchases.configure par Adapty.activate.

Récupération des paywalls (offerings)

Remplacez Purchases.shared.getOfferings par Adapty.getPaywall.

Dans Adapty, vous demandez toujours le paywall via un identifiant de placement. En pratique, vous ne récupérez jamais plus d’un ou deux paywalls, ce choix délibéré vise à accélérer le SDK et à réduire l’utilisation du réseau.

Récupération d’un utilisateur (profil client)

Remplacez Purchases.shared.getCustomerInfo par Adapty.getProfile.

Récupération des produits

Dans RevenueCat, vous utilisez la structure suivante : Purchases.shared.getOfferings puis self.offering?.availablePackages.

Dans Adapty, vous demandez d’abord un paywall (voir ci-dessus) pour accéder immédiatement au Remote Config d’Adapty, puis vous appelez les produits avec Adapty.getPaywallProducts.

Effectuer un achat

Remplacez Purchases.shared.purchase par Adapty.makePurchase.

Vérifier le niveau d’accès (entitlement)

Récupérez un profil client (voir ci-dessus) puis remplacez

customerInfo?.entitlements["premium"]?.isActive == true

par

profile.accessLevels["premium"]?.isActive == true.

Restaurer un achat

Remplacez Purchases.shared.restorePurchases par Adapty.restorePurchases.

Vérifier si l’utilisateur est connecté

Remplacez Purchases.shared.isAnonymous par if profile.customerUserId == nil.

Connecter un utilisateur

Remplacez Purchases.shared.logIn par Adapty.identify.

Déconnecter un utilisateur

Remplacez Purchases.shared.logOut par Adapty.logout.

Redirigez les notifications serveur de l’App Store vers Adapty

Découvrez comment procéder ici.

Testez et publiez une nouvelle version de votre application

Si vous lisez ceci, vous avez déjà :

• Configuré l’Adapty Dashboard
• Installé le SDK Adapty
• Remplacé la logique SDK par les fonctions Adapty
• Redirigé les notifications serveur de l’App Store vers Adapty et, optionnellement, activé le transfert des événements bruts vers RevenueCat
• Effectué un achat sandbox
• Publié une nouvelle version de l’application

Si vous avez coché les points ci-dessus, effectuez simplement un achat test en Sandbox, puis publiez l’application.

(Optionnel) Exportez vos données historiques RevenueCat au format CSV

Exportez vos données historiques depuis RevenueCat au format CSV en suivant les instructions de la documentation officielle de RevenueCat.

(Optionnel) Demandez à l’assistance RevenueCat les Google Purchase Tokens

Si vous devez importer des transactions Google Play, contactez l’assistance RevenueCat pour obtenir un fichier CSV contenant les Google Purchase Tokens via leur page d’assistance. Le Google Purchase Token est un identifiant unique fourni par Google Play pour chaque transaction, indispensable pour suivre et vérifier avec précision les achats dans Adapty. Cette information n’est pas incluse dans le fichier d’export standard. Le fichier contient les trois colonnes suivantes :

• user_id
• google_purchase_token
• google_product_id

Contactez-nous pour importer vos données historiques

Contactez-nous via le chat du site ou par e-mail à support@adapty.io avec vos fichiers CSV.

1. Envoyez directement le fichier CSV exporté depuis RevenueCat à notre équipe d’assistance.
2. Si vous importez des transactions Google Play, joignez le fichier CSV contenant les Google Purchase Tokens reçu de l’assistance RevenueCat.
3. Indiquez-nous quel identifiant utilisateur doit être utilisé comme Customer User ID (identifiant principal de l’utilisateur dans Adapty) : rc_original_app_user_id ou rc_last_seen_app_user_id_alias.

Notre équipe d’assistance importera vos transactions dans Adapty. Les données suivantes seront importées pour chaque transaction :

Paramètre	Description
user_id	Customer User ID, l’identifiant principal de votre utilisateur dans Adapty et votre système.
apple_original_transaction_id	Pour les chaînes d’abonnements, il s’agit de la date d’achat de la transaction d’origine, liée par store_original_transaction_id.
google_product_id	L’identifiant du produit dans le Google Play Store.
google_purchase_token	Un identifiant unique fourni par Google Play pour chaque transaction, requis pour la validation.
country	Le pays de l’utilisateur.
created_at	La date et l’heure de création de l’utilisateur.
subscription_expiration_date	La date et l’heure d’expiration de l’abonnement.
email	L’adresse e-mail de l’utilisateur final.
phone_number	Le numéro de téléphone de l’utilisateur final.
idfa	L’Identifier for Advertisers (IDFA), attribué par Apple à l’appareil d’un utilisateur.
idfv	L’Identifier for Vendors (IDFV), un code attribué à toutes les applications d’un même développeur et partagé entre ces applications sur un appareil.
advertising_id	Un identifiant unique fourni par l’OS Android que les annonceurs peuvent utiliser pour le suivi.
attribution_channel	Le nom du canal marketing.
attribution_campaign	Le nom de la campagne marketing.
attribution_ad_group	Le groupe d’annonces d’attribution.
attribution_ad_set	L’ensemble d’annonces d’attribution.
attribution_creative	Le mot-clé créatif d’attribution.

En outre, les identifiants d’intégration pour les intégrations suivantes seront importés : Amplitude, Mixpanel, AppsFlyer, Adjust et FacebookAds.

FAQ

J’ai installé le SDK Adapty avec succès et publié une nouvelle version de l’application. Que se passera-t-il pour mes abonnés existants qui n’ont pas mis à jour vers la version avec le SDK Adapty ?

La plupart des utilisateurs chargent leur téléphone la nuit, c’est généralement à ce moment-là que l’App Store met automatiquement à jour toutes leurs applications, donc cela ne devrait pas poser de problème. Il peut subsister un petit nombre d’abonnés payants qui n’ont pas effectué la mise à jour, mais ils auront toujours accès au contenu premium. Vous n’avez pas à vous en préoccuper ni à les forcer à mettre à jour.

Dois-je exporter mes données historiques de RevenueCat le plus vite possible, ou vais-je les perdre ?

Pas besoin de vous précipiter ; publiez d’abord une version avec le SDK Adapty, puis transmettez-nous vos données historiques. Nous restaurerons l’historique des paiements de vos utilisateurs et alimenterons les profils et les graphiques.

J’utilise un MMP (AppsFlyer, Adjust, etc.) et des outils d’analytics (Mixpanel, Amplitude, etc.). Comment m’assurer que tout fonctionnera correctement ?

Vous devez d’abord nous transmettre les identifiants de ces services tiers via notre SDK pour que nous puissions leur envoyer des données. Consultez le guide d’intégration attribution et d’intégration analytics. Pour les données historiques et les utilisateurs existants, assurez-vous de nous transmettre ces identifiants à partir des données que vous avez exportées depuis RevenueCat.