Configurer l'intégration App Store

Pour connecter votre application iOS à Adapty, saisissez ses identifiants App Store dans App settings > iOS SDK. Adapty peut alors :

  • Valider les achats.
  • Recevoir les événements d’abonnement.
  • Synchroniser vos produits avec App Store Connect.

Si les achats ou les événements d’abonnement cessent d’arriver dans Adapty, vérifiez chaque identifiant.

Avant de commencer :

  • Vous devez avoir accès à l’application cible dans App Store Connect. Si elle n’y figure pas encore, configurez App Store Connect. Si vous n’avez pas accès à la plateforme, faites-en la demande.
  • Votre équipe doit avoir accès à l’API App Store Connect — elle est nécessaire pour générer la clé d’accès requise. Si ce n’est pas encore le cas, demandez au titulaire du compte de faire la demande. Apple examine chaque demande.
  • Ouvrez deux onglets dans votre navigateur : votre application dans App Store Connect dans l’un, et App settings > iOS SDK dans Adapty dans l’autre. Vous copierez des valeurs entre les deux onglets tout au long de ce guide.

Vue d’ensemble

Chaque identifiant présenté dans ce guide est obligatoire. Adapty utilise chacun d’eux pour une partie différente de l’échange de données avec l’App Store. Pour terminer la configuration, suivez ces sept étapes :

  1. Entrez le Bundle ID et l’Apple App ID
  2. Entrez le secret partagé propre à l’application
  3. Activez les notifications du serveur App Store avec l’URL d’Adapty
  4. Ajoutez la clé d’achat intégré
  5. Ajoutez la clé API App Store Connect
  6. Installez le SDK Adapty et effectuez un achat sandbox
  7. Vérifiez toutes les informations d’identification

Saisir le Bundle ID et l’Apple App ID

Deux valeurs identifient votre application dans App Store Connect : le Bundle ID et l’Apple ID, appelé Apple App ID dans Adapty. Adapty a besoin du Bundle ID pour traiter les achats. Avec l’Apple ID, Adapty :

  • Trouve vos produits dans App Store Connect et en crée de nouveaux.
  • Affiche le statut App Store et les prix de vos produits.
  • Envoie des messages en temps réel pour la Retention Messaging.
  • Identifie votre application auprès des intégrations d’attribution, comme AppsFlyer.

Apple attribue l’Apple ID lorsque vous ajoutez l’application dans App Store Connect, donc saisissez-le même avant que votre application soit disponible sur l’App Store.

  1. Open App Store Connect. Select your app and proceed to General > App Information section.

  2. Copy the Bundle ID in the General Information sub-section.

    Copy only the identifier — reverse-DNS format with no spaces, for example, com.company.app. App Store Connect shows the app name next to it in other views, like the apps list; pasting that instead of the identifier makes the connection between Adapty and the App Store fail to validate.

asc-app-information-bundle-id.webp
  1. Open the App settings > iOS SDK tab from the Adapty top menu and paste the copied value to the Bundle ID field.
app-settings-bundle-id.webp
  1. Get back to the App information page in App Store Connect and copy Apple ID from there.
asc-app-information-apple-id.webp
  1. On the App settings > iOS SDK page in the Adapty dashboard, paste the ID to the Apple App ID field.
app-settings-apple-app-id.webp

Saisissez le secret partagé spécifique à l’application

Adapty a besoin du secret partagé spécifique à l’application pour valider les reçus d’achat et créer des produits dans App Store Connect.

  1. Dans App Store Connect, ouvrez la page App Information de votre application. Dans la section App-Specific Shared Secret, cliquez sur Manage.

    Section App-Specific Shared Secret sur la page App Information dans App Store Connect
  2. Copiez le secret. Si l’application n’a pas encore de secret, cliquez d’abord sur Generate. Pour générer un secret, vous devez avoir le rôle Account Holder ou Admin dans App Store Connect. Si vous n’avez ni l’un ni l’autre, demandez à quelqu’un qui possède ce rôle de générer le secret et de vous l’envoyer.

    Sauf si vous avez reçu l’application via un transfert d’app, ne cliquez pas sur Regenerate : le secret actuel cesserait alors de fonctionner partout où il est utilisé.

    Fenêtre App-Specific Shared Secret avec le secret
  3. Dans Adapty, collez le secret dans le champ App Store Connect shared secret.

    Champ App Store Connect shared secret dans Adapty
  4. Cliquez sur Save.

