Connecter l'App Store d'Apple
Créez une clé d'API App Store Connect avec le bon rôle, ajoutez-la et choisissez vos apps.
Apple n'utilise pas de fenêtre de connexion pour le reporting. Vous créez une clé d'API dans App Store Connect, la téléchargez une fois, et collez ses informations dans Revenue Sensor. Dans la console, cette source s'appelle Apple IAP.
Avant de commencer
- Un accès Account Holder ou Admin à App Store Connect, pour pouvoir créer des clés.
- Votre Vendor Number, dans App Store Connect → Reports → Payments and Financial Reports. Il est affiché en haut à gauche, sous le nom de votre compte.
Créer votre clé d'API
- 1
Ouvrir la page des clés Integrations
App Store Connect → Users and Access → Integrations → App Store Connect API.
- 2
Générer une clé
Cliquez sur le + à côté de Active et donnez à la clé un nom que vous reconnaîtrez, par exemple “Revenue Sensor”.
- 3
Lui donner un rôle de reporting
Sous Access, choisissez Sales, Finance ou Admin. Chacun de ces rôles peut lire les rapports Sales and Trends importés par Revenue Sensor. Admin est le seul qui donne aussi les chiffres exacts d'App Store Connect (voir ci-dessous). Une clé n'ayant qu'un accès Developer ou App Manager ne peut pas lire les revenus.
- 4
Télécharger le fichier .p8
Apple vous laisse télécharger la clé privée une seule fois. Enregistrez-la en lieu sûr avant de quitter la page. Si vous la perdez, générez une nouvelle clé et utilisez son nouveau Key ID et son nouveau fichier .p8.
L'échec le plus fréquent
Si les revenus reviennent vides, ou si le compte affiche “Your API key needs the Sales role”, le rôle de la clé en est presque toujours la cause : donnez-lui le rôle Sales ou Finance dans App Store Connect, puis reconnectez-vous. Vérifiez aussi que le Vendor Number appartient au même compte App Store Connect que la clé.
Ajouter vos identifiants
- Issuer ID : affiché en haut de la page des clés d'API App Store Connect. Il est identique pour toutes les clés.
- Key ID : affiché sur la ligne de la clé que vous avez créée.
- Clé privée : le fichier .p8 que vous avez téléchargé. Importez-le ou faites-le glisser. Il est stocké chiffré et n'est plus jamais affiché.
- Vendor Number : dans Payments and Financial Reports.
Choisir vos apps
Revenue Sensor liste les apps publiées que la clé peut voir. Sélectionnez celles que vous voulez suivre. Seules les apps sélectionnées sont synchronisées.
Ce qui est importé
Le revenu correspond aux unités multipliées par les Developer Proceeds du rapport quotidien Sales summary d'Apple. Les proceeds sont ce qu'Apple vous verse, après sa commission et toute taxe qu'il collecte, donc Payout est la seule base de revenus pour cette source. Un remboursement arrive sous forme de ligne avec des unités négatives, il est donc soustrait le jour où Apple l'a traité. Les téléchargements et les remboursements sont importés depuis le même rapport.
Délai de reporting
Apple publie le rapport de ventes de chaque jour une fois la journée terminée, donc aujourd'hui n'apparaît jamais encore. Les jours récents peuvent légèrement bouger quand Apple les corrige ; chaque synchronisation relit les 14 derniers jours.