Migrer les intégrations vers Adapty

Migrer vers Adapty ne se limite pas à changer de SDK. Vos intégrations tierces d’analytics et d’attribution — des outils comme Amplitude et Adjust — nécessitent également un basculement coordonné. Bien mené, la transition génère peu d’événements en double ou manquants et ne perturbe pas vos campagnes.

Mapper vos événements

Les noms d’événements sont personnalisables dans la plupart des intégrations Adapty. Vous pouvez les configurer pour qu’ils correspondent aux noms déjà utilisés dans vos tableaux de bord et campagnes. Vos rapports d’analytics et de campagne continueront de fonctionner avec les mêmes noms d’événements après le basculement. Pour consulter la liste complète des événements disponibles dans Adapty, voir Événements.

Pour Adjust, l’intégration utilise des identifiants d’événements plutôt que des noms personnalisés. Transférez vos identifiants d’événements existants depuis le tableau de bord Adjust vers la configuration de l’intégration Adapty. Consultez le guide d’intégration Adjust pour plus de détails.

Comment Adapty crée les événements d’intégration

Pour envoyer un événement à une intégration, Adapty doit disposer d’un profil utilisateur. Un profil est créé de deux façons :

Import historique : le profil est créé lorsque vous importez des données de transactions historiques avant la mise en production du SDK.
Interaction avec le SDK : le profil est créé automatiquement lorsque l’utilisateur ouvre l’application avec le SDK Adapty pour la première fois.

Adapty prend connaissance des achats effectués dans l’ancien système en temps réel. Mais il ne peut envoyer un événement d’intégration qu’une fois que le profil de l’acheteur existe. Ce profil est créé lorsque l’utilisateur ouvre l’application avec le SDK Adapty. Les utilisateurs qui ne mettent pas à jour vers la nouvelle version ne généreront pas d’événements d’intégration.

Préparer avant le jour de la migration

Exclure les événements historiques

Activez Exclude Historical Events dans vos paramètres d’intégration. Cela empêche l’envoi à l’intégration des événements antérieurs à la première session SDK Adapty de l’utilisateur.

Ce paramètre est particulièrement important lors de l’import historique, quand Adapty traite un grand volume de transactions passées en une seule fois. Sans lui, ces transactions génèreront un volume important d’événements dans votre outil d’analytics.

Configurer l’intégration à l’avance

Adapty vous permet de configurer et tester une intégration tout en la laissant désactivée. Vous pouvez définir les identifiants, le mapping d’événements et les filtres sans activer l’intégration jusqu’à ce que vous soyez prêt. La configuration est conservée lors de l’activation, rien n’est perdu en la laissant désactivée jusqu’au jour J.

Pour trouver votre intégration, consultez Intégrations d’attribution, Intégrations d’analytics, Intégrations de services de messagerie ou Intégrations Webhook et ETL.

Basculer le jour de la migration

Désactivez l’intégration dans votre ancienne solution et activez-la dans Adapty simultanément. Faire tourner les deux en même temps produira des événements en double.

Mettez en pause les grandes campagnes d’acquisition le jour de la migration. Cela réduit le risque d’erreurs d’optimisation de campagne causées par des événements dans la fenêtre de chevauchement.

À quoi s’attendre

Quelques événements d’intégration manquants ou en double lors de la migration sont inévitables. Lorsque le basculement est effectué correctement, le nombre d’événements concernés est négligeable.

La principale source de lacunes est le timing décrit ci-dessus : Adapty ne peut envoyer des événements d’intégration pour un achat qu’une fois que le profil de l’utilisateur existe. Les achats effectués dans l’ancien système ne génèrent pas d’événements d’intégration Adapty tant que l’acheteur n’ouvre pas l’application avec le SDK Adapty.

Intégrations vs. notifications serveur à serveur

Adapty recommande d’utiliser les intégrations plutôt que de transmettre directement les notifications brutes serveur à serveur du store à vos outils d’analytics ou d’attribution.

Avec les intégrations :

Format unifié : les événements de tous les stores — App Store, Google Play, Stripe — utilisent le même format d’événement.
Données enrichies : les événements incluent les données collectées par Adapty, comme l’état de l’abonnement et les attributs utilisateur. Les notifications brutes ne contiennent pas ces informations.