Activer les notifications serveur App Store avec l’URL d’Adapty

Apple envoie à Adapty des notifications serveur concernant les renouvellements, les remboursements et d’autres événements d’abonnement au moment où ils se produisent. Adapty enregistre ces événements même lorsque votre application ne signale aucune transaction.

Si Apple envoie déjà ces notifications à un serveur, configurez le transfert vers ce serveur avant de remplacer son URL dans App Store Connect. Dans Adapty, saisissez l’URL de ce serveur dans le champ URL for forwarding raw Apple events, puis cliquez sur Save. Adapty transfère alors les notifications reçues d’Apple vers ce serveur.

Si votre backend doit conserver son URL dans App Store Connect, transmettez les notifications à Adapty depuis votre backend à la place.

  1. Dans Adapty, ouvrez l’application que vous connectez : chaque application Adapty possède sa propre URL de notification. Rendez-vous dans App settings > iOS SDK. Dans la section App Store server notifications, copiez l’URL depuis le champ URL for App Store server notifications.

    URL for App Store server notifications in the App Store server notifications section in Adapty
  2. Dans App Store Connect, ouvrez la page App Information de votre application.

  3. Dans la section App Store Server Notifications, repérez Production Server URL. Si une URL est déjà présente, cliquez sur Edit. Sinon, cliquez sur Set Up URL.

    App Store Server Notifications section on the App Information page in App Store Connect
  4. Collez l’URL d’Adapty, puis cliquez sur Save.

    Production Server URL dialog in App Store Connect with the URL from Adapty
  5. Pour que les notifications de vos tests sandbox parviennent à Adapty, répétez les étapes 3 et 4 pour Sandbox Server URL.

Ajouter la clé d’achat intégré

Adapty utilise la clé d’achat intégré pour valider les achats et signer les offres promotionnelles. Si vous ne disposez pas encore du fichier de clé, générez la clé dans App Store Connect en premier. Pour ajouter la clé à Adapty :

  1. Pour trouver l’Issuer ID et le Key ID de votre clé, dans App Store Connect, rendez-vous sur Users and Access > Integrations > In-App Purchase. Si quelqu’un d’autre a généré la clé et vous a transmis son Issuer ID, son Key ID et le fichier, passez cette étape.

    Issuer ID et Key ID d'une clé In-App Purchase dans App Store Connect
  2. Dans Adapty, rendez-vous sur App settings > iOS SDK. Dans la section In-app purchase API (StoreKit 2), renseignez les champs suivants :

    • Issuer ID : copiez-le depuis la page In-App Purchase dans App Store Connect.
    • Key ID : copiez-le depuis la liste Active sur la page In-App Purchase, à côté de la clé que vous avez téléchargée.
    • Private key (.p8 file) : importez le fichier que vous avez téléchargé.
    Champs Issuer ID, Key ID et Private key (.p8 file) dans la section In-app purchase API (StoreKit 2) dans Adapty
  3. Adapty signe les offres promotionnelles avec la clé In-App Purchase. Dans la section App Store promotional offers, saisissez à nouveau la clé :

    • Subscription key ID : le Key ID de l’étape 2.
    • Subscription key (.p8 file) : le fichier de l’étape 2.
    Champs Subscription key ID et Subscription key (.p8 file) dans la section App Store promotional offers

    Une clé différente sera enregistrée sans erreur, mais les utilisateurs ne pourront alors pas recevoir d’offres promotionnelles.

  4. Cliquez sur Save. Adapty vérifie la clé auprès d’Apple dans la section In-app purchase API (StoreKit 2) avant d’enregistrer la page. Si Apple rejette la clé, la page affiche « The provided field values are incorrect » : vérifiez les valeurs saisies.

Ajouter la clé API App Store Connect

Adapty utilise la clé API App Store Connect pour créer des produits dans App Store Connect et synchroniser leur statut et leurs prix. Cette clé est différente de la clé d’achat intégré (In-App Purchase), bien que les deux partagent les champs Issuer ID et Key ID.

