---
title: "Configurer l'intégration App Store"
description: "Configurez votre connexion App Store pour un suivi fluide des abonnements."
---

<div style={{
    maxWidth: '560px',
    margin: '0 auto 2rem',
    position: 'relative',
    aspectRatio: '16/9',
    width: '100%'
}}>
    <iframe
        style={{
            position: 'absolute',
            top: 0,
            left: 0,
            width: '100%',
            height: '100%'
        }}
        src="https://www.youtube.com/embed/VJQbzoTCkqs?si=l7BPX9mIu6GVGZ0Z"
        title="YouTube video player"
        frameBorder="0"
        allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
        referrerPolicy="strict-origin-when-cross-origin"
        allowFullScreen
    />
</div>

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

:::danger
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 \{#step-1-provide-bundle-id-and-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](create-product#create-product-and-push-to-store) depuis la page **Products**.

:::note
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.
:::

1. Ouvrez [App Store Connect](https://appstoreconnect.apple.com/apps). Sélectionnez votre application et accédez à la section **General** → **App Information**.

2. Copiez le **Bundle ID** dans la sous-section **General Information**.

   

<Zoom>
  <img src="/docs/img/afd5012-bundle_id_apple.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>
</Zoom>

3. Ouvrez l'onglet [**App settings** -> **iOS SDK**](https://app.adapty.io/settings/ios-sdk) depuis le menu supérieur d'Adapty et collez la valeur copiée dans le champ **Bundle ID**.

   

<Zoom>
  <img src="/docs/img/2d64163-bundle_id.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>
</Zoom>

4. Revenez à la page **App information** dans App Store Connect et copiez l'**Apple ID** qui s'y trouve.
5. Sur la page [**App settings** -> **iOS SDK**](https://app.adapty.io/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 \{#step-2-provide-issuer-id-and-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](generate-in-app-purchase-key).

1. Ouvrez **App Store Connect**. Accédez à la section [**Users and Access** → **Integrations** → **In-App Purchase**](https://appstoreconnect.apple.com/access/integrations/api/subs).
2. 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](generate-in-app-purchase-key).

   

  <img src="/assets/shared/img/19a2868-issuer_apple.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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

   

  <img src="/assets/shared/img/c2b42e7-issuer_id.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

4. 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é \{#step-3-upload-in-app-purchase-key-file\}

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](generate-in-app-purchase-key)

  <img src="/assets/shared/img/88cdfff-download_inapp_file.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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

  <img src="/assets/shared/img/253b840-in-app_file_upload.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

## Étape 4. Pour les essais et offres spéciales – configurer les offres promotionnelles \{#step-4-for-trials-and-special-offers--set-up-promotional-offers\}

:::important
Cette étape est obligatoire si votre application propose des [essais ou d'autres offres promotionnelles](offers).
:::

1. Copiez le même Key ID que celui utilisé à l'[Étape 2](#step-2-provide-issuer-id-and-key-id) dans le champ **Subscription key ID** de la section **App Store promotional offers**.
2. Téléversez le même fichier **In-App Purchase Key** que celui utilisé à l'[Étape 3](#step-3-upload-in-app-purchase-key-file) dans la zone **Subscription key (.p8 file)** de la section **App Store promotional offers**.

  <img src="/assets/shared/img/promo-key.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

## Étape 5. Saisir le secret partagé App Store \{#step-5-enter-app-store-shared-secret\}

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.

1. Ouvrez [App Store Connect](https://appstoreconnect.apple.com/apps). Sélectionnez votre application et accédez à la section **General** → **App Information**.

2. Faites défiler jusqu'à la sous-section **App-Specific Shared Secret**.

   

  <img src="/assets/shared/img/2bd112a-shared_secret_apple.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

   :::info
   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.
   :::

3. Cliquez sur le bouton **Manage**.

   

  <img src="/assets/shared/img/2d8b4c0-shared_secret_apple_copy.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

4. 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**.

5. Collez le **Shared Secret** copié dans le champ **App Store shared secret** de l'Adapty Dashboard.

   

  <img src="/assets/shared/img/4f9624d-shared_secret.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

6. Cliquez sur le bouton **Save** dans l'Adapty Dashboard pour confirmer les modifications.

## Étape 6. Ajouter une clé API App Store Connect \{#step-6-add-app-store-connect-api-key\}

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](create-product#create-product-and-push-to-store) :

1. Dans App Store Connect, accédez à [**Users and Access > Integrations > Team keys**](https://appstoreconnect.apple.com/access/integrations/api) et cliquez sur **+**.

  <img src="/assets/shared/img/app-store-connect-api.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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

  <img src="/assets/shared/img/generate-api-key.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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

  <img src="/assets/shared/img/download-api-key.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

4. Dans le tableau de bord Adapty, accédez à [**App settings > iOS SDK**](https://app.adapty.io/settings/ios-sdk) et cliquez sur **Connect API key**.

  <img src="/assets/shared/img/connect-api-key.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

5. Remplissez les champs dans la fenêtre :
   - **Issuer ID** : copiez depuis [**Users and Access > Integrations > Team keys**](https://appstoreconnect.apple.com/access/integrations/api). Il se trouve au-dessus du tableau **API keys**.

  <img src="/assets/shared/img/issuer-id.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

   - **Key ID** : copiez depuis [**Users and Access > Integrations > Team keys**](https://appstoreconnect.apple.com/access/integrations/api). Il se trouve dans le tableau **API keys**, à côté de votre clé.

  <img src="/assets/shared/img/key-id.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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

  <img src="/assets/shared/img/app-store-connect-key.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '500px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

6. Cliquez sur **Connect**.

**Étape suivante**

- [Activer les notifications serveur App Store](enable-app-store-server-notifications)