Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -295,7 +295,8 @@
"group": "Privacy",
"root": "integrations/privacy/overview",
"pages": [
"integrations/privacy/osano"
"integrations/privacy/osano",
"integrations/privacy/transcend"
]
}
]
Expand Down
3 changes: 2 additions & 1 deletion es.json
Original file line number Diff line number Diff line change
Expand Up @@ -273,7 +273,8 @@
"group": "Privacidad",
"pages": [
"es/integrations/privacy/overview",
"es/integrations/privacy/osano"
"es/integrations/privacy/osano",
"es/integrations/privacy/transcend"
]
}
]
Expand Down
6 changes: 5 additions & 1 deletion es/integrations/privacy/overview.mdx
Original file line number Diff line number Diff line change
@@ -1,13 +1,17 @@
---
title: "Integraciones de privacidad"
description: "Conecta tu documentación de Mintlify a plataformas de privacidad como Osano para gestionar consentimiento de cookies, banners y preferencias de usuarios."
description: "Conecta tu documentación de Mintlify a plataformas de privacidad como Osano y Transcend para gestionar consentimiento de cookies y banners."
keywords: ["plataformas de privacidad de datos", "integraciones de cumplimiento", "herramientas de privacidad", "consentimiento de cookies"]
---

<Card title="Osano" href="/es/integrations/privacy/osano" icon={<svg width="32" height="32" className="h-6 w-6" viewBox="0 0 256 256" fill="none" xmlns="http://www.w3.org/2000/svg"><path fillRule="evenodd" clipRule="evenodd" d="M128 256C198.692 256 256 198.692 256 128C256 57.3076 198.692 0 128 0C57.3076 0 0 57.3076 0 128C0 198.692 57.3076 256 128 256ZM128 192C163.346 192 192 163.346 192 128C192 92.6538 163.346 64 128 64C92.6538 64 64 92.6538 64 128C64 163.346 92.6538 192 128 192Z" fill="#7764FA"/></svg>} horizontal>
Gestiona el consentimiento de cookies con [Osano](https://www.osano.com/).
</Card>

<Card title="Transcend" href="/es/integrations/privacy/transcend" icon="shield-check" horizontal>
Gestiona el consentimiento de cookies con [Transcend](https://transcend.io/).
</Card>

<div id="cookie-consent-and-disabling-telemetry">
## Consentimiento de cookies y desactivación de la telemetría
</div>
Expand Down
73 changes: 73 additions & 0 deletions es/integrations/privacy/transcend.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
title: "Transcend"
description: "Integra Transcend con tu documentación de Mintlify para condicionar la analítica al consentimiento del visitante usando tu bundle de Transcend."
keywords: ["Integración de Transcend", "gestión de consentimiento", "consentimiento de cookies", "cumplimiento con el RGPD"]
---

Usa [Transcend](https://transcend.io/) para gestionar el consentimiento de cookies en tu sitio de documentación. Cuando configuras Transcend, Mintlify carga tu bundle de Transcend, muestra el banner de consentimiento de Transcend y solo carga la analítica y los comentarios después de que los visitantes otorguen su consentimiento para el propósito Analytics.

Configura Transcend si ya lo usas como tu plataforma de gestión de consentimiento (CMP) y quieres ofrecer una experiencia de consentimiento única y coherente en tu producto y tu documentación.

<Note>
Cuando Transcend está configurado, Transcend es responsable del banner de consentimiento. El banner de consentimiento integrado de Mintlify no aparece, por lo que los visitantes solo ven un aviso.
</Note>

<div id="setup">
## Configuración inicial
</div>

<Steps>
<Step title="Obtén tu ID de bundle de Transcend">
En tu dashboard de Transcend, ve a **Consent Management** y copia el ID del bundle correspondiente al deployment que quieras usar con tu documentación. El ID del bundle aparece en la URL de tu script de Airgap: `https://transcend-cdn.com/cm/<bundleId>/airgap.js`.
</Step>

<Step title="Agrega Transcend a tu docs.json">
Añade un objeto `transcend` dentro de `integrations` en tu `docs.json`:

```json
"integrations": {
"transcend": {
"bundleId": "YOUR_BUNDLE_ID"
}
}
```

También puedes configurar Transcend desde tu dashboard en **Analytics** → **Add integration** → **Compliance**.
</Step>

<Step title="Verifica que el banner se cargue">
Despliega tu documentación y abre el sitio. El banner de consentimiento de Transcend debería aparecer en la primera visita. Acepta, rechaza y revoca el consentimiento de analítica para confirmar que los scripts de analítica siguen la selección del visitante.
</Step>
</Steps>

<div id="configuration">
## Configuración
</div>

| Campo | Tipo | Obligatorio | Descripción |
| ------------------ | ------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `bundleId` | string | Sí | Tu ID de bundle de Transcend. Solo puede contener letras, números, guiones y guiones bajos. |
| `analyticsPurpose` | string | No | El nombre del propósito de Transcend que condiciona la analítica y los comentarios. Su valor predeterminado es `Analytics`. Configúralo si renombraste el propósito en Transcend. |

<div id="custom-analytics-purpose">
### Propósito de analítica personalizado
</div>

Si renombraste el propósito Analytics en tu instancia de Transcend, indica el nombre exacto del propósito para que Mintlify espere el consentimiento del propósito correcto:

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

<div id="how-consent-gating-works">
## Cómo funciona el control por consentimiento
</div>

- Los scripts de analítica y comentarios no se cargan hasta que Transcend resuelva el consentimiento del visitante para el propósito configurado.
- Si un visitante otorga su consentimiento y luego lo revoca, la página se recarga para que los scripts de analítica ya cargados se descarguen.
- Si Transcend no se carga o un visitante nunca responde al banner, la analítica permanece desactivada.
3 changes: 2 additions & 1 deletion fr.json
Original file line number Diff line number Diff line change
Expand Up @@ -273,7 +273,8 @@
"group": "Confidentialité",
"pages": [
"fr/integrations/privacy/overview",
"fr/integrations/privacy/osano"
"fr/integrations/privacy/osano",
"fr/integrations/privacy/transcend"
]
}
]
Expand Down
6 changes: 5 additions & 1 deletion fr/integrations/privacy/overview.mdx
Original file line number Diff line number Diff line change
@@ -1,13 +1,17 @@
---
title: "Intégrations de confidentialité"
description: "Connectez votre documentation Mintlify aux plateformes de confidentialité comme Osano pour gérer le consentement, les bannières et les préférences."
description: "Connectez votre documentation Mintlify aux plateformes de confidentialité comme Osano et Transcend pour gérer le consentement et les bannières."
keywords: ["plateformes de confidentialité des données", "intégrations de conformité", "outils de confidentialité", "consentement aux cookies"]
---

<Card title="Osano" href="/fr/integrations/privacy/osano" icon={<svg width="32" height="32" className="h-6 w-6" viewBox="0 0 256 256" fill="none" xmlns="http://www.w3.org/2000/svg"><path fillRule="evenodd" clipRule="evenodd" d="M128 256C198.692 256 256 198.692 256 128C256 57.3076 198.692 0 128 0C57.3076 0 0 57.3076 0 128C0 198.692 57.3076 256 128 256ZM128 192C163.346 192 192 163.346 192 128C192 92.6538 163.346 64 128 64C92.6538 64 64 92.6538 64 128C64 163.346 92.6538 192 128 192Z" fill="#7764FA"/></svg>} horizontal>
Gérez le consentement aux cookies avec [Osano](https://www.osano.com/).
</Card>

<Card title="Transcend" href="/fr/integrations/privacy/transcend" icon="shield-check" horizontal>
Gérez le consentement aux cookies avec [Transcend](https://transcend.io/).
</Card>

<div id="cookie-consent-and-disabling-telemetry">
## Consentement aux cookies et désactivation de la télémétrie
</div>
Expand Down
73 changes: 73 additions & 0 deletions fr/integrations/privacy/transcend.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
title: "Transcend"
description: "Intégrez Transcend à votre documentation Mintlify pour conditionner l’analytique au consentement des visiteurs via votre bundle Transcend."
keywords: ["Intégration Transcend", "gestion du consentement", "consentement aux cookies", "conformité RGPD"]
---

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
"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
"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.
11 changes: 10 additions & 1 deletion integrations/privacy/overview.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Privacy integrations"
description: "Connect your Mintlify documentation site to privacy platforms like Osano to manage cookie consent, compliance banners, and user preferences."
description: "Connect your Mintlify documentation site to privacy platforms like Osano and Transcend to manage cookie consent, compliance banners, and user preferences."
keywords: ["data privacy platforms", "compliance integrations", "privacy tools", "cookie consent"]
---

Expand All @@ -13,6 +13,15 @@ keywords: ["data privacy platforms", "compliance integrations", "privacy tools",
Manage cookie consent with [Osano](https://www.osano.com/).
</Card>

<Card
title="Transcend"
href="/integrations/privacy/transcend"
icon="shield-check"
horizontal
>
Manage cookie consent with [Transcend](https://transcend.io/).
</Card>

## Cookie consent and disabling telemetry

If you need to check if a user has already consented to cookies for GDPR compliance, you can specify a local storage key and value under `cookies`:
Expand Down
65 changes: 65 additions & 0 deletions integrations/privacy/transcend.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
title: "Transcend"
description: "Integrate Transcend Consent Management with your Mintlify docs to gate analytics behind visitor consent using your existing Transcend bundle."
keywords: ["Transcend integration", "consent management", "cookie consent", "GDPR compliance"]
---

Use [Transcend](https://transcend.io/) to manage cookie consent on your documentation site. When you configure Transcend, Mintlify loads your Transcend bundle, shows Transcend's consent banner, and only loads analytics and feedback after visitors grant consent for the Analytics purpose.

Check warning on line 7 in integrations/privacy/transcend.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

integrations/privacy/transcend.mdx#L7

Did you really mean 'Transcend's'?

Configure Transcend if you already use it as your consent management platform (CMP) and want a single, consistent consent experience across your product and docs.

Check warning on line 9 in integrations/privacy/transcend.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

integrations/privacy/transcend.mdx#L9

Spell out 'CMP', if it's unfamiliar to the audience.

<Note>
When Transcend is configured, Transcend owns the consent banner. Mintlify's built-in consent banner does not appear, so visitors only see one prompt.

Check warning on line 12 in integrations/privacy/transcend.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

integrations/privacy/transcend.mdx#L12

In general, use active voice instead of passive voice ('is configured').
</Note>

## Setup

<Steps>
<Step title="Get your Transcend bundle ID">
In your Transcend dashboard, go to **Consent Management** and copy the bundle ID for the deployment you want to use with your docs. The bundle ID appears in your Airgap script URL: `https://transcend-cdn.com/cm/<bundleId>/airgap.js`.

Check warning on line 19 in integrations/privacy/transcend.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

integrations/privacy/transcend.mdx#L19

Did you really mean 'Airgap'?
</Step>

<Step title="Add Transcend to your docs.json">
Add a `transcend` object under `integrations` in your `docs.json`:

```json
"integrations": {
"transcend": {
"bundleId": "YOUR_BUNDLE_ID"
}
}
```

You can also configure Transcend from your dashboard under **Analytics** → **Add integration** → **Compliance**.
</Step>

<Step title="Verify the banner loads">
Deploy your docs and open the site. The Transcend consent banner should appear on the first visit. Accept, reject, and revoke analytics consent to confirm that analytics scripts follow the visitor's selection.
</Step>
</Steps>

## Configuration

| Field | Type | Required | Description |
| ------------------ | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `bundleId` | string | Yes | Your Transcend bundle ID. Can only contain letters, numbers, hyphens, and underscores. |
| `analyticsPurpose` | string | No | The Transcend purpose name that gates analytics and feedback. Defaults to `Analytics`. Set this if you renamed the purpose in Transcend. |

### Custom analytics purpose

If you renamed the Analytics purpose in your Transcend instance, pass the exact purpose name so Mintlify waits for consent on the right purpose:

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

## How consent gating works

- Analytics and feedback scripts do not load until Transcend resolves the visitor's consent for the configured purpose.
- If a visitor grants consent and later revokes it, the page reloads so already-loaded analytics scripts are torn down.

Check warning on line 64 in integrations/privacy/transcend.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

integrations/privacy/transcend.mdx#L64

In general, use active voice instead of passive voice ('are torn').
- If Transcend fails to load or a visitor never resolves the banner, analytics stay off.
3 changes: 2 additions & 1 deletion zh.json
Original file line number Diff line number Diff line change
Expand Up @@ -268,7 +268,8 @@
"group": "隐私",
"pages": [
"zh/integrations/privacy/overview",
"zh/integrations/privacy/osano"
"zh/integrations/privacy/osano",
"zh/integrations/privacy/transcend"
]
}
]
Expand Down
6 changes: 5 additions & 1 deletion zh/integrations/privacy/overview.mdx
Original file line number Diff line number Diff line change
@@ -1,13 +1,17 @@
---
title: "隐私集成"
description: "将你的 Mintlify 文档站点连接到 Osano 等隐私平台,管理 Cookie 同意、合规横幅和用户偏好设置。"
description: "将你的 Mintlify 文档站点连接到 Osano、Transcend 等隐私平台,管理 Cookie 同意、合规横幅和用户偏好设置。"
keywords: ["数据隐私平台", "合规集成", "隐私工具", "Cookie 同意"]
---

<Card title="Osano" href="/zh/integrations/privacy/osano" icon={<svg width="32" height="32" className="h-6 w-6" viewBox="0 0 256 256" fill="none" xmlns="http://www.w3.org/2000/svg"><path fillRule="evenodd" clipRule="evenodd" d="M128 256C198.692 256 256 198.692 256 128C256 57.3076 198.692 0 128 0C57.3076 0 0 57.3076 0 128C0 198.692 57.3076 256 128 256ZM128 192C163.346 192 192 163.346 192 128C192 92.6538 163.346 64 128 64C92.6538 64 64 92.6538 64 128C64 163.346 92.6538 192 128 192Z" fill="#7764FA"/></svg>} horizontal>
使用 [Osano](https://www.osano.com/) 管理 Cookie 同意。
</Card>

<Card title="Transcend" href="/zh/integrations/privacy/transcend" icon="shield-check" horizontal>
使用 [Transcend](https://transcend.io/) 管理 Cookie 同意。
</Card>

<div id="cookie-consent-and-disabling-telemetry">
## Cookie 同意与禁用遥测/使用数据
</div>
Expand Down
Loading