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

# Osano

> 将 Osano 集成到你的 Mintlify 文档站点，管理 Cookie 同意横幅、隐私偏好设置和监管合规要求。

通过在你的存储库中添加一个[自定义 JavaScript 文件](/zh/customize/custom-scripts#custom-javascript)，为文档添加 [Osano](https://www.osano.com/) Cookie 同意管理功能。

<div id="setup">
  ## 设置
</div>

在你的文档存储库中创建一个名为 `osano.js` 的文件，并填入以下内容：

<CodeGroup>
  ```js Format theme={null}
  var script = document.createElement("script");
  script.src = "OSANO_SCRIPT_URL";
  document.head.appendChild(script);
  ```

  ```js 示例 theme={null}
  var script = document.createElement("script");
  script.src = "https://cmp.osano.com/your-tenant-id/your-site-id/osano.js";
  document.head.appendChild(script);
  ```
</CodeGroup>

将 `OSANO_SCRIPT_URL` 替换为你的 Osano 脚本 URL。你的脚本 URL 是 Osano 生成的代码片段中 `src` 的值。你的脚本 URL 始终以 `https://cmp.osano.com/` 开头，并以 `/osano.js` 结尾。

<div id="troubleshooting">
  ## 故障排查
</div>

<Accordion title="在 Strict 合规模式下页面无法加载">
  如果在使用 Osano 的 **Strict** 合规模式时文档页面无法正常加载，你需要将 Mintlify 的 domain 加入允许列表，以允许图片和其他资源加载。

  <Steps>
    <Step title="前往 Managed Rules">
      在 Osano 控制台中，进入 **Scripts** → **Managed Rules**。
    </Step>

    <Step title="添加 Mintlify domain">
      将 `.mintlify.app/` 添加为一条 managed rule。

      <Frame>
        <img src="https://mintcdn.com/adminroletesting-mintlify-d7bc03a0/qMYrgud9F6Hb2kZo/images/integrations/osano-managed-rule.png?fit=max&auto=format&n=qMYrgud9F6Hb2kZo&q=85&s=1a83d4af8bcaca82161ff08b635ab370" alt="Osano managed rule" width="1980" height="738" data-path="images/integrations/osano-managed-rule.png" />
      </Frame>

      <Info>
        这可确保所有由 Mintlify 提供的资产 (包括图片、样式表和其他文档资源) 被视为必要内容，即使 Osano 阻止未分类的第三方内容时也会加载。
      </Info>
    </Step>
  </Steps>
</Accordion>