Configurer l'intégration App Store

Cette section explique comment établir la connexion entre l’App Store et Adapty pour votre application iOS. C’est nécessaire pour que nous puissions afficher les analytics d’abonnements et valider les achats. Vous pouvez effectuer cette intégration lors de l’onboarding initial ou plus tard dans les App Settings de l’Adapty Dashboard.

Même si vous avez configuré l’intégration de votre application mobile et d’Adapty lors de l’onboarding, vous pouvez modifier ces paramètres ultérieurement dans les App settings.

Les modifications de configuration peuvent être effectuées sans risque pendant la phase Sandbox, tant que votre application mobile n’est pas encore en production avec le SDK Adapty installé. Des modifications après la mise en production peuvent casser le flux d’achat dans votre application.

Étape 1. Fournir le Bundle ID et l’Apple app ID

Le Bundle ID et l’Apple app ID sont tous deux obligatoires. Le Bundle ID est l’identifiant unique de votre application dans l’App Store. Il active les fonctionnalités essentielles d’Adapty, comme le traitement des abonnements. L’Apple app ID est également requis pour créer un nouveau produit et le pousser vers les stores depuis la page Products.

Sans l’Apple app ID, l’option Create a new product and push to stores sur la page Products est désactivée, sans que le tableau de bord n’en indique la raison.

Ouvrez App Store Connect. Sélectionnez votre application et accédez à la section General → App Information.
Copiez le Bundle ID dans la sous-section General Information.

Ouvrez l’onglet App settings -> iOS SDK depuis le menu supérieur d’Adapty et collez la valeur copiée dans le champ Bundle ID.

Revenez à la page App information dans App Store Connect et copiez l’Apple ID qui s’y trouve.
Sur la page App settings -> iOS SDK dans l’Adapty Dashboard, collez l’identifiant dans le champ Apple app ID.

Étape 2. Fournir l’Issuer ID et le Key ID

L’In-app purchase Issuer ID, appelé Issuer ID dans App Store Connect, est un identifiant spécial qui identifie l’émetteur ayant créé le jeton d’authentification. L’In-App Purchase Key ID, appelé Key ID dans App Store Connect, est un identifiant unique associé à une clé cryptographique que vous avez générée dans la section Générer une clé d’achat intégré dans App Store Connect.

Ouvrez App Store Connect. Accédez à la section Users and Access → Integrations → In-App Purchase.
Dans la liste Active, trouvez la clé que vous avez créée dans la section Générer une clé d’achat intégré dans App Store Connect.

Copiez l’Issuer ID et collez-le dans le champ In-app purchase Issuer ID de l’Adapty Dashboard.

Copiez le Key ID et collez-le dans le champ In-app purchase Key ID de l’Adapty Dashboard.

Étape 3. Téléverser le fichier de clé d’achat intégré

Téléversez le fichier In-App Purchase Key que vous avez téléchargé dans la section Générer une clé d’achat intégré dans App Store Connect

dans le champ Private key (.p8 file) de l’Adapty Dashboard.

Étape 4. Pour les essais et offres spéciales – configurer les offres promotionnelles

Cette étape est obligatoire si votre application propose des essais ou d’autres offres promotionnelles.

Copiez le même Key ID que celui utilisé à l’Étape 2 dans le champ Subscription key ID de la section App Store promotional offers.
Téléversez le même fichier In-App Purchase Key que celui utilisé à l’Étape 3 dans la zone Subscription key (.p8 file) de la section App Store promotional offers.

Étape 5. Saisir le secret partagé App Store

Le secret partagé App Store, aussi appelé App Store Connect Shared Secret, est une chaîne hexadécimale de 32 caractères utilisée pour la validation des reçus d’achats intégrés et d’abonnements.

Ouvrez App Store Connect. Sélectionnez votre application et accédez à la section General → App Information.
Faites défiler jusqu’à la sous-section App-Specific Shared Secret.

Si la sous-section App-Specific Shared Secret est absente, assurez-vous d’avoir le rôle Account Holder ou Admin. Si vous avez le rôle Admin mais ne voyez toujours pas la sous-section App-Specific Shared Secret, demandez à l’Account Holder de l’application (la personne qui a créé l’application dans App Store Connect) de générer le secret partagé App Store pour l’application. Après cela, la sous-section sera également visible par les Admins.

Cliquez sur le bouton Manage.

Dans la fenêtre App-Specific Shared Secret qui s’ouvre, copiez le Shared Secret. Si aucun secret partagé n’est visible, cliquez d’abord sur le bouton Manage ou Generate (selon celui qui est disponible), puis copiez le Shared Secret.
Collez le Shared Secret copié dans le champ App Store shared secret de l’Adapty Dashboard.

Cliquez sur le bouton Save dans l’Adapty Dashboard pour confirmer les modifications.

Étape 6. Ajouter une clé API App Store Connect

Générez une clé API App Store Connect et ajoutez-la à Adapty pour pouvoir gérer vos produits dans l’App Store depuis le tableau de bord Adapty :

Dans App Store Connect, accédez à Users and Access > Integrations > Team keys et cliquez sur +.

Dans la fenêtre Generate API key, saisissez un nom pour la clé et accordez-lui l’accès Admin.

Cliquez sur Download à côté de votre clé. Notez que vous ne pouvez la télécharger qu’une seule fois.

Dans le tableau de bord Adapty, accédez à App settings > iOS SDK et cliquez sur Connect API key.

Remplissez les champs dans la fenêtre :
- Issuer ID : copiez depuis Users and Access > Integrations > Team keys. Il se trouve au-dessus du tableau API keys.

Key ID : copiez depuis Users and Access > Integrations > Team keys. Il se trouve dans le tableau API keys, à côté de votre clé.

API key : téléversez le fichier de clé API que vous avez téléchargé depuis App Store Connect.

Cliquez sur Connect.

Étape suivante

Activer les notifications serveur App Store