Skip to content
Mintlify
Mintlify
隐私

Transcend

将 Transcend 同意管理与你的 Mintlify 文档集成,使用你现有的 Transcend bundle 在获得访客同意后再加载分析。

使用 Transcend 管理文档站点上的 Cookie 同意。当你配置 Transcend 后,Mintlify 会加载你的 Transcend bundle,展示 Transcend 的同意横幅,并仅在访客授予 Analytics 用途的同意后才加载分析和反馈脚本。

如果你已经将 Transcend 作为同意管理平台 (CMP),并希望在你的产品和文档之间提供一致的同意体验,可以配置 Transcend。

当配置了 Transcend 后,同意横幅由 Transcend 负责展示。Mintlify 内置的同意横幅将不会出现,因此访客只会看到一个提示。

获取你的 Transcend bundle ID

在你的 Transcend 控制台中,前往 Consent Management,复制你希望用于文档的部署对应的 bundle ID。bundle ID 会出现在你的 Airgap 脚本 URL 中:https://transcend-cdn.com/cm/<bundleId>/airgap.js

将 Transcend 添加到你的 docs.json

docs.jsonintegrations 下添加一个 transcend 对象:

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

你也可以在控制台中通过 AnalyticsAdd integrationCompliance 配置 Transcend。

验证横幅是否加载

部署你的文档并打开站点。Transcend 的同意横幅应在首次访问时出现。接受、拒绝并撤销分析同意,以确认分析脚本会遵循访客的选择。

字段类型是否必填说明
bundleIdstring你的 Transcend bundle ID。只能包含字母、数字、连字符和下划线。
analyticsPurposestring用于控制分析和反馈的 Transcend 用途名称。默认为 Analytics。如果你在 Transcend 中重命名了该用途,请设置此字段。

如果你在 Transcend 实例中重命名了 Analytics 用途,请传入精确的用途名称,以便 Mintlify 等待正确用途的同意:

"integrations": {
  "transcend": {
    "bundleId": "YOUR_BUNDLE_ID",
    "analyticsPurpose": "Product Analytics"
  }
}
  • 在 Transcend 解析访客对已配置用途的同意结果之前,分析和反馈脚本不会加载。
  • 如果访客先授予同意,之后又撤销同意,页面会重新加载,以便卸载已加载的分析脚本。
  • 如果 Transcend 加载失败,或访客始终未处理横幅,分析将保持关闭状态。
Was this page helpful?Suggest editsRaise issue