Adapty a besoin d’une clé d’équipe avec un accès Admin. Si vous n’en avez pas encore, générez-la dans App Store Connect d’abord. Pour connecter la clé dans Adapty :

  1. Pour trouver l’Issuer ID et le Key ID de votre clé d’équipe, dans App Store Connect, accédez à Users and Access > Integrations > App Store Connect API, puis ouvrez l’onglet Team Keys. Si quelqu’un d’autre a généré la clé et vous a envoyé son Issuer ID, Key ID et le fichier, ignorez cette étape.

    Issuer ID et Key ID d'une clé d'équipe dans l'onglet Team Keys d'App Store Connect
  2. Dans Adapty, accédez à App settings > iOS SDK. Dans la section App Store Connect API key, cliquez sur Connect API Key.

    Section App Store Connect API key dans Adapty, avec le bouton Connect API Key
  3. Remplissez les champs :

    • Issuer ID : copiez-le depuis l’onglet Team Keys dans App Store Connect.
    • Key ID : copiez-le depuis la liste Active de l’onglet Team Keys, à côté de la clé que vous avez téléchargée.
    • Private key (.p8 file) : importez le fichier téléchargé pour la clé d’équipe.
    Champs Issuer ID, Key ID et Private key (.p8 file) dans la fenêtre de la clé App Store Connect API
  4. Vous pouvez remplacer une clé connectée ultérieurement, mais vous ne pouvez pas la supprimer. Assurez-vous que la clé provient de l’équipe App Store Connect propriétaire de cette application, puis cliquez sur Connect. Dès lors, vous sélectionnez chaque App Store Product ID parmi vos produits dans App Store Connect, au lieu de le saisir manuellement.

    Adapty ne vérifie pas la clé auprès d’Apple lors de la connexion. Une clé incorrecte échoue sans message d’erreur relatif à la clé : les produits n’affichent aucun statut App Store et la liste déroulante App Store Product ID reste vide. Pour corriger une clé incorrecte, remplacez-la.

Vérifiez que chaque identifiant fonctionne

Pour confirmer qu’Adapty valide les achats, installez le SDK Adapty dans votre application et effectuez un achat sandbox.

L’achat sandbox n’utilise que certains identifiants. Vérifiez chacun d’eux après l’achat, et à nouveau chaque fois que les achats ou les événements d’abonnement cessent de parvenir à Adapty :

  • Bundle ID, Apple App ID et App Store Connect shared secret : Comparez ces trois valeurs avec le Bundle ID, l’Apple ID et le secret sous App-Specific Shared Secret sur la page App Information dans App Store Connect.
  • App Store server notifications : Le statut dans cette section affiche Active dès qu’une notification d’achat ou de renouvellement parvient à Adapty. Si un autre statut est affiché, vérifiez les URL de serveur.
  • In-app purchase API (StoreKit 2) : Adapty vérifie la clé auprès d’Apple lors de l’enregistrement. Si des achats effectués dans votre application ne débloquent aucun accès par la suite, il est possible que la clé ait cessé de fonctionner : remplacez la clé.
  • App Store promotional offers : Assurez-vous que le Subscription key ID correspond au Key ID dans la section In-app purchase API (StoreKit 2). S’ils diffèrent, saisissez la même clé dans les deux sections.
  • App Store Connect API key : Chaque produit App Store affiche un statut dans la colonne App Store status sur la page Products. Si un produit affiche un tiret ou Not Connected, vérifiez la clé et l’Apple App ID.

Juste après la configuration, Analytics peut comptabiliser plus d’essais et d’achats que d’installations, et plus que ce qu’affiche l’Event Feed. La différence correspond aux transactions sans profils : des achats d’utilisateurs qui n’ont pas encore ouvert une version de votre application intégrant le SDK Adapty.

Les autres différences entre Adapty et les rapports du store proviennent de la façon dont chacun comptabilise les achats, pas des identifiants.

Prochaines étapes

Pour préparer votre application à la publication, suivez la liste de vérification avant publication.

Si votre application est également sur Google Play, connectez ce store.