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. 1

    Ouvre l'API App Store Connect

    Dans App Store Connect : Utilisateurs et accès → onglet Intégrations → API App Store Connect.

    Onglet Intégrations d'App Store Connect, section API.

  2. 2

    Crée la clé

    Bouton + → nomme-la (ex. « appwin ») → choisis un rôle → Generate.

    Création d'une clé API App Store Connect.

    Quel rôle

    RôleCe qu'il permetRecommandation
    DeveloperLire les métadonnées et les avisSuffisant pour l'ASO
    FinanceLire les rapports de ventesNécessaire pour les revenus store
    App ManagerModifier les fichesSeulement si tu veux publier depuis Appwin
    AdminToutÀ é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. 3

    Télécharge le .p8

    Clique Télécharger sur la ligne créée : le fichier AuthKey_XXXXXXXXXX.p8 se télécharge.

    Téléchargement du fichier .p8 de la clé API.

    Le .p8 ne 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. 4

    Importe-le dans Appwin

    Utilise Importer un fichier : Appwin lit le .p8 et en déduit souvent le Key ID depuis le nom du fichier.

    Import du fichier .p8 dans Appwin.

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. 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 ».

    Issuer ID surligné au-dessus de la liste des clés API.

  2. 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.

    Key ID surligné dans le tableau des clés API.

3. Identifier ton app

Ces valeurs relient la clé à ton app, pas au compte en général.

  1. 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.

    Apple ID (App ID) surligné dans les informations de l'app.

  2. 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.

    Bundle ID surligné dans les informations de l'app.

  3. 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.

    Vendor Number surligné dans Paiements et rapports financiers.

4. Renseigner dans Appwin

ChampValeur
App ID1234567890
Bundle IDcom.tonstudio.tonapp (facultatif)
Issuer IDaaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
Key IDXXXXXXXXXX
Private keyContenu du .p8
Vendor Number87654321 (pour les ventes, facultatif)

Ce que ça débloque

DonnéeRôle minimal
Métadonnées, captures, mots-clésDeveloper
Avis et notesDeveloper
Rapports de ventes et revenusFinance

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ômeCause probable
« Authentication failed »Issuer ID ou Key ID erroné
« Invalid private key ».p8 tronqué : les lignes BEGIN/END doivent être incluses
Avis videsTon app n'a pas encore d'avis sur les marchés interrogés
Ventes videsVendor Number manquant, ou rôle sans permission Finance
Erreur 403Le rôle de la clé ne couvre pas la donnée demandée

Suite