Connecter FunnelFox à Adapty
FunnelFox crée des funnels web : pages de destination et quiz qui vendent vos abonnements en dehors de l’App Store et de Google Play. Connectez FunnelFox à Adapty pour donner aux acheteurs web l’accès aux fonctionnalités payantes de votre application mobile, et pour voir leurs achats dans le même tableau de bord que vos achats en store.
La connexion nécessite une clé et un identifiant de niveau d’accès. Votre application doit ensuite identifier l’acheteur pour atteindre ce niveau d’accès. Voir Accorder l’accès dans votre application.
Fonctionnement de l’intégration
FunnelFox collecte le paiement sur le web. FunnelFox appelle ensuite l’API server-side Adapty pour créer le profil, enregistrer la transaction et accorder le niveau d’accès dont vous saisissez l’identifiant dans les paramètres d’intégration FunnelFox. Les renouvellements, annulations et paiements échoués mettent à jour le même profil. Les achats web apparaissent dans les analytics Adapty aux côtés de vos revenus App Store et Google Play.
Créez un produit correspondant dans Adapty pour chaque produit vendu par votre funnel. L’achat parvient à Adapty dans tous les cas, mais sans produit associé, Adapty ne dispose d’aucune durée d’abonnement, ce qui peut entraîner une durée incorrecte dans les analyses ou laisser l’achat sans catégorie.
Adapty associe un achat web à un utilisateur de l’application via son customer user ID. FunnelFox utilise par défaut l’adresse e-mail saisie lors du paiement comme identifiant.
Si votre funnel facture via Stripe ou Paddle, vous n’avez pas besoin de connecter ce fournisseur à Adapty en plus. Connectez-le uniquement si vous vendez également via ce fournisseur en dehors de vos funnels — Adapty déduplique alors les transactions qui lui parviennent des deux sources.
Pour reproduire le même flow avec votre propre tunnel de paiement web plutôt qu’un funnel FunnelFox, consultez Synchroniser les achats entre le web et le mobile.
Connecter FunnelFox
La connexion se configure du côté de FunnelFox, en suivant le guide d’intégration Adapty de FunnelFox. Il vous demande deux valeurs issues d’Adapty :
- Secret API key : Ouvrez App Settings dans Adapty et copiez la clé secrète.
- Access level ID : Le niveau d’accès accordé par un achat. Chaque application Adapty commence avec un niveau
premium; pour en accorder un autre, créez-le d’abord.
Accorder différents niveaux d’accès dans un même funnel
Un funnel qui vend un seul niveau n’a besoin de rien ici : chaque achat accorde le niveau d’accès défini dans les paramètres d’intégration.
Pour vendre plusieurs niveaux depuis un même funnel, utilisez le champ Custom entitlement sur un élément de paiement. Il remplace l’ID de niveau d’accès défini dans les paramètres d’intégration, pour les achats effectués via cet élément. Un funnel peut contenir plusieurs éléments de paiement, comme un bouton Wallet et un paiement en accordéon. Chacun possède son propre champ Custom entitlement : remplissez-le sur chaque élément devant accorder le remplacement.
Republish le flow après avoir modifié les paramètres d’intégration ou toute valeur de Custom entitlement. Un flow publié continue de servir sa configuration précédente jusqu’à ce que vous le republiiez.
Accorder l’accès dans votre application
Pour débloquer les fonctionnalités payantes pour un acheteur web, appelez Adapty.activate() ou Adapty.identify() avec le même customer user ID que celui utilisé par FunnelFox. Par défaut, cet identifiant correspond à l’adresse e-mail saisie par l’acheteur lors du paiement. Consultez Identification des utilisateurs iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, et Capacitor pour effectuer cet appel.
L’installation de l’application depuis un lien dans le funnel n’identifie pas l’acheteur. Tant que votre application n’appelle pas Adapty.identify() avec l’ID correspondant, le profil qui détient le niveau d’accès et le profil créé par l’application restent séparés, et l’application n’affiche aucun accès payant. Se connecter avec l’e-mail utilisé lors du paiement permet de relier les deux.
Pour débloquer l’accès sans étape de connexion, transmettez le customer user ID du funnel à l’application via un lien profond différé, puis appelez Adapty.identify() avec cet ID au premier lancement.
Ensuite, lisez le niveau d’accès depuis le profil pour débloquer les fonctionnalités. Voir Vérification du statut d'abonnement iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, et Capacitor .
Tester l’intégration
- Effectuez un achat dans votre funnel.
- Dans Adapty, ouvrez Profiles et trouvez le profil grâce à l’identifiant utilisateur client utilisé par FunnelFox.
- Confirmez que le niveau d’accès dont vous avez saisi l’ID dans les paramètres d’intégration FunnelFox est actif sur ce profil.
- Ouvrez votre application, identifiez le même utilisateur et confirmez que les fonctionnalités payantes sont bien déverrouillées.
Résolution des problèmes
Un acheteur web ouvre l’application sans accès payant
Votre application n’a pas identifié l’acheteur. FunnelFox a accordé le niveau d’accès à un profil associé à l’ID qu’il a utilisé (l’e-mail de paiement par défaut), mais votre application lit un profil différent. Appelez Adapty.identify() avec cet ID, comme décrit dans Fournir l’accès dans votre application.
Autres intégrations FunnelFox
FunnelFox se connecte à trois produits Adapty, chacun configuré séparément.
| Produit | Ce que FunnelFox envoie à Adapty | Guide de configuration |
|---|---|---|
| Core | Profils, transactions et niveaux d’accès, afin que les achats web déverrouillent l’application | Cet article |
| Adapty Attribution | Événements de transaction avec données de campagne, d’entonnoir et d’expérience | Intégrer FunnelFox avec Adapty Attribution |
| Adapty Mail | Adresses e-mail, historique des achats et événements d’abonnement | Connecter FunnelFox à Adapty Mail |