Transcend
Intégrez Transcend à votre documentation Mintlify pour conditionner l’analytique au consentement des visiteurs via votre bundle Transcend.
Utilisez Transcend 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.
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.
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.
Ajoutez Transcend à votre docs.json
Ajoutez un objet transcend sous integrations dans votre docs.json :
"integrations": {
"transcend": {
"bundleId": "YOUR_BUNDLE_ID"
}
}Vous pouvez également configurer Transcend depuis votre tableau de bord sous Analytics → Add integration → Compliance.
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.
| 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. |
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é :
"integrations": {
"transcend": {
"bundleId": "YOUR_BUNDLE_ID",
"analyticsPurpose": "Product Analytics"
}
}- 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.