Comment Adapty synchronise les données avec les stores

Adapty échange des données de produits avec l’App Store et Google Play, mais cet échange n’est ni permanent ni exhaustif. La plupart des valeurs ne bougent que lorsque vous agissez — quand vous poussez un produit vers les stores, ou que vous téléchargez de nouveaux prix. Certaines ne bougent jamais, ce qui explique qu’Adapty et le store peuvent afficher des prix différents pour le même produit.

Ce qu’Adapty lit depuis les stores

Adapty lit les listes de produits, les plans de base, les prix et les transactions depuis le store. Pour modifier un produit ou un prix, effectuez la modification dans la console du store. Pour consulter les prix par pays qu’il contient, téléchargez le CSV des prix depuis Modifier le produit.

Ce qu’Adapty litComment ça arrive (App Store)Comment ça arrive (Google Play)
Liste des produits et statut de révisionVia la clé API App Store ConnectVia le compte de service
Plans de baseNon applicableFait partie du produit d’abonnement
Prix par paysLors de la liaison ou de la modification d’un produit storeLors de la liaison ou de la modification d’un produit store
Transactions, renouvellements et remboursementsVia les notifications serveur App StoreVia les notifications développeur en temps réel
Le prix payé par le clientAvec chaque transactionAvec chaque transaction

Ce qu’Adapty écrit dans les stores

Les produits, les prix et les essais de lancement sont créés dans Adapty et transmis au store lorsque vous effectuez une action, jamais automatiquement.

Ce qu’Adapty écritQuand cela arrive sur l’App StoreQuand cela arrive sur Google Play
Nouveaux produitsQuand vous publiez un produit sur les storesQuand vous publiez un produit sur les stores
Prix par paysQuand vous importez le CSV de prixQuand vous importez le CSV de prix
Essai gratuit de lancementQuand vous publiez un nouveau produitJamais — créez-le dans la Google Play Console à la place

Adapty compare votre CSV avec les prix actuels du store et ne met à jour que ceux qui diffèrent, vous pouvez donc importer le fichier entier en toute sécurité. Les abonnés existants conservent le prix auquel ils se sont inscrits, sauf si vous cochez Apply to existing subscribers.

Ce que vous configurez uniquement dans Adapty

Le store ne modifie jamais ces paramètres.

ÉlémentPourquoi c’est géré dans Adapty
Le prix d’un produit du store que vous avez connectéUn paramètre indicatif, fixé à la création. Il vous aide à distinguer les produits entre eux, mais n’est jamais transmis au store. Les analyses, les intégrations et le SDK utilisent tous les vrais prix du store.
Niveaux d’accèsAdapty gère l’accès à votre contenu payant. Les stores n’ont pas d’équivalent.
Les identifiants des offres promotionnelles et de reconquêteAdapty a besoin de l’identifiant pour signer l’achat. Vous créez l’offre elle-même dans la console du store.

Ce qui se passe sur l’appareil

Le prix qu’un client voit sur un paywall provient de StoreKit ou de Google Play Billing à l’ouverture du paywall, pas d’Adapty. Un prix modifié dans la console du store est visible par vos clients dès que le store le publie. Vous n’avez pas besoin de sortir une nouvelle version de l’application, ni de modifier quoi que ce soit dans Adapty.

Dans l’autre sens, le SDK Adapty envoie chaque achat à Adapty avec le prix, la devise et le pays associés. Adapty utilise ces valeurs pour enregistrer les revenus dans la devise du client.

Stripe, Paddle et stores personnalisés

Les intégrations Stripe et Paddle transmettent des transactions, pas votre catalogue de produits. Les achats arrivent dans Adapty via le webhook du fournisseur ou, pour les stores personnalisés, depuis votre propre backend. Vous ajoutez chaque produit et chaque ID de prix manuellement. Un ID absent dans Adapty ne correspond à rien : ces transactions et leurs revenus n’apparaissent jamais. Pour Stripe et Paddle, il en va de même si le produit existe mais n’a pas de Subscription duration. Rien ne signale l’un ou l’autre cas, alors ajoutez un ID et une durée pour chaque produit que vous vendez.

Écarts de produits et de prix

Certaines différences entre Adapty et la console du store sont intentionnelles et ne changent rien à ce que paient vos clients. D’autres signifient que des revenus ne sont pas enregistrés.

