> ## Documentation Index
> Fetch the complete documentation index at: https://tomee-mintlify-a42fba9d.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Transcend

> Intégrez Transcend à votre documentation Mintlify pour conditionner l’analytique au consentement des visiteurs via votre bundle Transcend.

Utilisez [Transcend](https://transcend.io/) pour gérer le consentement aux cookies sur votre site de documentation. Lorsque vous configurez Transcend, Mintlify charge votre bundle Transcend, affiche la bannière de consentement de Transcend et ne charge l’analytique et les retours qu’après que les visiteurs ont accordé leur consentement pour la finalité Analytics.

Configurez Transcend si vous l’utilisez déjà comme plateforme de gestion du consentement (CMP) et que vous souhaitez offrir une expérience de consentement unique et cohérente entre votre produit et votre documentation.

<Note>
  Lorsque Transcend est configuré, c’est Transcend qui gère la bannière de consentement. La bannière de consentement intégrée de Mintlify ne s’affiche pas, afin que les visiteurs ne voient qu’une seule invite.
</Note>

<div id="setup">
  ## Installation
</div>

<Steps>
  <Step title="Obtenez votre identifiant de bundle Transcend">
    Dans votre tableau de bord Transcend, allez dans **Consent Management** et copiez l’identifiant de bundle du déploiement que vous souhaitez utiliser avec votre documentation. L’identifiant de bundle apparaît dans l’URL de votre script Airgap : `https://transcend-cdn.com/cm/<bundleId>/airgap.js`.
  </Step>

  <Step title="Ajoutez Transcend à votre docs.json">
    Ajoutez un objet `transcend` sous `integrations` dans votre `docs.json` :

    ```json theme={null}
    "integrations": {
      "transcend": {
        "bundleId": "YOUR_BUNDLE_ID"
      }
    }
    ```

    Vous pouvez également configurer Transcend depuis votre tableau de bord sous **Analytics** → **Add integration** → **Compliance**.
  </Step>

  <Step title="Vérifiez que la bannière se charge">
    Déployez votre documentation et ouvrez le site. La bannière de consentement de Transcend doit apparaître lors de la première visite. Acceptez, refusez, puis révoquez le consentement à l’analytique pour confirmer que les scripts d’analytique respectent le choix du visiteur.
  </Step>
</Steps>

<div id="configuration">
  ## Configuration
</div>

| Champ              | Type   | Requis | Description                                                                                                                                                         |
| ------------------ | ------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `bundleId`         | string | Oui    | Votre identifiant de bundle Transcend. Ne peut contenir que des lettres, des chiffres, des traits d’union et des tirets bas.                                        |
| `analyticsPurpose` | string | Non    | Le nom de la finalité Transcend qui conditionne l’analytique et les retours. Par défaut `Analytics`. Définissez-le si vous avez renommé la finalité dans Transcend. |

<div id="custom-analytics-purpose">
  ### Finalité d’analytique personnalisée
</div>

Si vous avez renommé la finalité Analytics dans votre instance Transcend, indiquez le nom exact de la finalité pour que Mintlify attende le consentement sur la bonne finalité :

```json theme={null}
"integrations": {
  "transcend": {
    "bundleId": "YOUR_BUNDLE_ID",
    "analyticsPurpose": "Product Analytics"
  }
}
```

<div id="how-consent-gating-works">
  ## Fonctionnement du conditionnement au consentement
</div>

* Les scripts d’analytique et de retours ne se chargent pas tant que Transcend n’a pas résolu le consentement du visiteur pour la finalité configurée.
* Si un visiteur accorde son consentement puis le révoque ultérieurement, la page se recharge afin que les scripts d’analytique déjà chargés soient supprimés.
* Si Transcend ne parvient pas à se charger ou si un visiteur ne résout jamais la bannière, l’analytique reste désactivée.