App Store Connect : fiche, avis et ventes
Connecter App Store Connect permet à Appwin de lire les données de ton app sur l'App Store : métadonnées, avis, ventes.
C'est un accès en lecture dans l'usage courant. Le niveau de permission que tu accordes reste ton choix, et la clé donne autant de droits que le rôle que tu lui attribues - d'où la recommandation ci-dessous.
Réglages → Projets → ton app → Intégrations → App Store Connect.
1. Créer la clé API (.p8)
Il faut être Account Holder ou Admin pour voir l'onglet Intégrations.
- 1
Ouvre l'API App Store Connect
Dans App Store Connect : Utilisateurs et accès → onglet Intégrations → API App Store Connect.

- 2
Crée la clé
Bouton + → nomme-la (ex. « appwin ») → choisis un rôle → Generate.

Quel rôle
Rôle Ce qu'il permet Recommandation Developer Lire les métadonnées et les avis Suffisant pour l'ASO Finance Lire les rapports de ventes Nécessaire pour les revenus store App Manager Modifier les fiches Seulement si tu veux publier depuis Appwin Admin Tout À éviter Le principe : accorde le rôle minimal pour ce que tu comptes utiliser. Tu peux créer plusieurs clés avec des rôles différents, et en révoquer une sans toucher aux autres.
- 3
Télécharge le .p8
Clique Télécharger sur la ligne créée : le fichier
AuthKey_XXXXXXXXXX.p8se télécharge.
Le
.p8ne se télécharge qu'une fois. Apple ne le régénère pas. Fichier perdu ? Révoque la clé et recrée-en une. - 4
Importe-le dans Appwin
Utilise Importer un fichier : Appwin lit le
.p8et en déduit souvent le Key ID depuis le nom du fichier.
2. Relever les identifiants de la clé
Toujours sur la page Clés API. La private key, c'est le contenu du .p8
déjà importé à l'étape 1 (lignes BEGIN / END comprises).
- 1
Issuer ID
UUID affiché au-dessus du tableau des clés. Identique pour toutes les clés du compte ; il n'apparaît qu'une fois la première clé créée. C'est lui qui dit à Apple « quel compte App Store Connect ».

- 2
Key ID
Colonne du tableau (ou fragment du nom
AuthKey_XXXXXXXXXX.p8). Propre à cette clé. Si tu as importé le fichier à l'étape 1, Appwin le déduit souvent tout seul.
3. Identifier ton app
Ces valeurs relient la clé à ton app, pas au compte en général.
- 1
App ID (Apple ID)
Dans Apps → ton app → General → App Information, le champ « Apple ID » (10 chiffres). C'est aussi le nombre dans l'URL
/apps/1234567890/.Ne confonds pas avec l'App ID Appwin (celui du SDK) : même nom, deux notions différentes.

- 2
Bundle ID
Toujours dans App Information : l'« Identifiant de lot ». Même valeur que Bundle Identifier dans Xcode. Facultatif pour Appwin, utile pour croiser avec les autres intégrations.

- 3
Vendor Number (ventes)
Dans Paiements et rapports financiers, en haut à gauche (8 chiffres). Nécessaire seulement pour les rapports de ventes ; sans lui, métadonnées et avis fonctionnent quand même.

4. Renseigner dans Appwin
| Champ | Valeur |
|---|---|
| App ID | 1234567890 |
| Bundle ID | com.tonstudio.tonapp (facultatif) |
| Issuer ID | aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee |
| Key ID | XXXXXXXXXX |
| Private key | Contenu du .p8 |
| Vendor Number | 87654321 (pour les ventes, facultatif) |
Ce que ça débloque
| Donnée | Rôle minimal |
|---|---|
| Métadonnées, captures, mots-clés | Developer |
| Avis et notes | Developer |
| Rapports de ventes et revenus | Finance |
Sécurité
Les clés d'intégration sont chiffrées au repos en base. Elles ne sont jamais renvoyées en clair au dashboard : une fois enregistrée, une clé s'affiche masquée et ne peut être que remplacée.
Si tu soupçonnes une fuite, révoque la clé depuis App Store Connect - la révocation est immédiate côté Apple, indépendamment de ce qui est stocké chez Appwin.
Dépannage
| Symptôme | Cause probable |
|---|---|
| « Authentication failed » | Issuer ID ou Key ID erroné |
| « Invalid private key » | .p8 tronqué : les lignes BEGIN/END doivent être incluses |
| Avis vides | Ton app n'a pas encore d'avis sur les marchés interrogés |
| Ventes vides | Vendor Number manquant, ou rôle sans permission Finance |
| Erreur 403 | Le rôle de la clé ne couvre pas la donnée demandée |
Suite
- Google Play Console - le versant Android
- ASO - fiche, avis, mots-clés, concurrents
- Finance - rapports de ventes