Ce que vous voyezCauses probablesQue faire
Le prix dans Adapty diffère du storeL’écran Products affiche le prix que vous avez saisi lors de la création du produit. Si vous avez poussé le produit vers les stores, Adapty l’a utilisé pour définir le prix de départ. Vous ne pouvez pas le modifier ensuite, donc une fois que les stores ont le contrôle du prix, les deux divergent. Les prix payés par les clients sont désormais des prix par pays.Rien. Vos clients sont facturés au prix du store, et les rapports de revenus utilisent le montant réellement payé. Pour modifier ce qu’ils paient, éditez le prix dans la console de chaque store, ou importez un CSV de prix pour modifier les deux stores en même temps.
Votre produit n’apparaît pas dans la liste déroulante des produitsTrois raisons possibles : des identifiants de store qui ne fonctionnent plus renvoient une liste vide. Un produit créé il y a moins de 10 minutes n’a peut-être pas encore atteint la copie en cache de la liste App Store dans Adapty. La Subscription duration sélectionnée filtre la liste : Lifetime, Non-Subscriptions et Consumables affichent les produits à achat unique, et toute autre valeur affiche les abonnements.Réglez la Subscription duration pour correspondre au type du produit dans le store. Si vous avez créé le produit il y a quelques minutes, réessayez peu après. Sinon, vérifiez vos identifiants de store.
Une offre de lancement n’apparaît pas dans AdaptyAdapty crée une offre de lancement uniquement lors du push d’un nouveau produit vers le store, et ne liste que les offres qu’il a créées. Une offre que vous avez configurée vous-même dans la console du store n’apparaîtra jamais dans la fenêtre Edit product.Rien. Les offres de lancement s’appliquent automatiquement lorsqu’un client y est éligible, il n’est donc pas nécessaire de les ajouter dans Adapty.
Une remise n’a pas été appliquée lors d’un achatLe client n’était peut-être pas éligible — la décision est prise par le store, pas par Adapty. Sinon, une offre promotionnelle App Store n’a pas été appliquée parce qu’Adapty n’a pas pu la signer avec votre clé d’achat intégré.Vérifiez que la clé est uploadée et valide, puis examinez les conditions de l’offre dans le store.
Les transactions Stripe ont cessé d’apparaître après un changement de prixModifier un prix dans Stripe crée un nouveau price_id, et Adapty fait correspondre les événements sur la paire exacte product_id + price_id. Les événements pour le nouveau prix ne correspondent à rien, tandis que Stripe continue de signaler le webhook comme livré.Ajoutez le nouveau price_id au produit dans Adapty — les revenus ne seront pas enregistrés tant que vous ne l’aurez pas fait. Voir Stripe.
Un client a acheté un produit mais n’a obtenu aucun niveau d’accèsL’identifiant de produit du store qu’il a acheté n’est pas lié à un produit dans Adapty. Adapty enregistre l’achat dans une ligne de produit qu’il crée automatiquement, et cette ligne ne comporte aucun niveau d’accès.Créez le produit dans Adapty avec l’identifiant exact du produit du store, et assignez-lui un niveau d’accès.
Les mises à jour n’arrivent plusL’un de vos identifiants de store a cessé de fonctionner. Chacun alimente une partie différente de l’échange.Identifiez la partie qui a cessé de fonctionner et remplacez uniquement ses identifiants — voir Si les mises à jour cessent d’arriver.

Si les mises à jour cessent d’arriver

Adapty ne signale pas les identifiants qui ont cessé de fonctionner. Chaque identifiant est responsable d’une partie de l’échange, donc le symptôme vous indique lequel remplacer.

Ce qui ne fonctionne plusIdentifiant à remplacer
La liste des produits, les statuts de révision, ou l’envoi des produits et des prix vers le storeApp Store : la clé API App Store Connect. Google Play : le fichier de clé du compte de service.
Les nouvelles transactions, renouvellements et remboursementsApp Store : les notifications serveur. Google Play : les notifications développeur en temps réel.
Les offres promotionnelles lors de l’achatApp Store : la clé d’achat intégré.
La validation des achats pour chaque clientApp Store : le secret partagé. Google Play : le fichier de clé du compte de service.

Remplacer un identifiant dans la console du store ne le met pas à jour dans Adapty. Importez le nouveau dans App settings.