RevGlanceDocumentation

App Store

Connectez App Store Connect avec une clé API pour lire les rapports quotidiens Sales and Trends pour iOS et Mac.

RevGlance lit les rapports quotidiens Sales and Trends d’Apple via l’App Store Connect API. Le résumé SALES fournit les apps payantes et les achats intégrés ; le rapport SUBSCRIBER fournit chaque paiement d’abonnement, chaque essai gratuit et chaque remboursement.

Connexion

  1. Dans App Store Connect, ouvrez Users and Access › Integrations › App Store Connect API et générez une clé d’équipe avec le rôle Finance ou Sales.
  2. Notez l’Issuer ID au-dessus de la liste des clés et le Key ID de la clé, puis téléchargez le fichier .p8. Apple ne permet de le télécharger qu’une seule fois.
  3. Trouvez votre vendor number sous Payments and Financial Reports (en haut à gauche).
  4. Remplissez les quatre champs en collant le fichier .p8 en entier, lignes -----BEGIN PRIVATE KEY----- comprises, puis choisissez Connecter App Store.

Ce que demande le formulaire

ChampRessemble à
Issuer ID57246542-96fe-1a63-e053-0824d011072a
Key ID2X9R4HXF34
Numéro de fournisseur85012345
Clé privée (contenu du .p8)Stocké chiffré-----BEGIN PRIVATE KEY-----

Ajouter le webhook

Les rapports arrivent avec environ un jour de retard. Les App Store Server Notifications préviennent RevGlance dès qu’un élément change, si bien que le rapport suivant est récupéré dès qu’il existe.

  1. Dans RevGlance, ouvrez Paramètres › Sources, ouvrez le menu de la source App Store et choisissez Webhook.
  2. Inventez un long secret aléatoire, collez-le sous Secret de signature et enregistrez.
  3. Copiez l’URL du webhook et ajoutez ?token= suivi de votre secret à la fin.
  4. Dans App Store Connect, ouvrez App Information de votre app et, sous App Store Server Notifications, définissez cette adresse comme URL de production, version 2.

RevGlance vérifie le secret dans l’URL et la signature d’Apple, une chaîne de certificats remontant à Apple Root CA G3.

À quoi s’attendre

  • Clients anonymes. Apple ne nomme aucun acheteur. Chaque abonné devient un client avec un Subscriber ID anonyme, et les codes d’offre, les changements de groupe d’abonnements et les réinitialisations d’ID peuvent ressembler à de nouveaux abonnements.
  • Un an d’historique. Les rapports quotidiens remontent à un an, et chaque jour arrive avec environ un jour de retard.
  • Les annulations apparaissent tard. Apple ne signale aucune annulation : un abonnement prend fin quand son renouvellement a trois jours de retard.

Comment l’App Store est calculé

  • Le prix client compte comme revenu et la commission correspond au prix client moins vos produits : la taxe incluse dans les prix TTC apparaît donc comme commission.
  • Le MRR correspond au dernier prix client : il inclut donc la taxe là où les prix l’incluent, car les rapports d’Apple ne séparent pas la taxe. Une offre de lancement compte à son prix d’offre, et le prix normal apparaît ensuite comme une expansion.
  • Un remboursement provient du rapport d’Apple avec un prix négatif. Quand Apple annule un remboursement, RevGlance supprime le dernier remboursement de cet abonné et de cet abonnement. Apple n’indique pas quel remboursement a été annulé : s’il y en a plusieurs sur un même abonnement, ce n’est peut-être pas le bon qui disparaît.
  • Les remboursements demandés après la réinitialisation de l’identifiant d’un abonné par Apple (180 jours) sont conservés, mais sans client.
  • Les crédits de lots d’apps (CMB-C) ne sont pas des remboursements et sont exclus.
  • Apple n’indique aucune annulation : un abonnement prend fin quand un renouvellement a trois jours de retard.
  • Les paiements échoués ne sont pas signalés : ce chiffre reste donc à zéro.